SOQVER ソースを準備
日本語

WordPress用 SO4AG Facts

事業の情報を自社サイトで公開し、何が誰にいつまで適用されるかをAIアシスタントやその他のプログラムが正しく扱えるようにする無料プラグインです。料金、営業時間、支払い、配送、キャンセル、保証に対応しています。

プラグインをダウンロード(ZIP、バージョン0.1.0) マニュアルを読む

無料で、アカウントは不要です。有料機能はありません。WooCommerceに対応しています。動作環境はWordPress 6.4以降、PHP 7.4以降です。ライセンスはGPL-2.0-or-laterです。

プラグインでサイトに追加されるもの

プログラム向けファイル

https://your-site.com/so4ag.json

すべての情報をオープンなSO4AG形式で提供します。キーや登録なしで、どなたでも読み取れます。

閲覧者向けページ

任意のページに「基本情報と利用条件」の表を表示できます。表には、項目、値、適用対象、有効期限が記載されます。

ブロックまたはショートコード [so4ag_facts] で追加できます。

構造化データ

同じ情報をJSON-LD(schema.org)形式でそのページのコードに埋め込みます。検索エンジンやJSON-LD対応ツールが読み取れます。

仕組み

1. 事実を入力

設定はWordPressの管理画面で行います。WooCommerceをご利用の場合は、ボタンを1回押すと、ストアの設定に基づいて配送料と支払い方法の候補が表示されます。

2. 事実を確認

情報は自動では公開されません。公開するには、内容が正しいことを明示的に確認する必要があります。

3. 3つの形式で公開

ファイル、ページ、JSON-LDには、常に最後に確認した同じ内容が反映されます。編集中の内容は非公開です。

4. プラグインが有効期限を監視

各項目には有効期限があります。期限の2週間前に、内容を見直して再確認するよう管理画面に通知が表示されます。

各項目に含まれる情報

操作手順

以下のタブ名とボタン名は、プラグイン内の表示と同じです。

目次 1. インストール · 2. 事業情報 · 3. 事実の追加 · 4. 条件 · 5. WooCommerce · 6. 公開 · 7. ページ · 8. 確認 · 9. 最新の状態に保つ · 10. llms.txt · 11. トラブルシューティング

1. プラグインをインストール

  1. このページからZIPファイルをダウンロードします。WordPressの管理画面で Plugins → Add New → Upload Plugin を開き、ダウンロードしたファイルを選んで Install Now を選択します。
  2. Activate を選択します。管理メニューに新しい項目 SO4AG Facts が表示されます。

2. 事業者情報を登録する

Business タブで事業者名を確認し、事業者の種別を選択します。必要に応じて、登録識別子の種類と値を追加します(たとえば、ein とEIN、または vat とVAT番号)。訂正依頼の連絡先は任意で、入力すると公開されます。

3. 事実情報を追加する

Facts タブで項目の種類を選び、Add を選択します。各項目には以下の4つの入力欄があります。

  1. 値を入力するか、We do not state this または It does not apply to us を選択します。
  2. 適用条件(Applies to)。項目の適用に実際に関係する条件のみを指定します。
  3. 有効期限(Applies until)。
  4. 情報を掲載しているページ(Page that states it)。空欄にすると、その情報は事業者自身の申告として公開されます。
項目掲載箇所必須条件最長
運営事業者フッター、利用規約–400日
所在地連絡先ページ(住所、営業時間)–180日
連絡先お問い合わせページchannel180日
料金料金表item60日
支払い方法利用規約、購入手続き画面–180日
予約の要否、回答までの時間予約ページ、連絡先ページ–90日
無料キャンセル、キャンセル料キャンセル規定–90日
保証保証規定–180日
新規顧客の受付可否お問い合わせページ–30日
配送料配送案内ページcountry, delivery_method60日
送料無料になる最低金額、代引き手数料配送案内ページcountry / –60日
返品可能期間、保証期間返品規定、利用規約–180日

このプラグインでは、業種を問わず使える事実情報が25項目、オンラインストア向けが10項目用意されています。「最長」は、1回の確認で設定できる有効期間の上限です。上限を超える日付は設定できません。

4. 条件の使い方

5. WooCommerceを使ったストア

Suggest from the shopボタンは、ストアの設定を読み取り、次の候補を作成します。

候補ごとにAccept、Complete、Dismissのいずれかを選びます。候補は公開されません。設定から読み取れない項目(計算式で決まる価格、クーポン利用時のみの送料無料、他のプラグインで設定された配送業者)は、注記に表示されます。

