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

タナビーの高梨です。

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

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

今回は固定、投稿ページのメタディスクリプション内容を変更できるフィルターフック
👉get_meta_description_text
です

フックの概要

発火条件

固定ページ、投稿ページ描画時に無条件に1回発火します。

使いどころ

通常、メタデスクリプションは以下のように設定されます。

・固定ページ👉本文の冒頭または、抜粋で設定した内容

・投稿ページ👉記事名または、抜粋で設定した内容

このフックを使えば、メタディスクリプションの内容を自由に変更できます。

ページ単位・条件分岐による制御もできるため、柔軟なSEO対策に活用できそうです。

引数

$description：（string）metaタグのcontentに設定される文字列

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

return apply_filters('get_meta_description_text', $description);

カスタマイズコード例

無条件にメタディスクリプションに「modified description」という内容を設定する例です。

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

function customize_get_meta_description_text ( $description ) {

    $description = 'modified description';
    
    return $description;

}
add_filter('get_meta_description_text', 'customize_get_meta_description_text' );

注意点

・無条件で発火するため、条件分岐なしで変更すると 全投稿・固定ページに影響 する
・文字数は検索結果表示を考慮し、概ね120文字程度に収めるのが無難

まとめ

・get_meta_description_textは、Cocoonのメタディスクリプション生成処理の最終段階に介入できるフィルターフック
・発火条件は単純で、扱い自体も分かりやすい
・自動生成任せでは難しいSEO調整を行いたい場合に有効