キキコミ VOC ウィジェット

説明

「キキコミ 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) のソースファイルです。ビルドプロセスは不要であり、ファイルはそのまま読み込まれます。

インストール

  1. WordPress 管理画面の「プラグイン」「プラグインの追加」を開き、「キキコミ VOC ウィジェット」を検索します。
  2. 「今すぐインストール」をクリックし、次に「有効化」をクリックします。
  3. 管理画面のサイドバーにある「キキコミ VOC」メニューへ移動します。
  4. Gyro-n SEO 管理画面のキキコミ VOC ページで取得した「クライアントトークン」と「API キー」を入力し、「変更を保存」をクリックします。
  5. クチコミウィジェットを表示したい投稿またはページの任意の場所に [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時間自動的にキャッシュされます。最新のクチコミレビューを今すぐ反映したい場合は、プラグイン設定ページの「キャッシュをクリア」をクリックしてください。

評価

このプラグインにはレビューがありません。

貢献者と開発者

キキコミ VOC ウィジェット はオープンソースソフトウェアです。以下の人々がこのプラグインに貢献しています。

貢献者

“キキコミ VOC ウィジェット” は1ロケールに翻訳されています。 翻訳者のみなさん、翻訳へのご協力ありがとうございます。

“キキコミ VOC ウィジェット” をあなたの言語に翻訳しましょう。

開発に興味がありますか ?

コードを閲覧するか、SVN リポジトリをチェックするか、開発ログを RSS で購読してみてください。

変更履歴

1.0.0

  • 初版公式リリース。