6. 確認して公開する

Confirm and publishタブには、公開される内容と前回からの変更点が表示されます。事実が本日時点で正しいことを確認するチェックボックスにチェックを入れ、Confirm and publishを選択してください。それ以降の編集内容は、再確認するまで公開されません。

事実の公開を取り消すには、同じタブのWithdrawを使用してください。作業中の事実データは保持されます。

7. ページに事実情報を表示する

Output and checkタブでCreate a draft page "Facts and terms"を選択し、ページの内容を確認して公開し、サイトのフッターからリンクを設定してください。ご自身のページに事実を掲載するには、Facts and termsブロックまたは次のショートコードを追加してください。

[so4ag_facts]
[so4ag_facts heading="no"]
[so4ag_facts level="h3"]

プラグインはサイトにリンクやバッジを追加せず、他のプラグインの出力も変更しません。JSON-LDは、事実を掲載したページにのみ出力されます。

8. 結果を確認する

  1. Output and checkタブでCheck the public addresses tooを選択してください。ファイルの構造と日付、およびページに掲載された事実がファイルの内容と一致しているかを確認します。
  2. 次のファイルのアドレスをブラウザーで開いてください。 https://your-site.com/so4ag.json
  3. 別の方法でも確認するには、そのアドレスを公開検証ツールに貼り付けてください。

9. 情報を最新に保つ

有効期限を過ぎた事実情報はファイルに残りますが、プログラムでは過去の情報として扱われ、表には期限切れと表示されます。管理画面では期限の14日前に通知が表示されます。見直し頻度の目安:

10. llms.txt

プラグインは、/llms.txtへのアクセスに対し、事実データの参照先を示す短いファイルを返すことができます。この機能は既定で無効です。Output and checkタブで有効にできます。サイトにすでにllms.txtがある場合、プラグインは既存のファイルを変更せず、ご自身で追記できる行を表示します。

11. トラブルシューティング

症状対処方法
/so4ag.json 「見つかりません」と表示されるWebサーバーがそのアドレスへのリクエストをWordPressに渡していません。プリティパーマリンク(Settings → Permalinks)を有効にするか、存在しないファイルへのリクエストをWordPressに渡すようホスティング事業者に依頼してください。対応が済むまでは、/?so4ag_facts=jsonのアドレスを利用できます。
確認結果に、ページとファイルの事実が一致しないと表示される古いページがキャッシュに残っています。キャッシュを消去して、もう一度確認してください。
ページにJSON-LDがないページにブロックもショートコードもないか、テーマがwp_footer()を呼び出していません。
プラグインで日付が受け付けられない事実の種類ごとに、確認時に設定できる有効期間の上限があります。より早い日付を選び、後日改めて確認してください。
サイトがhttpで動作しているファイルは配信されていますが、プログラムはhttpsでの配信を前提としています。

プラグインの対象外となる機能

開発者・制作会社の方へ

顧客のサイトを制作・運用されていますか。事実データの設定作業は、ご自身で顧客に請求できます。事実には有効期限があるため、担当者による定期的な見直しが必要です。顧客がSOQVERの監視サービスも契約すると、パートナープログラムを通じて利用料の一部が支払われます。アカウントと事実データは顧客に帰属します。

パートナープログラム 開発者向けのフォーマットとツール

プラグインのソースコードはパッケージに同梱されており、ライセンスはGPL-2.0-or-laterです。SO4AGは策定中のオープンフォーマットです。仕様、検証ツール、読み取りツールは無料で利用できます。仕様 · GitHub

よくある質問

アカウントや有料サービスは必要ですか?

いいえ。事実の入力と公開、ファイルとページの提供、JSON-LDの出力、検証は、すべてプラグイン単体で行えます。

使用中のSEOプラグインと併用できますか?

はい。他のプラグインの出力には手を加えません。事実を掲載したページにのみ、専用のJSON-LDブロックを追加します。

事実の有効期限が来るとどうなりますか?

ファイルには残りますが、プログラムは過去の情報として扱い、表には有効期限切れと表示されます。内容を見直し、新しい日付を設定して、もう一度確認してください。

プラグインを削除すると何が消えますか?

プラグインの設定、作業中の事実データ、公開版が削除されます。作成したページは残りますが、表は表示されなくなります。

プラグインをダウンロード(ZIP、バージョン0.1.0)