Documentación del plugin Auto Newletter

No se encontraron coincidencias para tu búsqueda. Prueba con otros términos (por ejemplo: Brevo, programado, log o API).

1. Visión general y ficha técnica

PG Auto Newsletter (Content - Auto Newsletter Multi-plataforma) es un plugin de contenido nativo para Joomla que convierte cada artículo publicado en una campaña de newsletter segmentada por categoría, enviada directamente desde el propio editor de artículos mediante un simple interruptor Sí / No.

Tipo: Plugin (plg_content_autonewsletter) Autor: Paco Guio Joomla 4.x / 5.x / 6.x PHP 8.0+ (cURL activo) Licencia: GNU GPL v2+

Qué problema resuelve y ventajas principales

  • Conexión nativa con 5 plataformas líderes: Compatible de serie con Brevo (antes Sendinblue), MailerLite (API v2 / Nueva), Mailchimp, Acumbamail y Mailjet.
  • Sin intermediarios de pago ni riesgos RSS: Evita depender de conectores externos como Zapier o Make y elimina el peligro de enviar borradores sin terminar o artículos equivocados provocado por los sistemas automáticos basados en feeds RSS.
  • Envío inmediato o programado sin cronjobs: Permite lanzar la campaña en el acto al publicar o dejarla armada para artículos programados a fecha y hora futuras (Iniciar publicación) sin tener que configurar tareas cron en el servidor.
  • Segmentación automática por categorías: Vincula cada categoría de artículos de Joomla con una lista o grupo de suscriptores distinto en tu proveedor de email marketing.

Requisitos previos

  • Instalación operativa de Joomla 4.x, 5.x o 6.x ejecutándose bajo PHP 8.0 o superior con la extensión cURL habilitada.
  • Cuenta activa en una de las 5 plataformas soportadas: Brevo, MailerLite, Mailchimp, Acumbamail o Mailjet.
  • Dirección de correo electrónico remitente previamente verificada y aprobada dentro de la plataforma elegida.
  • Clave API de tu cuenta (en Mailjet necesitarás también la Secret Key; en Brevo la clave debe contar con permisos sobre Campaña de email) y el identificador numérico o alfanumérico (ID) de cada lista o grupo de suscriptores.

Licencia, exención de responsabilidad y descarga

Aviso legal y exención de responsabilidad (Licencia GNU GPL v2 o posterior) Este software se distribuye gratuitamente bajo licencia GNU GPL v2 o posterior (archivo LICENSE.txt incluido en el paquete) «tal cual», sin garantía explícita ni implícita de ningún tipo. La responsabilidad de instalar, configurar y utilizar esta extensión recae exclusivamente sobre la persona que la instala. Se recomienda encarecidamente realizar una copia de seguridad (backup) completa de los archivos y de la base de datos del sitio web antes de instalar esta o cualquier otra extensión.

2. Instalación y actualización

El paquete incorpora un instalador inteligente (script.php) que automatiza toda la preparación inicial en Joomla para que no tengas que crear campos personalizados a mano ni activar el plugin manualmente.

Pasos para una instalación limpia

  1. Descarga el archivo instalable .zip desde el botón superior.
  2. Accede al panel de administración de Joomla y entra en Sistema > Instalar > Extensiones.
  3. Sube el archivo .zip en la pestaña Subir archivo del paquete.
  4. En el mensaje de confirmación que aparece en pantalla, haz clic en el botón directo «Haz clic aquí para configurar tu API y categorías ahora» para ir sin rodeos a los ajustes del plugin.

¿Qué configura automáticamente el instalador?

  • Activación inmediata: Habilita automáticamente el plugin Content - Auto Newsletter en el gestor de plugins.
  • Grupo de campos propio: Crea el grupo de campos Auto Newsletter en com_content, que aparecerá como una pestaña independiente dentro del editor de artículos.
  • Campo interruptor invisible en el frontend: Crea el campo personalizado de tipo lista Enviar por Newsletter (alias: enviar-por-newsletter) con las opciones 0 (No, seleccionada por defecto) y 1 (Sí, enviar al guardar), fijando su visualización pública desactivada (display = 0) para evitar que aparezca ninguna etiqueta residual en la vista Blog ni en la vista de artículo completo.

3. Referencia de configuración del plugin

Puedes acceder en cualquier momento a la configuración desde Sistema > Gestionar > Plugins buscando Auto Newsletter. La pantalla de ajustes se organiza en dos pestañas principales:

Pestaña A: Conexión y Categorías

En la parte superior encontrarás un resumen del aviso legal GNU GPL v2+, una guía rápida en 3 pasos y un panel con enlaces directos al generador de API Keys de cada una de las 5 plataformas compatibles.

