# evoLeadGate: primeros pasos

> Crea tu primer lead magnet con evoLeadGate: sube el archivo a la carpeta privada, añade el elemento en el constructor y comprueba el primer lead.

# evoLeadGate: primeros pasos

Esta guía lleva un formulario de cero a funcionando. Necesitas la extensión instalada y revisada según [Requisitos e instalación](https://evoaddons.com/es/documentacion/evoleadgate-instalacion).

## 1. Sube el archivo a la carpeta privada

El archivo que quieras entregar debe estar en `images/evoleadgate-privado/`. Si lo dejas en otra carpeta, cualquiera podría descargarlo sin pasar por el formulario, y el formulario no funcionará (ver más abajo).

1. Abre *Contenido → Medios* en Joomla.
2. Entra en la carpeta `evoleadgate-privado` y sube el archivo.

Desde el selector del propio elemento también puedes subirlo. La carpeta aparece en el selector con sus archivos; el `.htaccess` no se muestra.

## 2. Añade el elemento «Lead magnet»

1. Abre la página en el constructor de YOOtheme Pro y añade un elemento nuevo en una columna.
2. Busca **Lead magnet**.
3. Verás una nota que dice que la vista previa no envía datos desde el editor. Es normal: el formulario solo envía datos en la web publicada.

Las etiquetas del elemento están en castellano, aunque tu sitio esté en otro idioma. YOOtheme no usa los ficheros de idioma de Joomla para ellas.

## 3. Configura el formulario

El elemento se organiza en pestañas. Lo mínimo está en las dos primeras.

1. **Formulario** - *ID del formulario*: un identificador único y sin espacios, por ejemplo `guia-seo-2026`. Se usa en el panel de leads y en los eventos de analítica. Sin él, el formulario no funciona. - *Campos adicionales*: el email siempre se pide. Añade aquí lo demás con **Añadir elemento**; cada campo tiene etiqueta, tipo (texto, teléfono, desplegable o casilla), si es obligatorio y, según el tipo, texto de ayuda u opciones. - *Archivo de descarga*: elige el archivo de la carpeta privada.
2. **Textos**: título, descripción, texto del botón y mensaje de éxito. Si dejas vacíos el botón o el mensaje, se usan los textos por defecto del idioma del sitio.
3. **Entrega y avisos**: elige entre descarga inmediata con email o solo por email (doble opt-in), y escribe los emails de aviso.
4. **Consentimiento**: texto de privacidad, enlace a tu política y, si quieres, el texto de comunicaciones comerciales. Si dejas vacío el texto de comunicaciones, la casilla no se muestra.
5. **Analítica**: nombres de los eventos. Los valores por defecto son `generate_lead` y `Lead`.

Cada opción está descrita en la [Referencia](https://evoaddons.com/es/documentacion/evoleadgate-referencia).

### Qué te avisa el editor

En la vista previa, el elemento muestra avisos cuando algo no está bien:

- falta el ID del formulario;
- no has elegido archivo;
- el archivo no está en `images/evoleadgate-privado/`;
- hay más de 20 campos (se ignoran los sobrantes);
- un desplegable no tiene opciones;
- no hay campos adicionales (solo se pedirá el email).

Si el archivo falta o no está en la carpeta privada, el formulario no se muestra en la web publicada.

## 4. Elige cómo se entrega

| Modo | Qué ve el visitante | Qué recibe por email |
| --- | --- | --- |
| Descarga inmediata y email | Un botón de descarga al enviar el formulario. | Un email con el enlace de descarga. |
| Solo por email (doble opt-in) | Un mensaje que dice que le has enviado el enlace. | El enlace de descarga. El email del lead queda como verificado cuando abre el enlace por primera vez. |

En los dos modos el enlace caduca (7 días por defecto, ajustable en las opciones).

## 5. Publica y prueba

1. Guarda y publica la página.
2. Abre la página publicada, rellena el formulario con un email tuyo y acepta la casilla de privacidad.
3. Entra en *Componentes → evoLeadGate*. El lead aparece en la lista; ábrelo para ver sus campos, los consentimientos, la atribución y, tras descargar, el historial de descargas.
4. Mira la columna de estado de los emails. Si pone `failed`, revisa la configuración de correo de Joomla.

Si abres la página con parámetros UTM (por ejemplo `?utm_source=boletin`), el lead guarda el origen.

\[PENDIENTE: captura del elemento «Lead magnet» en el constructor y del panel de leads\]

## Siguientes pasos

- Ajusta el antispam, la retención y los emails en [Configuración](https://evoaddons.com/es/documentacion/evoleadgate-configuracion).
- Si algo no funciona, mira [Preguntas frecuentes y problemas](https://evoaddons.com/es/documentacion/evoleadgate-faq).

---

https://evoaddons.com/es/documentacion/evoleadgate-primeros-pasos
