概要
cptui_after_taxonomy_listingアクションフックは、Custom Post Type UIプラグインを使用してカスタムタクソノミーをリストする際にトリガーされます。このフックは、カスタムタクソノミーの表示の後に独自の処理を追加するために便利です。一般的に以下のような機能を実装する際によく使われます。
- カスタムタクソノミーのリストにスタイルを適用
- タクソノミー項目にカスタムフィールドを追加
- タクソノミーの項目をフィルタリングまたは変更
- タクソノミーに関連するメタ情報の表示
- タクソノミーに関連する統計情報の追加
- タクソノミーのリンクをカスタマイズしたURLに変更
構文
add_action('cptui_after_taxonomy_listing', 'your_custom_function');
パラメータ
このアクションフックは、特定のパラメータを持たない簡単な実装となります。
戻り値
このフックは特定の値を返すものではなく、処理を追加するために使用されます。
使用可能なプラグインのバージョンとワードプレスのバージョン
- Custom Post Type UIのバージョン: 1.10.1以降
- WordPressのバージョン: 5.0以降
サンプルコード
サンプルコード1
add_action('cptui_after_taxonomy_listing', function() {
echo '<div class="custom-message">カスタムタクソノミーのリストがここに表示されます。</div>';
});
// このコードは、カスタムタクソノミーのリストの後にメッセージを表示します。
サンプルコード2
add_action('cptui_after_taxonomy_listing', 'modify_taxonomy_output');
function modify_taxonomy_output() {
echo '<h2>特定のタクソノミーに関する情報</h2>';
// 特定のタクソノミーに関連する情報をここに追加
}
// このコードは、タクソノミーリストの後に特定の情報を表示します。
サンプルコード3
add_action('cptui_after_taxonomy_listing', 'add_custom_css');
function add_custom_css() {
echo '<style>.taxonomy-list { color: blue; }</style>';
}
// このコードは、カスタムタクソノミーリストにCSSスタイルを適用します。
サンプルコード4
add_action('cptui_after_taxonomy_listing', 'show_taxonomy_meta');
function show_taxonomy_meta() {
// カスタムタクソノミーに関するメタ情報を表示するためのロジック
echo '<p>このタクソノミーの説明文やメタ情報。</p>';
}
// このコードは、カスタムタクソノミーのメタ情報を追加します。
サンプルコード5
add_action('cptui_after_taxonomy_listing', 'custom_taxonomy_stats');
function custom_taxonomy_stats() {
$term_count = 10; // 例として固定の数字を使用。実際のクエリを実行して取得することも可能。
echo "<p>このタクソノミーには {$term_count} 件の項目があります。</p>";
}
// このコードは、カスタムタクソノミーの項目数を表示します。
この関数のアクションでの使用可能性
| アクション | 使用可能性 |
|---|---|
| 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 |