cocoonフック調査～get_tag_meta_keywordsの使い方と活用例

タナビーの高梨です。

WordPressのテーマ「Cocoon」には、テーマ改変なしでデザインや動作を拡張できる豊富なアクション・フィルターフックが用意されています。

分かる範囲で内容を調査したのでブログにまとめていこうと思います。

今回はタグアーカイブページのメタキーワード内容を変更できるフィルターフック
👉get_tag_meta_keywords
です

フックの概要

発火条件

タグアーカイブページ描画時に無条件に1回発火します。

使いどころ

正直、通常運用での使いどころは思い浮かびません。

タグアーカイブページのキーワードは、

ダッシュボード＞投稿＞タグ

で設定できる「メタキーワード」に入力した内容などがそのまま使用されます。

実際のアーカイブページでは、以下のような形で出力されます。

<meta name="keywords" content="ダッシュボードで設定したメタキーワードの内容">

これを 動的に書き換えたいケースがあまり想定しづらい ため、SEO調整をかなり細かく行う場合や、特殊な要件がある場合向けのフックと言えそうです。

引数

$res：（string）metaタグのcontentに設定される内容

apply_filters呼び出し元のソースコード

return apply_filters('get_tag_meta_keywords', $res);

カスタマイズコード例

無条件にメタキーワードに「modified keywords」という内容を設定する例です。

<meta name=”keywords” content=”modified keywords”>というタグになります。

function customize_get_tag_meta_keywords ( $res ) {

    $res = 'modified keywords';
    
    return $res;

}
add_filter('get_tag_meta_keywords', 'customize_get_tag_meta_keywords' );

条件分岐を追加すれば、特定のタグのみメタキーワードを差し替えるなども可能です。

注意点

・無条件で発火するため、条件分岐なしで変更すると すべてのタグに影響 する
・管理画面で設定したメタキーワードは 上書きされる
・特殊構成以外では、基本的に触る必要がないと思われる

まとめ

・get_tag_meta_keywords は、カテゴリーアーカイブページのメタキーワードを変更できるフィルターフック
・管理画面で設定した値の 最終出力を上書きできる
・通常運用では使いどころが限定的