Descrição
Filtra a saída da mensagem de confirmação em todo o site.
Parâmetros
- $mensagem
- (string) (Obrigatório) Mensagem de confirmação, incluindo Smart Tags processadas.
- $form_data
- (array) (Obrigatório) Configurações/dados de formulário processados, preparados para serem usados posteriormente.
- $campos
- (array) (Obrigatório) Dados de campo higienizados.
- $entry_id
- (int) (Obrigatório) ID da entrada.
Fonte
wpforms/src/Frontend/Frontend.php
Mais informações
O filtro é aplicado a todos os formulários definidos para exibir uma mensagem de confirmação. Ele pode ser usado para alterar ou substituir a mensagem de confirmação que é exibida, substituindo o conteúdo da mensagem definido no construtor de formulários.
Exemplos
O exemplo mostrado abaixo capturará o nome do usuário que preencheu o formulário e, em seguida, fornecerá uma mensagem mais personalizada para a mensagem de confirmação.
Lembre-se apenas de alterar o ID do formulário de 25 para corresponder ao ID do formulário específico no qual você deseja executar o código. A remoção dessa verificação seria executada para todos os formulários.
/**
* Filters confirmation message output site-wide.
*
* @link https://wpforms.com/developers/wpforms_frontend_confirmation_message/
*
* @param string $message Confirmation message including Smart Tags.
* @param array $form_data Form data and settings.
* @param array $fields Sanitized field data.
* @param int $entry_id Entry ID.
*
* @return string
*/
function wpf_dev_frontend_confirmation_message( $message, $form_data, $fields, $entry_id ) {
// Only run on my form with ID = 25
if ( absint( $form_data[ 'id' ] ) !== 25 ) {
return $message;
}
// also it is possible to access the first, middle, and the last name as follows inplace of [ 'value' ]
// $contact_name = $fields[ '0' ][ 'first' ]; - this will pass in the first name
// $contact_name = $fields[ '0' ][ 'last' ]; - this will pass in the last name
// $contact_name = $fields[ '0' ][ 'middle' ]; - this will pass in the middle name in the format First Middle Last
// Get the name field ID '0' to set the name for the message
$contact_name = $fields[ '0' ][ 'value' ];
// Add the name to the message
$message = __('Thanks ' . $contact_name . ' we will be in touch!', 'plugin-domain');
return $message;
}
add_filter( 'wpforms_frontend_confirmation_message', 'wpf_dev_frontend_confirmation_message', 10, 4 );