Problemas de instalación o activación

4 min read

Intentaste instalar o activar TTSWP y algo salió mal. La instalación falló, el plugin muestra un error fatal, o el menú no aparece tras la activación. Esta página cubre las causas más comunes, ordenadas de mayor a menor probabilidad.

Causa 1: Versión de PHP demasiado antigua

Síntoma: WordPress se niega a activar el plugin con un error como "El plugin requiere PHP 7.2 o superior" o muestra una pantalla en blanco justo después de la activación.

Por qué: TTSWP requiere PHP 7.2 o más reciente. Muchos hosts todavía ejecutan PHP 7.0 o 7.1 por defecto en cuentas antiguas.

Solución:

  1. Abre el panel de control de tu hosting (cPanel, Plesk, SiteGround, Kinsta, WP Engine, etc.).
  2. Busca el selector de versión de PHP (normalmente en "PHP Selector" o "Site Tools - PHP Manager").
  3. Cambia a PHP 8.0 o superior. PHP 8.2 es la versión recomendada actualmente.
  4. Intenta activar el plugin de nuevo.

Si no puedes cambiar PHP desde el panel de control, contacta a tu host. Casi todos los hosts admiten PHP 8.x en 2026.

Causa 2: Los permisos de archivos bloquean la subida

Síntoma: "La instalación del plugin falló" o "No se pudo crear el directorio" al subir el zip o instalar desde el directorio.

Por qué: Tu directorio wp-content/plugins/ no tiene permisos de escritura para el servidor web.

Solución:

  1. Conéctate a tu sitio por SFTP o el administrador de archivos de tu host.
  2. Establece los permisos de wp-content/plugins/ en 755 (o 775 en algunos hosts).
  3. Establece los archivos internos en 644.
  4. Vuelve a intentar la instalación.

En muchos hosts gestionados (Kinsta, WP Engine, Pressable) el administrador de archivos lo gestiona automáticamente. Si sigues con problemas, pide a tu host que corrija los permisos del directorio de plugins.

Causa 3: Conflicto de plugins durante la activación

Síntoma: La activación lanza un error fatal que menciona un nombre de función, un nombre de clase o "Cannot redeclare". El sitio puede caer hasta que el plugin se desactive.

Por qué: Otro plugin activo define una función o clase con el mismo nombre (poco frecuente pero posible), o un plugin de seguridad está bloqueando la activación.

Solución:

  1. Renombra wp-content/plugins/text-to-speech-tts/ a text-to-speech-tts.off por SFTP. El sitio vuelve a funcionar.
  2. Desactiva todos los demás plugins desde Plugins - Plugins instalados.
  3. Renombra la carpeta de TTSWP a su nombre original.
  4. Activa TTSWP primero, luego reactiva tus otros plugins uno a uno. El plugin que falla cuando TTSWP está activo es el conflicto.
  5. Contacta con soporte con el nombre del plugin en conflicto. Te ayudaremos a encontrar una solución.

Causa 4: El menú de Texto a Voz no aparece tras la activación

Síntoma: El plugin aparece como Activo en Plugins - Plugins instalados, pero no hay ninguna entrada de Texto a Voz en la barra lateral de administración.

Por qué: Tu rol de usuario no tiene la capacidad manage_options, o un plugin de seguridad eliminó el menú.

Solución:

  • Inicia sesión como Administrador. Los roles de Editor e inferiores no ven el menú de TTSWP por defecto.
  • Si ya eres Administrador, ve a Usuarios - Perfil y confirma que tu rol es Administrador.
  • Desactiva plugins de seguridad como iThemes Security, Wordfence Admin menu hiding o Hide My WP uno a la vez y recarga el administrador. Si el menú reaparece, configura ese plugin para permitir text-to-speech-tts-settings.

Causa 5: La columna TTS no aparece en la lista de entradas

Síntoma: El plugin funciona, pero la columna TTS no aparece en Entradas - Todas las entradas.

Solución:

  1. Abre Entradas - Todas las entradas.
  2. Haz clic en Opciones de pantalla en la parte superior derecha de la pantalla.
  3. Marca la casilla TTS.
  4. La columna aparece.

Si la casilla no aparece, tu tema u otro plugin la está filtrando. Cambia a un tema predeterminado (Twenty Twenty-Five) para confirmarlo.

Causa 6: Versión de WordPress demasiado antigua

Síntoma: La instalación del plugin falla con "Tu sitio no cumple los requisitos mínimos".

Por qué: TTSWP requiere WordPress 6.0 o más reciente.

Solución: Actualiza WordPress desde Escritorio - Actualizaciones. Si no puedes actualizar, es posible que tu host te esté manteniendo en una versión antigua; pídele que actualice.

Causa 7: HTTPS saliente bloqueado

Síntoma: El plugin se instala y activa correctamente, pero la página de Resumen muestra "No se pudo conectar con los servidores de TTSWP" o el botón Conectar no hace nada.

Por qué: Tu host bloquea las solicitudes HTTPS salientes desde PHP hacia dominios externos. Esto es poco frecuente en hosts reales, pero común en entornos de desarrollo local.

Solución:

  • En localhost, revisa tu cortafuegos o VPN.
  • En un host real, añade app.ttswp.com y *.ttswp.com a la lista de permisos para HTTPS saliente.
  • Consulta Solución de problemas de conexión para comprobaciones de red más detalladas.

¿Sigues sin resolverlo?

Si ninguna de estas soluciones funciona, reúne esta información y contacta con soporte:

  • Versión de WordPress (desde Escritorio - Un vistazo)
  • Versión de PHP (desde Herramientas - Estado del sitio - Información - Servidor)
  • Nombre y versión del tema activo
  • Lista de otros plugins activos
  • El mensaje de error exacto que ves, con captura de pantalla si es posible

Páginas relacionadas