概要
tec_events_title_taxonomiesはThe Events Calendarプラグインのフィルターフックであり、イベントのタイトルに関連するタクソノミーを操作するために使用されます。このフィルターは、特定のタクソノミー（例：カテゴリ、タグ等）をイベントのタイトルに追加または変更する際に利用されます。
よく使われる機能
このフィルターは以下のような機能を実装する際によく使われます。
1. カスタムタクソノミーをイベントタイトルに追加する
2. タクソノミー名のフォーマットを変更する
3. イベントタイトル内のタクソノミー情報の表示をカスタマイズする
4. 特定のタクソノミーの条件に基づいてタイトルをフィルタリングする
5. タクソノミーの名前を多言語に対応させる
6. タクソノミーに基づくイベントのフィルタリング機能を追加する
構文
add_filter('tec_events_title_taxonomies', 'your_custom_function', 10, 2);
パラメータ
$taxonomies– 使用されるタクソノミーの配列$event– 現在のイベントオブジェクト
戻り値
- タクソノミーの配列（変更されたもの）
バージョン
- The Events Calendar: 6.0以降
- WordPress: 5.0以降
サンプルコード
サンプルコード 1: カスタムタクソノミーの追加
このコードは、カスタムタクソノミーをイベントタイトルに追加します。
add_filter('tec_events_title_taxonomies', function($taxonomies, $event) {
$taxonomies[] = 'custom_taxonomy';
return $taxonomies;
});
引用元: https://theeventscalendar.com
サンプルコード 2: タクソノミー名のフォーマット変更
このコードでは、特定のタクソノミー名を大文字にフォーマットします。
add_filter('tec_events_title_taxonomies', function($taxonomies, $event) {
foreach ($taxonomies as &$taxonomy) {
$taxonomy = strtoupper($taxonomy);
}
return $taxonomies;
});
引用元: https://theeventscalendar.com
サンプルコード 3: イベントタイトルに日付を追加
このサンプルコードは、イベントタイトルに日付を追加します。
add_filter('tec_events_title_taxonomies', function($taxonomies, $event) {
$date = get_the_date('Y-m-d', $event->ID);
$taxonomies[] = $date;
return $taxonomies;
});
引用元: https://theeventscalendar.com
サンプルコード 4: タクソノミーを条件付きで除外
このコードは、特定の条件に応じてタクソノミーを除外します。
add_filter('tec_events_title_taxonomies', function($taxonomies, $event) {
if (has_term('exclude_this_taxonomy', 'taxonomy', $event->ID)) {
$taxonomies = array_diff($taxonomies, ['exclude_this_taxonomy']);
}
return $taxonomies;
});
引用元: https://theeventscalendar.com
サンプルコード 5: タクソノミーを国際化する
このコードは、タクソノミー名を多言語化します。
add_filter('tec_events_title_taxonomies', function($taxonomies, $event) {
foreach ($taxonomies as &$taxonomy) {
$taxonomy = __('Your Taxonomy Name', 'text-domain');
}
return $taxonomies;
});
引用元: https://theeventscalendar.com
この関数のアクションでの使用可能性
| アクション | 使用例 |
|---|---|
| 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 |