evoLeadGate: referencia

Elemento «Lead magnet»

Las etiquetas del constructor están en castellano. Los valores por defecto son los del elemento recién añadido.

Pestaña Formulario

Pestaña Textos

Pestaña Entrega y avisos

Pestaña Consentimiento

El texto exacto de cada casilla se guarda con el lead en el momento del envío.

Pestaña Analítica

Pestaña Ajustes y Avanzado

Opciones habituales de YOOtheme: márgenes superior e inferior, ancho máximo, alineación del bloque y del texto, animación y visibilidad. Márgenes por defecto: «default» arriba y abajo. La pestaña Avanzado trae las opciones estándar del constructor.

Elemento hijo «Campo»

Validación en el servidor, siempre contra la definición firmada del formulario:

Modos de entrega

En los dos modos:

• el aviso va a los emails de aviso del formulario o, si no hay, al email por defecto de las opciones. Si no hay ningún destinatario, el estado del aviso queda como skipped;
• el email de entrega va a la dirección escrita en ese mismo formulario;
• un fallo de correo no impide guardar el lead; queda como failed en su estado;
• el enlace de descarga sirve las veces que haga falta hasta que caduca. Cada descarga se registra;
• el archivo se entrega por PHP como adjunto, sin exponer su ruta real. Un enlace caducado responde 410; un enlace desconocido o un archivo que ya no está responde 404.

Eventos de analítica

Tras un envío correcto, el script del formulario hace lo siguiente en el navegador:

event_id es el UUID del lead, así que coincide con el event_id que ves en el detalle del lead y sirve para deduplicar conversiones.

El script no consulta el estado del consentimiento. Detecta si gtag y fbq existen: los píxeles los carga tu sitio, por ejemplo desde el panel de scripts de YOOtheme en la categoría de marketing, y solo existen si el visitante los ha aceptado. El script no carga scripts de terceros; lo que hagan gtag y fbq depende de cómo los cargues tú.

Evento de Joomla para integraciones

Cada lead nuevo dispara un evento de Joomla después de guardarse y de enviar los emails:

El argumento incluye también la IP guardada, el agente de usuario, los consentimientos, los datos de atribución y el token de descarga. Trátalo como dato personal y como credencial. Si tu plugin lanza una excepción, se ignora: no impide guardar el lead.

Fragmento mínimo de un plugin suscrito:

public static function getSubscribedEvents(): array
{
    return ['onEvoleadgateLeadCreated' => 'onLead'];
}

public function onLead(\Joomla\Event\Event $event): void
{
    $lead = $event->getArgument('lead'); // ['id' => ..., 'email' => ..., 'form_id' => ..., ...]
}

API REST (solo lectura)

La proporciona el plugin de servicios web del paquete. Usa la cabecera X-Joomla-Token y requiere un usuario con el permiso core.manage sobre com_evoleadgate. Las respuestas no se cachean.

Ninguna de las dos incluye la IP ni el agente de usuario. No hay rutas de escritura. Con un usuario sin permiso responden 403.

Herramientas para evoMCP (opcional)

Si tienes evoMCP instalado, el plugin evomcp del paquete registra estas herramientas bajo el componente «evoLeadGate». Requieren core.manage sobre com_evoleadgate y los permisos de la conexión MCP.

Puntos de entrada del componente

Informativo: el script del formulario los usa, y no están pensados para llamarlos a mano.

La configuración del formulario viaja en un campo oculto firmado con HMAC-SHA256 con el secreto del sitio, sin caducidad. Cambiar el secreto de Joomla invalida los formularios que sigan en caché hasta que se vuelvan a generar.

Límites