Atenção!

Este artigo contém código PHP e destina-se a programadores. Oferecemos este código como cortesia, mas não prestamos suporte para personalizações de código ou desenvolvimento de terceiros.

Para orientação adicional, consulte o tutorial da WPBeginner sobre como adicionar código personalizado.

Ignorar

Como Alterar o Texto de "Nenhum Resultado Encontrado" no Campo de Lista Suspensa Moderno

Gostaria de personalizar o texto que aparece quando não são encontrados resultados num campo de Menu Suspenso Moderno? Com um simples trecho de código, pode modificar a mensagem padrão Nenhum resultado encontrado e torná-la traduzível para sites multilíngues. Esta funcionalidade é particularmente útil para melhorar a experiência do utilizador, fornecendo feedback mais contextual quando os resultados da pesquisa estão vazios.

Por defeito, os visitantes verão a mensagem Nenhum resultado encontrado quando a sua pesquisa não produzir resultados no seu menu suspenso.

Uma mensagem de Nenhum Resultado Encontrado será exibida na caixa de pesquisa quando o termo não for encontrado no menu suspenso

Neste tutorial, forneceremos o código PHP de que necessita para alterar este texto e guiá-lo-emos através de cada passo.

Configurar o Seu Formulário

Primeiro, vamos criar um novo formulário e adicionar os nossos campos de formulário, que incluirão pelo menos um campo Menu Suspenso.

Depois de adicionar o campo de formulário Menu Suspenso ao seu formulário, clique no separador Avançado e selecione Moderno no menu suspenso Estilo.

Adicionar um campo de menu suspenso moderno ao seu formulário

Se precisar de ajuda para criar um formulário, consulte o nosso guia sobre como criar o seu primeiro formulário.

Personalizar o Texto de Nenhum Resultado

Para alterar a mensagem padrão, adicione este código ao seu site. Se não tiver a certeza de como adicionar código personalizado, consulte o nosso guia sobre como adicionar trechos de código.

Este trecho só será aplicado ao ID do formulário 1369 e alterará a mensagem padrão noResultsText, substituindo-a pelo que adicionámos.

Se precisar de ajuda para encontrar o ID do seu formulário, consulte o nosso guia sobre como encontrar IDs de formulários e campos.

Personalizar o Texto de Nenhum Resultado e Seleção

Também pode personalizar o texto de "Pressione para selecionar" ao mesmo tempo:

/**
 * Change both No Results Found and Press to select text
 *
 * @link https://wpforms.com/developers/how-to-change-the-no-results-found-text-in-the-modern-dropdown/
 */
function wpf_dev_change_modern_dropdown_noresults_text( $config, $forms ) {
    // Change 1369 to an ID of your actual form
    if ( array_key_exists( 1369, $forms ) ) {
        $config[ 'noResultsText' ] = __( 'Apologies, your search term was not found', 'your-text-domain' );
        $config[ 'itemSelectText' ] = __( 'Choose this option.', 'your-text-domain' );
    }
    return $config;
}
add_filter( 'wpforms_field_select_choicesjs_config', 'wpf_dev_change_modern_dropdown_noresults_text', 10, 2 );

E é tudo o que precisa! Agora, em vez de ver Nenhum Resultado Encontrado, os utilizadores verão a sua mensagem personalizada.

Em seguida, gostaria de mostrar todos os seus campos de formulário concluídos na sua mensagem de confirmação? Dê uma vista de olhos ao nosso tutorial sobre Como Mostrar Todos os Campos na Sua Mensagem de Confirmação.

Filtro de Referência

wpforms_field_select_choicesjs_config