Description
The wpforms_field_select_choicesjs_config filter is used to provide the ability to change the default configuration settings for the Modern Dropdown form field.
Parameters
- $config
- (array) Array of default configuration settings used for the dropdown.
- $forms
- (int) Form ID.
Source
wpforms/includes/fields/class-select.php
More Information
The wpforms_field_select_choicesjs_config has a default configuration set such as the text Loading, No Results, Item Select and others. A full list of text values and their key names can be seen below.
'loadingText' => esc_html__( 'Loading...', 'wpforms-lite' ),
'noResultsText' => esc_html__( 'No results found.', 'wpforms-lite' ),
'noChoicesText' => esc_html__( 'No choices to choose from.', 'wpforms-lite' ),
'itemSelectText' => esc_attr__( 'Press to select.', 'wpforms-lite' ),
'uniqueItemText' => esc_html__( 'Only unique values can be added.', 'wpforms-lite' ),
'customAddItemText' => esc_html__( 'Only values matching specific conditions can be added.', 'wpforms-lite' ),
Example
/**
* 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 );
Related
Tutorial References:
