Manual de instalación · Módulo Convoca Publisher¶
Este manual es para la persona de la junta directiva que publica en las redes de la asociación desde la propia web. No hace falta saber programar.
1. Qué es¶
Convoca Publisher (nombre interno: convoca-publisher, versión 1.22.9) es el módulo que publica en las redes sociales de la asociación desde el escritorio de la web. Es decir: se escribe la publicación una vez y se manda a las redes que estén configuradas.
Las redes que contempla son ocho:
- Facebook (con Instagram)
- Google My Business
- Mastodon
- Telegram
- TikTok
- X
Cada red necesita su propia credencial (su «token»). Mientras una red no tenga credencial, no publica.
2. Qué necesitas antes de empezar¶
- Un usuario con permiso de administrador en el escritorio de WordPress.
- Ser administrador de las páginas de la asociación en cada red (por ejemplo, de la página de Facebook).
- El fichero
.zipdel módulo, o el buscador de plugins si el sitio ya está conectado. - Paciencia con las redes: cada una da su credencial por un sitio distinto. En la demo, a propósito, no hay ninguna credencial puesta.
3. Pasos de instalación¶
- Entra en el escritorio de WordPress (
/wp-admin). - En el menú lateral, pulsa Plugins.
- Pulsa Añadir nuevo plugin → Subir plugin → Elegir archivo.
- Selecciona el
.zipde Convoca Publisher → Instalar ahora. - Pulsa Activar plugin.
- Comprueba que el menú lateral muestra Convoca Publisher con sus tres apartados: Convoca Publisher, Historial y Acerca de.
- Entra en Convoca Publisher. Verás las pestañas Canales, Cola, Configuración, Plantillas, Probar, Moderación y Guía.

- La instalación está hecha. Ahora faltan las credenciales, que se explican en el manual de configuración.
4. Comprobación¶
- El menú lateral muestra Convoca Publisher y sus tres apartados.
- La pantalla Convoca Publisher abre en la pestaña Canales y enseña una tarjeta por cada red.
- Cada tarjeta muestra su estado a la derecha:
- ✅ Configurado
- ❌ Falta token
- ⚠️ Error al verificar
- 🔑 Necesita reconexión
- En la demo, todas las tarjetas están en Falta token. Es lo normal si aún no se ha conectado ninguna red.
Cada tarjeta dice, cuando no hay nada puesto:
Esta red no publica todavía: no tiene ninguna cuenta configurada.
Y debajo indica dónde se consigue la credencial (por ejemplo, «El token se genera en Meta for Developers») con su enlace y un botón Añadir cuenta.
5. Errores típicos y qué hacer¶
- No veo el menú «Convoca Publisher». El módulo no está activo, o tu usuario no es administrador.
- Todas las redes están en «Falta token». No es un error de instalación: falta conectar las cuentas. Ver el manual de configuración.
- Una red pasa a «Error al verificar». La credencial está puesta pero la red no la acepta. Suele ser que ha caducado o que se copió mal.
- Una red pasa a «Necesita reconexión». Esa red ha dejado de aceptar la credencial: hay que volver a conectarla.
- Se publica dos veces. Mira si hay dos cuentas de la misma red dadas de alta. En la pantalla se avisa de que puedes tener varias cuentas de la misma red (por ejemplo, la página y el grupo de Facebook), cada una con su credencial y su plantilla.
6. Problemas conocidos¶
- publisher#8 — En la demo no hay credenciales y el aviso «Falta token» debería enlazar con las instrucciones de cómo conseguir la credencial. https://github.com/josecarlosnieto91/convoca-publisher/issues/8
Preguntas frecuentes¶
¿Se publica solo o hay que darle a un botón? No se publica nada hasta que tú escribas y mandes la publicación. El módulo no inventa contenido.
¿Puedo conectar solo una red? Sí. Empieza por la que uses más. Las demás pueden quedarse en Falta token sin romper nada.
¿Las credenciales caducan? Sí, algunas redes dan credenciales con fecha de caducidad. La tarjeta de cada red muestra la salud y la caducidad de su credencial.
¿Esto sustituye a entrar en Facebook o Instagram a mano? Lo complementa: te evita entrar en cada red por separado cuando quieres publicar lo mismo en varias.
Por confirmar: si el módulo permite programar publicaciones para más adelante desde la pestaña Cola, y cómo funciona el flujo exacto de publicación (no hay captura de ese flujo).
¿Administras el sistema y buscas los detalles técnicos (ganchos, capacidades, API)? Están en la referencia técnica: docs/plugins/convoca-publisher.md.