Atenção!

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

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

Dispensar

Descrição

O filtro wpforms_field_select_choicesjs_config é usado para fornecer a capacidade de alterar as configurações de configuração padrão para o campo de formulário Dropdown Moderno.

Parâmetros

$config
(array) Array de configurações de configuração padrão usadas para o dropdown.
$forms
(int) ID do formulário.

Fonte

wpforms/includes/fields/class-base.php

Mais Informações

O filtro tem um conjunto de configuração padrão, como os textos Carregando, Sem Resultados, Selecionar Item e outros. Uma lista completa de valores de texto e seus nomes de chave pode ser vista abaixo.

'loadingText' => esc_html__( 'Carregando...', 'wpforms-lite' ),
'noResultsText' => esc_html__( 'Nenhum resultado encontrado.', 'wpforms-lite' ),
'noChoicesText' => esc_html__( 'Não há opções para escolher.', 'wpforms-lite' ),
'itemSelectText' => esc_attr__( 'Pressione para selecionar.', 'wpforms-lite' ),
'uniqueItemText' => esc_html__( 'Apenas valores únicos podem ser adicionados.', 'wpforms-lite' ),
'customAddItemText' => esc_html__( 'Apenas valores que atendem a condições específicas podem ser adicionados.', 'wpforms-lite' )

Exemplo

/**
 * Configuration text settings for the Modern Dropdown form field.
 *
 * @link   https://wpforms.com/developers/wpforms_field_select_choicesjs_config/
 *
 * @param  array $config
 * @param  int   $forms
 * @return array
 */

function wpf_dev_change_modern_dropdown_noresults_text( $config, $forms ) {
      
    // Change 519 to an ID of your actual form or remove this condition to apply to all forms.
    if ( ! array_key_exists( 519, $forms ) ) {
        return $config;
    }
      
        // If there are several forms on the same page, the customization will be applied to all of them.
        $config[ 'loadingText' ]       = __( 'Searching....', 'your-text-domain' );
		$config[ 'noResultsText' ]     = __( 'Nothing to be found', 'your-text-domain' );
		$config[ 'noChoicesText' ]     = __( 'These are not the choices you are looking for', 'your-text-domain' );
		$config[ 'itemSelectText' ]    = __( 'Select me', 'your-text-domain' );
		$config[ 'uniqueItemText' ]    = __( 'Only unique values can be added.', 'your-text-domain' );
		$config[ 'customAddItemText' ] = __( 'Only values matching specific conditions can be added.', 'your-text-domain' );
		$config[ 'searchResultLimit' ] = 2;
  
    return $config;
}
  
add_filter( 'wpforms_field_select_choicesjs_config', 'wpf_dev_change_modern_dropdown_noresults_text', 10, 2 );

Artigos de Referência