説明
「キキコミ VOC ウィジェット」プラグインを使用すると、Gyro-n の「キキコミ VOC」で収集したアンケート結果やお客様のクチコミを、WordPress サイトの任意のページに美しく表示できます。
ショートコードを配置するだけで、クチコミウィジェットと検索エンジン向けの JSON-LD 構造化データが自動的に埋め込まれ、サイトの SEO パフォーマンスを向上させます。
主な機能
- 簡単セットアップ:
[kikicomi_voc_widget]ショートコードを追加するだけで、投稿やページの好きな場所にクチコミウィジェットを表示できます。 - 店舗・アンケート絞り込み: 店舗 ID (
site_id) やアンケート ID (survey_id) を指定することで、特定の店舗やアンケートのウィジェットを表示できます。 - 自動挿入機能: 設定画面でページ ID を指定することで、本文を直接編集することなく投稿やページの本文末尾へ自動的にウィジェットを挿入できます。
- SEO 構造化データの自動出力: Google などの検索エンジン向けに、
<head>内へ JSON-LD 構造化データを自動出力します。 - 高性能キャッシュ: WordPress Transients API を利用してキャッシュを行い、高速なページ読み込みとサーバー負荷の軽減をします。
サードパーティサービス
本プラグインは、コア機能を提供するために以下のサードパーティ外部サービスに接続します:
- Gyro-n キキコミ VOC API
- サービス提供元: 株式会社ジャイロン (Gyro-n)
- サービス URL: https://www.gyro-n.com/
- API エンドポイント: https://seo.gyro-n.com/api/survey_voc/review_widget
- 利用規約: https://www.gyro-n.com/home/termsofuse/
- プライバシーポリシー: https://www.gyro-n.com/home/privacypolicy/
- 目的: ウィジェットデータを取得するため、プラグインは WordPress サーバーからキキコミ VOC API へ以下の情報を送信します。
クライアントトークン、API キー、および指定された site_id と survey_id (指定されている場合)。
これらのリクエストはサーバー側で実行され、サイト訪問者のブラウザから直接行われることはありません。
応答として、API はキキコミ VOC で設定されたクチコミ本文、評価、表示名、日付、店舗 / 場所情報、その他のクチコミメタデータなどのクチコミ関連情報を返します。
プラグインはキャッシュを目的として、API 応答データを WordPress Transient に最大 1 時間一時保存します。
本プラグインを使用するには、有効な Gyro-n アカウントを所有し、Gyro-n SEO 管理画面のキキコミ VOC ページからクライアントトークンと API キーを取得する必要があります。
同梱されているサードパーティライブラリ
- Material Icons (Apache ライセンス 2.0)
- 提供元: Google LLC
- ソース: https://fonts.google.com/icons
- ライセンス: https://www.apache.org/licenses/LICENSE-2.0
- ファイル: assets/css/material-icons.css, assets/fonts/material-icons.woff2
サポート
ご質問や問題が発生した場合は、公式サイト (https://www.gyro-n.com/) より Gyro-n サポートへお問い合わせください。
ソースコード
assets/js/kikicomi-voc-card/ に配置されている JavaScript ファイル (type1.js 〜 type6.js) は、未軽量化 (unminified) のソースファイルです。ビルドプロセスは不要であり、ファイルはそのまま読み込まれます。
インストール
- WordPress 管理画面の「プラグイン」「プラグインの追加」を開き、「キキコミ VOC ウィジェット」を検索します。
- 「今すぐインストール」をクリックし、次に「有効化」をクリックします。
- 管理画面のサイドバーにある「キキコミ VOC」メニューへ移動します。
- Gyro-n SEO 管理画面のキキコミ VOC ページで取得した「クライアントトークン」と「API キー」を入力し、「変更を保存」をクリックします。
- クチコミウィジェットを表示したい投稿またはページの任意の場所に
[kikicomi_voc_widget]ショートコードを追加します。
FAQ
-
API キーとクライアントトークンはどこで入手できますか ?
-
Gyro-n SEO 管理画面にログインし、キキコミ VOC 「タグ設定」ページを開いてクライアントトークンと API キーを発行してください。
-
特定の店舗ごとに異なるウィジェットを表示できますか ?
-
はい。
[kikicomi_voc_widget site_id="1234"]のようにショートコードで店舗 ID を指定できます。 -
特定のアンケートごとに異なるウィジェットを表示できますか ?
-
はい。
[kikicomi_voc_widget survey_id="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"]のようにショートコードでアンケート ID を指定できます。 -
ウィジェットデータはどのくらいの頻度で更新されますか ?
-
高速なページ読み込みを確保するため、ウィジェットデータは1時間自動的にキャッシュされます。最新のクチコミレビューを今すぐ反映したい場合は、プラグイン設定ページの「キャッシュをクリア」をクリックしてください。
評価
このプラグインにはレビューがありません。
貢献者と開発者
変更履歴
1.0.0
- 初版公式リリース。
