aGo Contact, documentación

Versión del plugin: 1.0.2 · Documentación actualizada: 2026-06-28

aGo Contact agrega a tu sitio WordPress un formulario de contacto liviano con protección anti spam, notificaciones por correo y una bandeja de mensajes en el administrador. Pones el formulario en cualquier página o entrada con un shortcode o un bloque de Gutenberg, eliges qué campos pedir y recibes cada mensaje en tu correo, además de quedar guardado en el sitio.

1. Instalación y activación

1. Sube el archivo ago-contact.zip desde Plugins → Añadir nuevo plugin → Subir plugin y actívalo. También puedes copiar la carpeta ago-contact a /wp-content/plugins/.
2. Al activar, el plugin crea la tabla donde se guardan los mensajes recibidos.
3. Ve a aGo Tools → Contact para configurar el formulario.

Requisitos: WordPress 6.0 o superior y PHP 8.1 o superior.

2. Configuración

Toda la configuración vive en aGo Tools → Contact. Estas son las secciones, en el orden en que aparecen:

• Campos del formulario (Form Fields). Una tabla con los campos disponibles: nombre, correo, teléfono, asunto, empresa, departamento, mensaje y consentimiento. Para cada campo decides si está activo, si es obligatorio y qué etiqueta muestra. Por defecto vienen activos nombre, correo, asunto y mensaje; nombre, correo y mensaje son obligatorios.
• Opciones de departamento (Department Options). Una opción por línea. Solo se usan cuando activas el campo Departamento, que se muestra como lista desplegable. Por defecto trae General, Sales y Support.
• Apariencia (Appearance). Tres temas visuales para el formulario: Modern, Classic y Minimal. Si prefieres, puedes darle estilo desde el CSS de tu tema.
• Notificaciones por correo (Email Notifications). Define el correo que recibe cada mensaje (por defecto el del administrador del sitio). Puedes activar una respuesta automática al visitante, con asunto y cuerpo propios.
• Protección anti spam (Spam Protection). Ver la sección 5.
• Mensajes (Messages). El texto de éxito que ve el visitante al enviar y el texto del consentimiento de privacidad.
• Uso (Usage). Recordatorio del shortcode y el bloque para insertar el formulario.

Recuerda pulsar Guardar ajustes (Save Settings) al terminar.

3. Insertar el formulario

Hay dos formas de mostrar el formulario, equivalentes entre sí:

El formulario refleja los campos, las etiquetas, las obligatoriedades y el tema visual que definiste en los ajustes. Las hojas de estilo y el script del formulario solo se cargan en las páginas donde realmente está el formulario, para no recargar el resto del sitio.

4. Qué pasa al enviar un mensaje

Cuando un visitante envía el formulario:

1. El plugin valida los campos obligatorios y, si está activo, el consentimiento de privacidad.
2. Comprueba la protección anti spam (ver la sección 5).
3. Guarda el mensaje en la base de datos del sitio, con la fecha, la dirección IP y el navegador del visitante para diagnóstico de spam.
4. Envía la notificación al correo configurado. El correo lleva un encabezado Reply-To con el nombre y el correo del visitante, para que puedas responderle directamente.
5. Si activaste la respuesta automática, le envía al visitante el acuse de recibo.
6. Muestra al visitante el mensaje de éxito.

5. Protección anti spam

El plugin combina varias capas:

• Honeypot. Siempre activo. Es un campo oculto que las personas no ven y los bots tienden a rellenar; si llega con contenido, el envío se descarta en silencio.
• Límite de envíos por IP (Rate Limit). Defines cuántos envíos por hora admite cada dirección IP. Por defecto, 5.
• Verificación adicional, a elegir una:
  • Ninguna (None): solo el honeypot.
  • Captcha matemático (Math): una pregunta simple de suma o resta (por ejemplo, “¿Cuánto es 4 + 7?”). No requiere ningún servicio externo ni claves.
  • Cloudflare Turnstile: un widget de Cloudflare contra bots. Requiere una clave de sitio y una clave secreta que obtienes en tu panel de Cloudflare. El widget de Turnstile carga desde los servidores de Cloudflare y la respuesta se valida en el servidor al enviar el formulario. Esta es la única conexión externa del plugin y está desactivada por defecto.

6. Bandeja de mensajes

Cada envío queda guardado en el sitio. Encuentras la bandeja en el menú lateral Submissions (junto al ícono de correo). El menú muestra una insignia con la cantidad de mensajes nuevos sin leer.

En la bandeja puedes:

• Filtrar por estado: todos, nuevos, leídos, respondidos o spam.
• Abrir un mensaje para ver su detalle. Al abrirlo, un mensaje nuevo pasa automáticamente a leído.
• Marcar como respondido o marcar como spam.
• Eliminar un mensaje.
• Exportar a CSV todos los mensajes con un clic, para abrirlos en una planilla. La exportación neutraliza los valores frente a inyección de fórmulas, de modo que abrir el archivo en una hoja de cálculo sea seguro.

Los mensajes se muestran paginados, con nombre, correo, asunto, estado y fecha.

7. Privacidad y datos

• Los mensajes se guardan localmente en la base de datos del sitio. No se envían a ningún tercero.
• La dirección IP y el navegador del visitante se guardan junto al mensaje para diagnóstico de spam.
• Puedes activar el campo de consentimiento de privacidad, con un texto que defines tú, para que el visitante deba aceptar antes de enviar.
• Cuando usas Cloudflare Turnstile, la interacción del visitante con el widget la procesa Cloudflare para detectar bots.

Este plugin te ayuda a recoger consentimiento, pero la responsabilidad sobre tu política de privacidad y el tratamiento de los datos recibidos corresponde a ti como titular del sitio.

8. Soporte

aGo Contact es un plugin gratuito de código abierto bajo licencia GPL-2.0+.

Cuando publiquemos este plugin en WordPress.org, las dudas y reportes de bugs se atenderán en su foro oficial (https://wordpress.org/support/plugin/ago-contact/). El plugin es de código abierto bajo licencia GPL-2.0+ y se atiende según disponibilidad.

No damos soporte por correo electrónico para la versión gratuita. Para uso comercial con soporte directo y SLA, próximamente lanzaremos planes de suscripción anual y lifetime.