概要
cptui_inside_listings_wrap
は、WordPressプラグイン「Custom Post Type UI」における特定のフックであり、カスタム投稿タイプのListingsページの内部でカスタムコンテンツを追加するために使用されます。このアクションは、カスタム投稿型を管理するユーザーインターフェイスをカスタマイズしたい場合に役立ちます。具体的には、以下のような機能を実装する際に利用されることが一般的です:
- Listingsページに説明文を追加する
- 各カスタム投稿タイプのオプションを強調表示する
- 投稿タイプの利用方法に関するヘルプガイドを表示する
- 各投稿タイプのサポートされているフィールドを示す
- 特定の条件に基づくアクションボタンを表示する
- カスタムメタボックスや追加情報を直接追加する
構文
add_action( 'cptui_inside_listings_wrap', 'custom_function_name' );
パラメータ
- なし
戻り値
- なし
使用可能なバージョン
- Custom Post Type UI: バージョン 1.0 以降
- WordPress: バージョン 4.5 以降
サンプルコード
サンプルコード 1
add_action( 'cptui_inside_listings_wrap', 'add_custom_description' );
function add_custom_description() {
echo '<div class="custom-description">このカスタム投稿タイプは特別な説明が必要です。</div>';
}
説明: Listingsページにカスタム投稿タイプ専用の説明文を追加します。
サンプルコード 2
add_action( 'cptui_inside_listings_wrap', 'highlight_post_type_options' );
function highlight_post_type_options() {
echo '<div class="highlight-options">特別なオプションがあります!</div>';
}
説明: Listingsページで特定のカスタム投稿タイプのオプションを強調表示します。
サンプルコード 3
add_action( 'cptui_inside_listings_wrap', 'show_help_guide' );
function show_help_guide() {
echo '<div class="help-guide">操作方法に関するヘルプがここに表示されます。</div>';
}
説明: カスタム投稿タイプの操作に関するヘルプガイドを表示します。
サンプルコード 4
add_action( 'cptui_inside_listings_wrap', 'display_supported_fields' );
function display_supported_fields() {
echo '<div class="supported-fields">この投稿タイプでサポートされているフィールド一覧です。</div>';
}
説明: 特定のカスタム投稿タイプでサポートされているフィールドの一覧を表示します。
サンプルコード 5
add_action( 'cptui_inside_listings_wrap', 'add_custom_meta_boxes' );
function add_custom_meta_boxes() {
echo '<div class="custom-meta-box">ここにカスタムメタボックスの内容が表示されます。</div>';
}
説明: Listingsページにカスタムメタボックスを追加します。
この関数のアクションでの使用可能性
アクション | 使用例 |
---|---|
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 |