Parámetro Nombre técnico Valor por defecto Descripción y función
1. Elige tu servicio de Email Marketing platform brevo Selector desplegable para elegir entre Brevo, MailerLite, Mailchimp, Acumbamail o Mailjet.
2. Pega aquí tu Clave API api_key Vacío Clave de autenticación generada en tu proveedor. En Mailchimp debe incluir el sufijo de centro de datos al final (ejemplo: xxxxxxxxxxxxxxxx-us21).
Clave Secreta api_secret Vacío Campo condicional que solo se muestra cuando seleccionas Mailjet como plataforma. Introduce aquí tu Secret Key de Mailjet.
3. Correo electrónico remitente sender_email Vacío Dirección de correo desde la que se enviarán las campañas. Debe estar previamente verificada en tu cuenta del proveedor.
4. Nombre del remitente sender_name Vacío Nombre comercial o personal que verán tus suscriptores en su bandeja de entrada.
5. Conectar Categorías con Listas category_map Sin filas Subformulario repetible en tabla (pulsa el botón verde + para añadir filas):
• Columna izquierda (joomla_catid): Desplegable nativo con las categorías publicadas de artículos de Joomla.
• Columna derecha (platform_list_id): Campo de texto para escribir el ID numérico o alfanumérico de la lista o grupo de suscriptores correspondiente en tu plataforma.

Pestaña B: Diseño del Correo

Permite personalizar los textos, el color corporativo de la plantilla HTML responsive que recibirán tus suscriptores y el registro de diagnóstico técnico:

Parámetro Nombre técnico Valor por defecto Descripción y función
Texto introductorio email_intro Acabo de publicar un nuevo artículo dentro de los temas que elegiste seguir: Frase de encabezado que aparece en el cuerpo del boletín justo encima del título del artículo.
Texto del botón button_text Leer el artículo completo Texto visible dentro del botón principal de llamada a la acción (CTA) que enlaza con la URL absoluta del artículo.
Color del botón button_color #e65c2e Selector de color hexadecimal para adaptar el botón principal del correo a la identidad visual de tu web.
Longitud del extracto excerpt_length 260 Número de caracteres del resumen automático extraído de introtext o fulltext (limpio de etiquetas HTML). Admite valores entre 50 y 1000.
Incluir imagen destacada include_image 1 (Sí) Inserta automáticamente la imagen de introducción o artículo completo en la cabecera del boletín si el artículo dispone de ella.
Registro de diagnóstico (Log) enable_log 0 (No) Guarda un registro detallado de las peticiones y respuestas de la API en administrator/logs/plg_content_autonewsletter.php para depurar cualquier incidencia.

4. Manual de uso diario

Una vez configurado el plugin, el flujo editorial dentro de Contenido > Artículos es inmediato y a prueba de errores:

Indicador luminoso de estado

Dentro de cada artículo encontrarás la pestaña superior Auto Newsletter con un indicador visual en tiempo real:

  • Círculo rojo (No): Estado seguro por defecto. Puedes guardar borradores o editar artículos publicados tantas veces como quieras sin enviar ningún correo.
  • Círculo verde (Sí, enviar al guardar): Indica que la campaña está armada para enviarse en cuanto pulses Guardar o Guardar y cerrar.

Modo 1: Envío inmediato al publicar

  1. Redacta tu artículo, asígnale su Categoría y asegúrate de que su estado es Publicado.
  2. Abre la pestaña Auto Newsletter, cambia el selector a Sí, enviar al guardar (verás el punto en verde) y pulsa Guardar.
  3. El boletín se envía al instante a la lista asociada a esa categoría y el interruptor vuelve automáticamente a No (rojo) para evitar envíos duplicados en futuras ediciones.

Modo 2: Envío programado a fecha futura

  1. Configura la fecha y hora deseada en Publicación > Iniciar publicación y deja el artículo en estado Publicado.
  2. Activa Sí, enviar al guardar en la pestaña Auto Newsletter y guarda el artículo.
  3. El plugin deja la campaña programada en la cola de tu plataforma de email marketing para esa misma fecha y hora exacta, sin necesidad de cronjobs en tu servidor, y restablece el interruptor a No.

5. Solución de problemas (FAQ)

El boletín no se envía al guardar y aparece un aviso amarillo

El plugin bloquea el envío por seguridad si el artículo está en estado Despublicado / Borrador o si la categoría elegida aún no tiene ningún ID de lista asignado en la pestaña Conexión y Categorías.

¿Cómo compruebo si mi proveedor de correo rechazó la petición?

Activa la opción Registro de diagnóstico (Log) en la pestaña Diseño del Correo, repite el envío de prueba y revisa el archivo plg_content_autonewsletter.php dentro de la carpeta de logs de Joomla. Ahí verás el código HTTP exacto devuelto por la API (por ejemplo, remitente sin verificar o permisos insuficientes en la API Key).

¿Es necesario añadir manualmente el enlace para darse de baja en el correo?

No. El plugin inserta automáticamente al pie de la plantilla HTML la variable oficial de baja correspondiente a la plataforma seleccionada (Brevo, MailerLite, Mailchimp, Acumbamail o Mailjet) para cumplir con la normativa antispam y RGPD.

6. Historial de versiones

  • Versión 2.5.0: Soporte completo para Joomla 4, 5 y 6, envíos programados nativos sincronizados con «Iniciar publicación» y respaldo automático de configuración al actualizar.
Tags
logo paco guio