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

概要

cptui_post_type_after_fieldsetsアクションは、WordPressプラグインCustom Post Type UIによって提供されるフックで、特定のカスタム投稿タイプのフィールドセクションの後に追加の内容を挿入するために使われます。このアクションは、カスタムフィールド、設定オプション、ユーザーインターフェースのカスタマイズなど、さまざまな機能を実装する際によく利用されます。以下は、その具体的な使用例です。

カスタムメタボックスの追加 – 投稿タイプの詳細設定にカスタムフィールドを追加する。
特別な設定オプションの表示 – 特定の条件下で設定する必要があるオプションを示す。
インストラクションの提供 – ユーザーにフィールドの使用方法についての説明を追加する。
視覚的なカスタマイズの実施 – カスタムスタイルを用いたビジュアルな要素の追加。
エラーメッセージの表示 – ユーザー入力に対するリアルタイムでのフィードバックを提供する。
JavaScript/CSSのインクルード – 特定のカスタム投稿タイプのためのスクリプトやスタイルシートを読み込む。

構文

add_action('cptui_post_type_after_fieldsets', 'your_function_name', 10, 2);

パラメータ

string $post_type: 現在のカスタム投稿タイプのスラッグ。
array $args: カスタム投稿タイプの引数の配列。

戻り値

このアクションには戻り値はありません。

使用可能なプラグインとワードプレスのバージョン

Custom Post Type UI バージョン: 1.9.0以上
WordPress バージョン: 4.5以上

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

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

サンプルコード

サンプル1: カスタムフィールドを追加

add_action('cptui_post_type_after_fieldsets', 'add_custom_fields_to_cpt', 10, 2);
function add_custom_fields_to_cpt($post_type, $args) {
    echo '<div class="cpt-custom-field"><label for="custom_field">Custom Field:</label>';
    echo '<input type="text" id="custom_field" name="custom_field" value=""></div>';
}

このサンプルコードは、カスタム投稿タイプの設定画面にカスタムフィールドを追加します。

サンプル2: メッセージを表示

add_action('cptui_post_type_after_fieldsets', 'show_custom_message', 10, 2);
function show_custom_message($post_type, $args) {
    echo '<div class="updated"><p>カスタム投稿タイプの設定を完了しました！</p></div>';
}

このコードは、カスタム投稿タイプの設定セクションの後に確認メッセージを表示します。

サンプル3: JavaScriptを追加

add_action('cptui_post_type_after_fieldsets', 'enqueue_custom_script', 10, 2);
function enqueue_custom_script($post_type, $args) {
    echo '<script type="text/javascript">console.log("カスタム投稿タイプ: ' . esc_js($post_type) . '");</script>';
}

このサンプルでは、指定されたカスタム投稿タイプのコンソールメッセージを表示するJavaScriptを追加します。

サンプル4: 特別な設定オプションを表示

add_action('cptui_post_type_after_fieldsets', 'display_special_options', 10, 2);
function display_special_options($post_type, $args) {
    echo '<p>特別な設定オプション</p>';
    echo '<input type="checkbox" id="special_option" name="special_option"> このオプションを有効にする';
}

特別なオプションを有効にするためのチェックボックスを追加するサンプルです。

サンプル5: スタイルを追加

add_action('cptui_post_type_after_fieldsets', 'add_custom_styles', 10, 2);
function add_custom_styles($post_type, $args) {
    echo '<style>.cpt-custom-field { margin-bottom: 10px; }</style>';
}

カスタムフィールドのスタイルを追加するためのCSSをインラインで挿入するサンプルです。

概要

構文