Resolver los problemas habituales de POM Forms

Usa esta página cuando el síntoma ya se conozca. Ante un fallo sin explicación, empieza por la secuencia de diagnóstico de fuera hacia dentro. Prueba con la sesión cerrada en una ventana privada del navegador, porque el estado de administrador y el autocompletado pueden ocultar la experiencia del visitante.

Falta el menú Forms

Un administrador debe habilitar Settings → POM Theme → Forms → General → Enable forms system. Confirma también que tu rol de WordPress tenga acceso a POM Forms.

Falta un formulario activo en el maquetador de páginas

1. Abre Forms → All Forms.
2. Confirma que el formulario correcto esté Active.
3. Vuelve a guardarlo si su estado cambió hace poco.
4. Recarga el editor de páginas.
5. Abre POM Form y busca de nuevo.

Asegúrate de que estás editando el mismo sitio en una red multisitio.

El formulario se muestra pero no se envía

Comprueba:

• los campos obligatorios y los mensajes de validación;
• los campos ocultos con reglas de obligatoriedad activas;
• las ramas condicionales;
• las restricciones de tamaño y tipo de archivo;
• la configuración antispam o de reCAPTCHA;
• los errores del navegador provocados por scripts personalizados;
• si la página está sirviendo un formulario antiguo almacenado en caché.

Prueba temporalmente una copia sin CSS personalizado ni automatización externa para aislar la presentación del comportamiento de envío.

El visitante ve un error genérico

Un mensaje genérico puede proteger los detalles técnicos o sensibles. Reproduce el problema con el envío válido más sencillo e identifica en qué etapa falla:

1. validación de los campos;
2. subida de archivos;
3. procesamiento del formulario;
4. entrega de la notificación;
5. almacenamiento;
6. creación del webhook o de la entrada;
7. redirección de éxito.

No pegues credenciales, envíos personales, tokens de acceso ni datos completos de la solicitud en un mensaje de soporte.

No llega el correo del administrador

1. Verifica que la ruta de notificación prevista coincidiera con los valores enviados.
2. Comprueba sus ajustes de destinatario, From y Reply-To.
3. Envía con un valor normal de un campo público de correo electrónico.
4. Comprueba el spam y la cuarentena del correo.
5. Verifica el servicio de correo saliente del sitio con otro correo de WordPress.
6. Revisa el registro de entrega del proveedor de correo cuando esté disponible.

Si otros correos de WordPress también fallan, corrige la entrega de correo del sitio antes de cambiar el formulario.

Las etiquetas de combinación aparecen sin cambios

Usa el selector de etiquetas de combinación del formulario y confirma que el nombre del campo referenciado siga existiendo. La sintaxis de un campo llamado email es:

{{field:email}}

Si se cambió el nombre de un campo, actualiza los asuntos, mensajes, rutas, webhooks, valores por defecto y asignaciones de entrada que lo utilicen.

Un campo oculto bloquea el envío

Abre los ajustes de obligatoriedad y condicionales del campo. Prueba la rama que lo oculta después de activarlo primero. No se debe pedir a un visitante que corrija un control que no es visible.

Fallan las subidas

Para las subidas locales, revisa:

• el límite del campo del formulario;
• el máximo global del sitio en Settings → POM Theme → Forms → General;
• los tipos MIME permitidos;
• el número de archivos seleccionados;
• el límite de subida de WordPress/servidor.

Para los campos de Google Drive, ejecuta la prueba de conexión y usa las subidas de Google Drive.

Un formulario de varios pasos pierde el progreso

Comprueba que JavaScript personalizado no esté reemplazando el formulario ni forzando una navegación de página. Prueba Back y Continue sin autocompletado del navegador y confirma que todos los campos permanezcan dentro del paso, la fila y la columna previstos.

No funciona la redirección de éxito

Usa una URL completa de confianza, guarda el formulario, limpia la caché de la página y prueba con la sesión cerrada. Confirma que la URL no esté bloqueada por una regla de redirección o de seguridad.

Envíos duplicados

Habilita el indicador de carga y el comportamiento de desactivación tras el éxito. Comprueba:

• los dobles clics provocados por una respuesta poco clara;
• los scripts personalizados que llaman a submit;
• los scripts de caché de página o de optimización que inicializan el formulario dos veces;
• un receptor externo que crea duplicados al reintentar.

Antes de solicitar soporte

Registra:

• el título del formulario y la URL pública de la página;
• el campo o la pestaña implicados;
• los pasos exactos para reproducir el problema;
• el resultado esperado y el real;
• si ocurre con la sesión cerrada;
• si funciona un formulario sencillo;
• si se ven afectados el correo, el almacenamiento, la subida o una integración externa;
• una captura de pantalla sin datos personales.