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

Descrição

O wpforms_dynamic_choice_post_type_args é utilizado para preencher o filtro Escolhas dinâmicas para tipos de mensagens e taxonomias.

Parâmetros

$args

(array) (Obrigatório) Argumentos da submissão da publicação, tais como ID da categoria, ID da etiqueta, ID do autor, etc.

$campo

(matriz) Valores/propriedades do campo de entrada higienizados.

$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 suportados da publicação, como Categoria. Da mesma forma, também pode utilizar o filtro wpforms_dynamic_choice_taxonomy_args para extrair argumentos da taxonomia de Etiquetas.

Neste exemplo apresentado abaixo, a função processará o ID do formulário 789 para o campo ID 10 e incluir apenas mensagens 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 escolhas dinâmicas

FAQ

P: Como é que posso mostrar apenas as categorias infantis?

R: Para exibir categorias secundárias no seu formulário, é necessário incluir a ID da categoria principal e as IDs da categoria secundária. Isto deve-se ao facto de a funcionalidade atual exigir que a categoria principal seja especificada para obter e apresentar 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 );

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