wpforms_entry_email_atts

Descrição

O filtro wpforms_entry_email_atts permite modificar os atributos de notificação por e-mail programaticamente antes do envio das notificações. Isso é particularmente útil ao gerenciar lógicas de notificação complexas que seriam impraticáveis de configurar através do construtor de formulários.

Parâmetros

$email

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

$fields

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

$entry

(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á sendo processada.

Este filtro permite modificar os atributos de notificação por e-mail programaticamente antes que sejam enviados. Isso é especialmente valioso ao lidar com lógicas de notificação condicional complexas baseadas em valores de campos do formulário, como notificações específicas de país ou cenários de múltiplos destinatários.

Você pode acessar e modificar o assunto do e-mail usando $email['subject']. Isso permite a personalização programática da linha de assunto com base em 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 );