Recursos Casos de Uso Planos
Blog Documentação Registro de alterações
Entrar
Começar

Problemas de instalação ou ativação

4 min read

Você tentou instalar ou ativar o TTSWP e algo deu errado. A instalação falhou, o plugin exibe um erro fatal ou o menu não aparece após a ativação. Esta página cobre as causas mais comuns, da mais para a menos provável.

Causa 1: Versão do PHP desatualizada

Sintoma: O WordPress se recusa a ativar o plugin com um erro como "O plugin requer PHP 7.2 ou superior" ou exibe uma tela branca logo após a ativação.

Por que acontece: O TTSWP requer PHP 7.2 ou mais recente. Muitos hosts ainda executam PHP 7.0 ou 7.1 por padrão em contas mais antigas.

Solução:

  1. Abra o painel de controle da sua hospedagem (cPanel, Plesk, SiteGround, Kinsta, WP Engine, etc.).
  2. Localize o seletor de versão do PHP (geralmente em "PHP Selector" ou "Site Tools → PHP Manager").
  3. Mude para PHP 8.0 ou superior. O PHP 8.2 é a versão recomendada atualmente.
  4. Tente ativar o plugin novamente.

Se não for possível alterar o PHP pelo painel de controle, entre em contato com seu host. Praticamente todos os hosts oferecem suporte ao PHP 8.x em 2026.

Causa 2: Permissões de arquivo bloqueando o upload

Sintoma: "Falha na instalação do plugin" ou "Não foi possível criar o diretório" ao fazer upload do arquivo zip ou instalar pelo diretório.

Por que acontece: O diretório wp-content/plugins/ não tem permissão de escrita para o servidor web.

Solução:

  1. Conecte-se ao seu site via SFTP ou pelo gerenciador de arquivos do host.
  2. Defina as permissões de wp-content/plugins/ como 755 (ou 775 em alguns hosts).
  3. Defina os arquivos internos como 644.
  4. Tente instalar novamente.

Em muitos hosts gerenciados (Kinsta, WP Engine, Pressable), o gerenciador de arquivos cuida disso automaticamente. Se continuar com problemas, peça ao seu host para corrigir as permissões do diretório de plugins.

Causa 3: Conflito de plugin na ativação

Sintoma: A ativação gera um erro fatal mencionando o nome de uma função, o nome de uma classe ou "Cannot redeclare". O site pode ficar fora do ar até que o plugin seja desativado.

Por que acontece: Outro plugin ativo define uma função ou classe com o mesmo nome (raro, mas possível), ou um plugin de segurança está bloqueando a ativação.

Solução:

  1. Renomeie wp-content/plugins/text-to-speech-tts/ para text-to-speech-tts.off via SFTP. O site voltará ao normal.
  2. Desative todos os outros plugins em Plugins → Plugins instalados.
  3. Renomeie a pasta do TTSWP de volta ao nome original.
  4. Ative o TTSWP primeiro e depois reative os outros plugins um por um. O plugin que falhar com o TTSWP ativo é o que está causando o conflito.
  5. Entre em contato com o suporte informando o nome do plugin conflitante. Vamos ajudar a encontrar uma solução.

Causa 4: O menu Texto para Voz está ausente após a ativação

Sintoma: O plugin aparece como Ativo em Plugins → Plugins instalados, mas não há entrada de Texto para Voz na barra lateral do admin.

Por que acontece: Seu perfil de usuário não tem a capacidade manage_options, ou um plugin de segurança removeu o menu.

Solução:

  • Acesse como Administrador. Perfis de Editor e inferiores não visualizam o menu do TTSWP por padrão.
  • Se você já é Administrador, verifique em Usuários → Perfil e confirme que sua função é Administrador.
  • Desative plugins de segurança como iThemes Security, ocultação de menu do Wordfence ou Hide My WP, um de cada vez, e recarregue o admin. Se o menu reaparecer, configure esse plugin para permitir text-to-speech-tts-settings.

Causa 5: A coluna TTS está ausente na lista de posts

Sintoma: O plugin funciona, mas a coluna TTS não aparece em Posts → Todos os posts.

Solução:

  1. Abra Posts → Todos os posts.
  2. Clique em Opções de tela no canto superior direito.
  3. Marque a caixa de seleção TTS.
  4. A coluna será exibida.

Se a caixa de seleção não aparecer, seu tema ou outro plugin está filtrando a coluna. Mude para um tema padrão (Twenty Twenty-Five) para confirmar.

Causa 6: Versão do WordPress desatualizada

Sintoma: A instalação do plugin falha com "Seu site não atende aos requisitos mínimos".

Por que acontece: O TTSWP requer WordPress 6.0 ou mais recente.

Solução: Atualize o WordPress em Painel → Atualizações. Se não for possível atualizar, seu host pode estar mantendo você em uma versão antiga - peça a ele que atualize.

Causa 7: HTTPS de saída bloqueado

Sintoma: O plugin instala e ativa normalmente, mas a página de visão geral exibe "Não foi possível alcançar os servidores do TTSWP" ou o botão Conectar não faz nada.

Por que acontece: Seu host bloqueia requisições HTTPS de saída do PHP para domínios externos. Isso é raro em hosts reais, mas comum em ambientes de desenvolvimento local.

Solução:

  • No localhost, verifique seu firewall ou VPN.
  • Em um host real, adicione app.ttswp.com e *.ttswp.com à lista de permissões para HTTPS de saída.
  • Consulte Solução de problemas de conexão para verificações de rede mais detalhadas.

Ainda com problemas?

Se nenhuma dessas soluções funcionar, reúna as informações abaixo e entre em contato com o suporte:

  • Versão do WordPress (em Painel → Em um relance)
  • Versão do PHP (em Ferramentas → Saúde do site → Informações → Servidor)
  • Nome e versão do tema ativo
  • Lista dos outros plugins ativos
  • A mensagem de erro exata que você vê, com uma captura de tela se possível

Páginas relacionadas