wpforms_entry_email_atts

Descrição

O filtro wpforms_entry_email_atts permite modificar os atributos da notificação por e-mail programaticamente antes do envio das notificações. Isto é particularmente útil ao gerir lógica de notificação complexa que seria impraticável configurar através do construtor de formulários.

Parâmetros

$email

(array) Os atributos da notificação por e-mail, incluindo assunto, mensagem e outras definições.

$fields

(array) Dados e valores dos campos do formulário.

$entrada

(array) Dados e metadados da entrada.

$form_data

(array) Configurações/dados do formulário processados, preparados para serem usados posteriormente.

$notification_id

(array) O ID da notificação atual que está a ser processada.

Este filtro permite modificar os atributos da notificação por e-mail programaticamente antes de serem enviados. Isto é especialmente valioso ao lidar com lógica de notificação condicional complexa baseada nos valores dos campos do formulário, como notificações específicas de país ou cenários de múltiplos destinatários.

Pode aceder e modificar o assunto do e-mail usando $email['subject']. Isto permite a personalização programática da linha de assunto com base nos seus requisitos específicos.

Exemplo

/**
 * Customize email notification attributes.
 *
 * @link https://wpforms.com/developers/wpforms_entry_email_atts
 *
 * @param array $email           Email notification settings.
 * @param array $fields          Form fields data.
 * @param array $entry           Entry data.
 * @param array $form_data       Form data and settings.
 * @param int   $notification_id Notification ID.
 * 
 * @return array
 */
function wpf_custom_email_notification( $email, $fields, $entry, $form_data, $notification_id ) {
    // Add custom logic here to modify email attributes based on form fields
    // Example: Modify subject, recipients, sender info based on country selection
    
    return $email;
}
add_filter( 'wpforms_entry_email_atts', 'wpf_custom_email_notification', 10, 5 );