apply_filters( 'wpforms_dynamic_choice_post_type_args', array $args, array $field, int $form_id )

Descrição

O wpforms_dynamic_choice_post_type_args é usado para preencher o filtro Opções dinâmicas para tipos de post e taxonomias.

Parâmetros

$args

(array) (Obrigatório) Argumentos do envio da postagem, como ID da categoria, ID da tag, ID do autor etc.

$campo

(array) Valores/propriedades do campo de entrada sanitizados.

$form_id

(int) ID do formulário.

Fonte

wpforms/includes/functions/form-fields.php

Mais informações

O wpforms_dynamic_choice_post_type_args fornece uma lista de argumentos compatíveis da postagem, como Category. Da mesma forma, você também pode usar o filtro wpforms_dynamic_choice_taxonomy_args para extrair argumentos da taxonomia de Tags.

Neste exemplo mostrado abaixo, a função processará o ID do formulário 789 para a ID do campo 10 e incluir apenas postagens da categoria 11.

Exemplos

/**
 * Limit posts or pages displayed by category.
 *
 * @link https://wpforms.com/developers/wpforms_dynamic_choice_post_type_args
 *
 * @param array $args       Arguments from post submission.     
 * @param array $field      Sanitized field data. 
 * @param int   $form_id    Form ID
 *
 * @return $args
 */

function wpf_dev_dynamic_choices_categories( $args, $field, $form_id ) {
    
     // Only on form #789 and field #10
     if ( $form_data[ 'id' ] == 789 && $field[ 'id' ] == 10 ) {

         $args[ 'category' ] = '11';		 
    
     }
	
     return $args;
}

add_filter( 'wpforms_dynamic_choice_post_type_args', 'wpf_dev_dynamic_choices_categories', 10, 3 );

Artigos de referência

Como excluir posts, páginas ou categorias das opções dinâmicas

PERGUNTAS FREQUENTES

P: Como posso mostrar apenas as categorias infantis?

R: Para exibir categorias secundárias em seu formulário, você precisa incluir tanto a ID da categoria principal quanto as IDs das categorias secundárias. Isso ocorre porque a funcionalidade atual exige que a categoria principal seja especificada para buscar e exibir corretamente as categorias secundárias.

/**
 * Limit posts or pages displayed by category.
 *
 * @link https://wpforms.com/developers/wpforms_dynamic_choice_post_type_args
 *
 * @param array $args   Arguments for post submission.     
 * @param array $field  Sanitized field data. 
 * @param int   $form_id Form ID
 *
 * @return array Updated arguments
 */

function wpf_dev_dynamic_choices_include( $args, $field, $form_id ) {
    // Ensure form ID is correctly handled
    if ( is_array( $form_id ) ) {
        $form_id = $form_id[ 'id' ];
    }

    // Apply only to specific form and field IDs
    if ( $form_id == 122 && $field[ 'id' ] == 11 ) {
        // Include category IDs - 87 is the parent; 88 and 89 are child categories
        $args['include'] = '87,88,89';
    }

    return $args;
}
add_filter( 'wpforms_dynamic_choice_taxonomy_args', 'wpf_dev_dynamic_choices_include', 10, 3 );

Esse snippet garante que tanto a categoria pai (ID 87) quanto as categorias filhas (IDs 88 e 89) sejam incluídas nas escolhas dinâmicas.