Importar a demo do tema: por que falha e como resolver

A importação da demo é a operação mais pesada que um tema WordPress faz: ela cria dezenas de páginas, baixa centenas de imagens, grava menus, widgets e opções, tudo numa requisição só. Por isso ela é a primeira coisa a esbarrar no limite do servidor — e quando ela falha, o problema quase nunca é o tema.

O sinal é característico: a barra para em 30%, a tela volta em branco, aparece um erro 500, ou a importação «termina» mas o site fica sem imagens e sem menu.

Antes de mexer em qualquer coisa: confira os requisitos

Todo autor publica os requisitos mínimos do tema, na documentação ou no painel de opções dele. Compare com o que o seu servidor entrega hoje em Ferramentas > Saúde do site > Informações > Servidor.

Muitos temas trazem uma tela própria de checagem antes de importar, com itens em vermelho quando algo está abaixo do recomendado. Se ela existir, é a leitura mais rápida.

Os quatro números que resolvem a maioria

Não é preciso entender cada um; é preciso que eles não sejam pequenos demais:

• max_execution_time — quanto tempo o PHP pode levar antes de desistir. É o que causa a parada no meio. Suba para 300 ou mais.
• memory_limit — memória disponível. É o que causa a tela branca. Suba para 300M.
• max_input_vars — quantos campos o PHP aceita de uma vez. É o que faz a importação terminar incompleta, sem erro nenhum. Suba para 5000.
• upload_max_filesize e post_max_size — 100M nos dois.

Onde escrever isso depende da hospedagem, e o caminho é o mesmo do limite de upload: .user.ini na raiz do WordPress, .htaccess se o servidor for Apache, php.ini quando houver acesso, ou a tela de configuração de PHP do painel da hospedagem, que é o jeito mais curto quando existe.

Atenção a uma armadilha silenciosa: se o servidor for nginx, o .htaccess é ignorado por completo. Nenhum erro aparece — as linhas simplesmente não têm efeito.

Importe em site limpo

Demo foi feita para entrar em instalação nova. Importar por cima de um site com conteúdo mistura os dois e costuma dar mais trabalho desfazer do que refazer. Se o site já tem conteúdo que importa, teste antes num ambiente de teste.

Instale os plugins que a demo exige

Boa parte das demos depende de plugins do próprio autor ou de terceiros — slider, construtor, formulário. O tema costuma listar isso numa tela de «plugins recomendados» logo depois da ativação. Sem eles, a importação roda mas o resultado sai torto, com blocos vazios no lugar dos elementos.

Se falhou no meio

Não repita a importação por cima. Ela já criou parte do conteúdo, e uma segunda passada duplica tudo. Ajuste os limites primeiro, apague o que entrou pela metade — ou volte a instalação ao ponto anterior — e importe uma vez só.