概要
cptui_taxonomy_submit_select 関数は、WordPress の Custom Post Type UI プラグインにおいて、カスタムタクソノミーを作成する際に使用される関数です。この関数は、特定のサイト構造に対応したカスタムタクソノミーを問い合わせるための選択肢を表示するのに役立ちます。以下のような機能を実装する際よく使用されます。
- カスタムポストタイプに関連付けるタクソノミーの選択
- 複数のタクソノミーを選択可能なフォームの作成
- タクソノミーに基づくフィルタリング機能の実装
- カスタム管理画面でのタクソノミーの管理
- クライアントサイドでのタクソノミーの動的な選択フィルタリング
- 特定の条件に基づくタクソノミーの詳細表示
構文
cptui_taxonomy_submit_select( $taxonomies = array(), $selected = '', $args = array() );
パラメータ
– $taxonomies (array) – 表示するタクソノミーの配列
– $selected (string) – 初期選択されるタクソノミーの ID
– $args (array) – タクソノミー選択に関する追加の引数
戻り値
– HTMLの<select>要素が返されます。
使用可能なプラグインバージョン
– Custom Post Type UI: バージョン 1.10.0以降
使用可能なWordPressバージョン
– WordPress: バージョン 4.0以降
サンプルコード
以下に cptui_taxonomy_submit_select 関数の使用例を示します。
サンプルコード 1: タクソノミーの選択肢表示
$taxonomies = array('category', 'post_tag');
echo cptui_taxonomy_submit_select($taxonomies, 'category');
このコードは、category と post_tag のタクソノミーの選択肢を表示します。デフォルトで category が選択されています。
サンプルコード 2: 特定のタクソノミーの選択
$custom_taxonomies = array('genre', 'actor');
echo cptui_taxonomy_submit_select($custom_taxonomies, 'actor');
ここでは、genre と actor というカスタムタクソノミーの中から actor が初期選択として表示されます。
サンプルコード 3: 引数を使った表示のカスタマイズ
$args = array('name' => 'custom_tax', 'id' => 'custom_tax_id');
echo cptui_taxonomy_submit_select($custom_taxonomies, '', $args);
この例では、タクソノミーがカスタマイズされたIDを持つselect要素として表示されます。
サンプルコード 4: 階層タクソノミーの使用
$taxonomy_hierarchy = array('category', 'genre');
echo cptui_taxonomy_submit_select($taxonomy_hierarchy);
これは階層的なタクソノミー（categoryとgenre）を表示し、階層を保持した状態で選択肢を実装します。
サンプルコード 5: 複数のタクソノミーを表示
$multiple_taxonomies = array('post_format', 'custom_taxonomy_1', 'custom_taxonomy_2');
echo cptui_taxonomy_submit_select($multiple_taxonomies);
このコードは、3つの異なるタクソノミーを一つの選択リストにまとめて表示します。
この関数のアクションでの使用可能性
| アクション | 使用可能性 |
|---|---|
| mu_plugin_loaded | |
| registered_post_type | 〇 |
| plugins_loaded | 〇 |
| wp_roles_init | |
| setup_theme | |
| after_setup_theme | |
| set_current_user | |
| init | 〇 |
| register_sidebar | |
| wp_loaded | 〇 |
| send_headers | |
| parse_query | |
| pre_get_posts | |
| wp | 〇 |
| template_redirect | |
| get_header | |
| wp_head |