設定・メタボックス マニュアル

Kashiwazaki SEO Rich Preview Manager のグローバル設定、投稿別メタボックス、画像優先順位、出力形式、フィルター一覧を解説します。

グローバル設定（ksrpm_options）

設定画面で管理するすべてのオプション項目です。これらは wp_options テーブルに ksrpm_options キーで保存されます。

投稿別メタボックス

投稿編集画面に表示される「OGP Settings」メタボックスから、投稿ごとにリッチプレビュー情報をカスタマイズできます。ここで設定した値は、グローバル設定よりも優先されます。データは post_meta に _ksrpm_* プレフィックスで保存されます。

メタボックスの設定項目

画像優先順位チェーン

リッチプレビューに使用される画像は、以下の優先順位で決定されます。すべての出力タイプ（OGP、Twitter Card、Meta Thumbnail、PageMap）で共通のロジックです。

出力形式の例

本プラグインは wp_head アクションで以下のメタタグを出力します。

OGPタグ

<meta property="og:title" content="記事タイトル">
<meta property="og:description" content="記事の説明文">
<meta property="og:image" content="https://example.com/image.jpg">
<meta property="og:url" content="https://example.com/post/">
<meta property="og:type" content="article">
<meta property="og:site_name" content="サイト名">
<meta property="fb:app_id" content="123456789">

Twitter Cardタグ

<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="記事タイトル">
<meta name="twitter:description" content="記事の説明文">
<meta name="twitter:image" content="https://example.com/image.jpg">
<meta name="twitter:site" content="@example">

Meta Thumbnail

<meta name="thumbnail" content="https://example.com/image.jpg">

PageMap

<!--
<PageMap>
  <DataObject type="thumbnail">
    <Attribute name="src" value="https://example.com/image.jpg">
    <Attribute name="width" value="1200">
    <Attribute name="height" value="630">
  </DataObject>
</PageMap>
-->

robots max-image-preview

<meta name="robots" content="max-image-preview:large">

重複メタタグ検出チェッカー

設定画面で「重複チェッカー」を有効化すると、他のプラグインやテーマが出力するOGP/Twitter Cardメタタグとの重複を検出し、管理画面に警告を表示します。

フィルターリファレンス（主要10件）

本プラグインは34種類以上のカスタムフィルターを提供しています。以下はよく使用される主要なフィルターです。

フィルターの使用例

// og:title にサイト名を追加する例
add_filter('ksrpm_og_title', function($title) {
    return $title . ' | ' . get_bloginfo('name');
});

// 特定のカテゴリでOGP画像を固定する例
add_filter('ksrpm_og_image', function($image) {
    if (has_category('news')) {
        return 'https://example.com/news-ogp.jpg';
    }
    return $image;
});

// PageMapデータをカスタマイズする例
add_filter('ksrpm_pagemap_data', function($data) {
    $data['alt'] = get_the_title();
    return $data;
});