Skip to main content

evoLeadGate: requisitos e instalación

Requisitos

  • Joomla 5 o 6. [PENDIENTE: versión mínima exacta de Joomla; el manifiesto no declara ninguna]. El entorno de pruebas del desarrollo usa Joomla 6.
  • YOOtheme Pro 5. El elemento se ha verificado con YOOtheme Pro 5.0.50. [PENDIENTE: comprobar y confirmar la versión mínima de YOOtheme Pro; falta probar con 5.0.31].
  • PHP 8.1 o superior. El instalador se detiene si la versión es menor.
  • Base de datos MySQL o MariaDB. Las tablas se crean con juego de caracteres utf8mb4.
  • Envío de correo configurado en Joomla (Sistema → Configuración global → Servidor). Sin correo, los leads se guardan igualmente, pero el visitante no recibe el enlace y tú no recibes el aviso.
  • Servidor web que aplique el .htaccess de la carpeta privada (Apache o compatible). Con Nginx hace falta una regla propia; más abajo.

La licencia es opcional para que la extensión funcione. Sin Download ID no recibes actualizaciones, pero el formulario sigue operando.

Qué instala el paquete

pkg_evoleadgate instala seis extensiones:

Extensión Para qué sirve
com_evoleadgate Componente: recibe los envíos, entrega las descargas y contiene el panel de leads y las opciones.
Plugin de sistema evoleadgate Registra el elemento «Lead magnet» en el constructor de YOOtheme y carga su script y sus estilos.
Plugin de tareas evoleadgate Tarea programada de retención de datos.
Plugin de privacidad evoleadgate Exportación y borrado de los datos de una persona desde la herramienta de privacidad de Joomla.
Plugin de servicios web evoleadgate Rutas de lectura de la API REST de Joomla.
Plugin evomcp evoleadgate Herramientas opcionales para evoMCP. No hace nada si evoMCP no está instalado.

En la primera instalación, el paquete habilita los cinco plugins. En las actualizaciones no cambia su estado.

Instalar el paquete

  1. Descarga pkg_evoleadgate-<versión>.zip. [PENDIENTE: dónde se descarga el ZIP en la web de venta y el nombre exacto del fichero].
  2. En Joomla, abre Sistema → Instalar → Extensiones y sube el ZIP.
  3. Borra el fichero administrator/cache/autoload_psr4.php del sitio. Joomla lo regenera solo en la siguiente petición; si no lo borras, puede no encontrar las clases de los plugins nuevos.
  4. Comprueba que existe la carpeta images/evoleadgate-privado/. El instalador la crea con tres ficheros: .htaccess (deniega todo el acceso directo), index.html y evoleadgate-probe.txt, un archivo de prueba que usa la comprobación de protección.

[PENDIENTE: captura de la pantalla de instalación con el paquete subido]

Configurar el sitio tras la instalación

Haz estos pasos en orden. Los tres primeros son los que más se olvidan.

  1. Opciones del componente. Abre Componentes → evoLeadGate → Opciones. Indica el email de aviso por defecto y revisa los plazos de retención. Cada ajuste está en Configuración.
  2. Comprobar protección. En la pestaña Privacidad, pulsa Comprobar protección. La comprobación pide por HTTP el archivo de prueba de la carpeta privada. Un resultado 403 (o 401 o 404) significa que el servidor bloquea el acceso directo. Cualquier otro código se muestra como «NO protegida».
  3. Crear la tarea de retención. Ve a Sistema → Tareas programadas → Nuevo y elige «evoLeadGate: retención de datos». Prográmala a diario. El paquete no la crea. Sin esta tarea no se vacía la IP por plazo y no se borran los leads vencidos.
  4. Correo saliente. Configura SMTP en Sistema → Configuración global → Servidor. Con el puerto 587 usa seguridad STARTTLS; con el 465, SSL/TLS. Una combinación equivocada hace que el envío falle y el estado del email del lead quede como failed.
  5. Proxy inverso o balanceador. Si el sitio está detrás de uno, activa Configuración global → Servidor → Detrás de un balanceador de carga. Si no, el límite del antispam y la IP guardada serán la del proxy, no la del visitante. Lo mismo ocurre con un Nginx delante de Apache sin mod_remoteip.
  6. $live_site en producción. Define $live_site en configuration.php. Los enlaces de los emails se construyen con el dominio de la petición, y con $live_site evitas que apunten a un dominio equivocado.
  7. Nginx o Plesk. Si el servidor sirve los archivos estáticos directamente (en Plesk, la opción «Servir archivos estáticos directamente por nginx»), el .htaccess no se aplica a pdf, txt, zip y similares. Añade una regla que niegue el acceso a /images/evoleadgate-privado/, o desactiva esa opción para el sitio, y vuelve a pulsar Comprobar protección. [PENDIENTE: regla de Nginx verificada para publicar].

Download ID y actualizaciones

El paquete trae su sitio de actualización de Joomla, llamado «evoLeadGate». Para recibir actualizaciones:

  1. Copia el Download ID de tu área de cliente (formato EVO-XXXX-XXXX-XXXX-XXXX).
  2. Abre Sistema → Sitios de actualización, busca la fila de evoLeadGate y pega el Download ID en el campo «Clave de descarga».
  3. La extensión valida la clave y activa el dominio. El estado se ve en la pestaña Licencia de las opciones.

Más detalle en Licencias y actualizaciones.

Siguiente paso

Crea tu primer formulario en Primeros pasos.