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

タナビーの高梨です。

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

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

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

フックの概要

発火条件

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

使いどころ

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

カテゴリーアーカイブページのメタディスクリプションは、

ダッシュボード＞投稿＞カテゴリー

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

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

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

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

引数

$res：（string）metaタグのcontentに設定されるキーワード文字列

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

return apply_filters('get_category_meta_keywords', $res);

カスタマイズコード例

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

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

function customize_get_category_meta_keywords ( $res ) {

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

}
add_filter('get_category_meta_keywords', 'customize_get_category_meta_keywords' );

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

注意点

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

まとめ

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