プラグインCustom Post Type UIのcptui_taxonomy_after_fieldsetsアクションの使用方法・解説

概要

cptui_taxonomy_after_fieldsetsは、WordPressのプラグイン「Custom Post Type UI」におけるアクションフックです。このフックは、カスタムタクソノミーを作成した後のフィールドセットの後に特定の処理を追加するために使用されます。このアクションを利用することで、ユーザーは以下のような機能を実装する際によく使われます：

追加のオプションフィールドを生成する
タクソノミーにカスタムメタデータを追加する
タクソノミーの表示スタイルをカスタマイズする
タクソノミー登録時に特別な設定を行う
特定の条件に基づいてユーザーの入力を検証する
タクソノミーに関連するスクリプトやスタイルをエンキューする

構文

add_action('cptui_taxonomy_after_fieldsets', 'your_custom_function', 10, 1);

パラメータ

your_custom_function: 実行したい関数名
10: 優先順位（任意）
1: 渡される引数の数

戻り値

なし。フックによって関数が実行されると、処理結果が直接操作を行う形になります。

使用可能なプラグインとバージョン

プラグイン: Custom Post Type UI
バージョン: 1.0以上 (実際の使用はプラグインのバージョンによりますが、最新の状況に合わせて確認が必要)

ワードプレスのバージョン

WordPress 5.0以上での使用を推奨しますが、プラグインとの互換性によります。

サンプルコード

サンプル1: タクソノミーに追加フィールドを表示

add_action('cptui_taxonomy_after_fieldsets', 'add_custom_taxonomy_fields', 10, 1);
function add_custom_taxonomy_fields($taxonomy) {
    echo '<div class="custom-field">';
    echo '<label for="custom_field">Custom Field</label>';
    echo '<input type="text" name="custom_field" id="custom_field" value="" />';
    echo '</div>';
}

このサンプルでは、カスタムタクソノミーの設定画面に追加フィールドを表示します。

サンプル2: メタデータの保存

add_action('cptui_taxonomy_after_fieldsets', 'save_custom_taxonomy_meta', 10, 1);
function save_custom_taxonomy_meta($taxonomy) {
    if (isset($_POST['custom_field'])) {
        // メタデータを保存
        update_term_meta($taxonomy, 'custom_field', sanitize_text_field($_POST['custom_field']));
    }
}

このコードは、タクソノミー作成時に入力されたデータを保存するためのものです。

サンプル3: タクソノミーの表示カスタマイズ

add_action('cptui_taxonomy_after_fieldsets', 'custom_taxonomy_display', 10, 1);
function custom_taxonomy_display($taxonomy) {
    echo '<style>.custom-field { margin: 10px 0; }</style>';
}

このサンプルでは、タクソノミーの設定画面に特定のスタイルを適用しています。

サンプル4: 認証用のカスタムメッセージ

add_action('cptui_taxonomy_after_fieldsets', 'custom_taxonomy_validation_message', 10, 1);
function custom_taxonomy_validation_message($taxonomy) {
    echo '<p style="color:red;">注意: 必須項目をすべて記入してください。</p>';
}

このサンプルは、タクソノミー設定画面にカスタムメッセージを表示するものです。

サンプル5: スクリプトのエンキュー

add_action('cptui_taxonomy_after_fieldsets', 'enqueue_custom_scripts', 10, 1);
function enqueue_custom_scripts($taxonomy) {
    wp_enqueue_script('custom-script', get_template_directory_uri() . '/js/custom-script.js', array('jquery'), null, true);
}

このコードは、タクソノミー設定画面にカスタムJavaScriptをエンキューします。

この関数のアクションでの使用可能性

アクション	使用例
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

概要

構文