Descrição

O filtro wpforms_dynamic_choice_taxonomy_args é usado para preencher as Escolhas Dinâmicas para termos de taxonomia, como categorias e etiquetas.

parâmetrotipodescrição
$argsarray (obrigatório)Argumentos para buscar termos de taxonomia. Por defeito:
taxonomy string. A taxonomia selecionada nas definições do campo, por exemplo category ou post_tag.
hide_empty bool. Se deve ocultar termos sem publicações. Por defeito false
$campomatrizDefinições e propriedades do campo higienizadas para o campo Escolhas Dinâmicas.
$form_datamatrizID do Formulário.

Origem

wpforms/includes/admin/ajax-actions.php

Exemplo

/**
 * Limit taxonomy terms displayed in a Dynamic Choices field.
 *
 * @link https://wpforms.com/developers/wpforms_dynamic_choice_taxonomy_args
 *
 * @param array $args     Arguments from taxonomy query.
 * @param array $field    Sanitized field data.
 * @param int   $form_id  Form ID.
 *
 * @return array Updated arguments
 */
function wpf_dev_dynamic_choices_taxonomies( $args, $field, $form_id ) {
    
    // Only run on form #456 and field #12
    if ( $form_id == 456 && $field['id'] == 12 ) {
        
        // Include categories with IDs 25, 26, and 27
        $args['include'] = '25,26,27';
    }
    
    return $args;
}
add_filter( 'wpforms_dynamic_choice_taxonomy_args', 'wpf_dev_dynamic_choices_taxonomies', 10, 3 );

Artigo de Referência