Añadir acciones de formulario programáticas

Los formularios programáticos admiten el comportamiento compartido de correo electrónico, almacenamiento/retención, redirección y presentación suministrado por la configuración normalizada.

Rutas de correo electrónico

Usa admin_routes para los destinatarios del sitio y client_routes para un mensaje al remitente. Cada ruta puede definir sus destinatarios, asunto, inclusión de mensaje/datos, política de subida y comportamiento condicional admitidos por POM Forms.

Los valores de los campos se referencian mediante etiquetas de combinación de formulario como:

{{field:contact_email}}
{{field:message}}
{{meta:form_name}}

Usa una dirección autorizada en el dominio del sitio como From y un campo del remitente validado como Reply-To cuando se esperen respuestas.

Comprobación previa del transporte

Antes de enviar un lote de notificaciones, el tiempo de ejecución de formularios llama a pom_mail_preflight para cada mensaje preparado. Las integraciones de transporte reciben true|WP_Error $result y una matriz que contiene to, subject, message, headers y attachments. Devuelve el error anterior sin cambios, true cuando la preparación se complete correctamente o WP_Error cuando se sepa que la entrega es imposible. Las devoluciones de llamada de validación no deben enviar correo, poner en cola reintentos ni crear registros de entrega. El código de error pom_mail_message_too_large selecciona el aviso sobre el tamaño de los adjuntos.

Sin un validador de transporte, el tema no aplica ningún límite de tamaño específico del proveedor. La entrega en tiempo de ejecución sigue usando wp_mail(). Los filtros de correo o los archivos modificados después de la validación siguen sujetos a las comprobaciones finales del transporte.

pom_forms_admin_email y pom_forms_client_email se ejecutan una vez por configuración seleccionada durante la preparación. pom_forms_submission_saved se ejecuta después de que la fila provisional y todas las notificaciones superen la comprobación previa, antes del envío del correo electrónico. No se ejecuta en un lote de notificaciones rechazado.

Almacenamiento y retención

Los formularios programáticos siguen la política de almacenamiento global de POM Forms a menos que store_submissions_override y retention_override_days definan intencionadamente una anulación permitida. El almacenamiento de archivos se controla de forma independiente. Documenta cada copia creada por correo electrónico, almacenamiento de WordPress y la integración propietaria.

Redirección y avisos

Usa la configuración normalizada para los mensajes de éxito/error, redirección opcional, indicador de carga, desplazamiento al mensaje y comportamiento del botón de envío. El visitante debe recibir un estado final comprensible incluso si un destino de correo electrónico falla.

Exclusiones deliberadas

pom_render_programmatic_form() fuerza:

$config['webhook_enabled']     = false;
$config['create_post_enabled'] = false;

Usa un formulario POM guardado cuando los editores necesiten esos flujos de trabajo. No los vuelvas a habilitar después del ayudante de preparación ni llames directamente a funciones de envío privadas.