説明

wpforms_dynamic_choice_taxonomy_args フィルターは、カテゴリーやタグなどの分類タームの動的選択肢を生成するために使用されます。

パラメータータイプ説明
$args配列 (必須)分類タームを取得するための引数。デフォルトでは以下のようになります。
taxonomy 文字列。フィールド設定で選択された分類(例: category または post_tag)。
hide_empty ブール値。投稿のないタームを非表示にするかどうか。デフォルトは false
$fieldarray動的選択肢フィールドのサニタイズされたフィールド設定とプロパティ。
$form_dataarrayフォームID。

ソース

wpforms/includes/admin/ajax-actions.php

/**
 * 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 );

参考記事