プラグインThe Events Calendarのtec_events_seo_robots_meta_includeフィルタの使用方法・解説

概要

tec_events_seo_robots_meta_include フィルタは、The Events Calendar プラグインにおいて、特定のカスタムポストタイプ（イベントなど）のSEOメタタグを調整するために使用されます。このフィルタを利用すると、検索エンジンのクローラーが特定のページをインデックスする方法を制御することができます。以下は、tec_events_seo_robots_meta_include フィルタがよく使われる機能の例です。

検索エンジンからのクロールの許可/禁止
特定のイベントページのノーフォロー設定
カスタムポストタイプのSEO設定の最適化
クローラーに対する特定のメタタグの追加
特定の条件に応じたメタタグの動的変更
ソーシャルメディア共有のための設定調整

構文

add_filter('tec_events_seo_robots_meta_include', 'your_function_name', 10, 2);

パラメータ

$include (bool): メタタグのインクルードを制御するための値。
$event (WP_Post): 現在のイベントオブジェクト。

戻り値

bool: メタタグをインクルードするかどうかの判断を返す。

プラグインおよびワードプレスのバージョン

The Events Calendar：5.0.0以降
WordPress：5.0以降

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

アクション名	使用可能性
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_filter('tec_events_seo_robots_meta_include', 'add_no_follow_to_specific_event', 10, 2);

function add_no_follow_to_specific_event($include, $event) {
    if ($event->ID === 123) { // イベントIDが123の場合
        return false; // ノーフォローを適用
    }
    return $include; // それ以外は元の設定を維持
}

このコードは、イベントIDが123のイベントに対してノーフォローメタタグを適用します。

サンプルコード2: すべてのイベントにノーフォローメタタグ追加

add_filter('tec_events_seo_robots_meta_include', '__return_false');

このコードは、すべてのイベントページにノーフォローメタタグを追加します。

サンプルコード3: 特定の条件に応じてメタタグのインクルードを制御

add_filter('tec_events_seo_robots_meta_include', 'conditional_meta_include', 10, 2);

function conditional_meta_include($include, $event) {
    if (is_user_logged_in()) {
        return true; // ログインユーザーにはメタタグをインクルード
    }
    return false; // 非ログインユーザーにはノーフォロー
}

このコードは、ログインユーザーに対してのみメタタグをインクルードし、非ログインユーザーにはノーフォローを設定します。

サンプルコード4: カスタム条件によるメタタグの設定

add_filter('tec_events_seo_robots_meta_include', 'custom_event_meta_include', 10, 2);

function custom_event_meta_include($include, $event) {
    if ($event->post_date < date('Y-m-d H:i:s')) {
        return false; // 過去のイベントにはノーフォローを適用
    }
    return $include; // それ以外は元の設定を維持
}

このコードは、過去の日付のイベントにノーフォローメタタグを適用します。

サンプルコード5: URLパラメータに基づくメタタグの制御

add_filter('tec_events_seo_robots_meta_include', 'meta_include_based_on_query', 10, 2);

function meta_include_based_on_query($include, $event) {
    if (isset($_GET['no_index']) && $_GET['no_index'] === 'true') {
        return false; // URLにno_indexパラメータがある場合
    }
    return $include; // それ以外は元の設定を維持
}

このコードは、URLにno_index=trueというパラメータが含まれている場合、メタタグをノーフォローにします。

概要

構文