# evoLeadGate: requisitos e instalación

> Requisitos de evoLeadGate, cómo instalar el paquete en Joomla y qué revisar después: carpeta privada, tarea de retención, correo, proxy y servidor.

# 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](https://evoaddons.com/es/productos/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](https://evoaddons.com/es/documentacion/evoleadgate-configuracion).
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](https://evoaddons.com/es/documentacion/licencias-y-actualizaciones).

## Siguiente paso

Crea tu primer formulario en [Primeros pasos](https://evoaddons.com/es/documentacion/evoleadgate-primeros-pasos).

---

https://evoaddons.com/es/documentacion/evoleadgate-instalacion