Kikicomi VOC Widget

Description

The “Kikicomi VOC Widget” plugin allows you to beautifully display survey results and customer reviews collected via “Kikicomi VOC” by Gyro-n on any page of your WordPress site.

By simply placing a shortcode, aggregated review widgets and JSON-LD structured data for search engines are automatically embedded, enhancing your site’s SEO performance.

Key Features

  • Easy Setup: Display the review widget anywhere on pages or posts by adding the [kikicomi_voc_widget] shortcode.
  • Store & Survey Filtering: Specify Store ID (site_id) or Survey ID (survey_id) to display widgets for specific stores or surveys.
  • Automatic Insertion: Automatically insert the widget at the end of post/page content by specifying page IDs in the settings without manually editing content.
  • Automated SEO Structured Data: Automatically outputs JSON-LD structured data in <head> for search engines like Google.
  • High Performance Caching: Uses WordPress Transients API for caching to achieve fast page loads and minimize server load.

Third-Party Services

This plugin connects to external 3rd-party services to provide its core functionality:

  • Gyro-n Kikicomi VOC API
    • Service Provider: 株式会社ジャイロン(Gyro-n)
    • Service URL: https://www.gyro-n.com/
    • API Endpoint: https://seo.gyro-n.com/api/survey_voc/review_widget
    • Terms of Service: https://www.gyro-n.com/home/termsofuse/
    • Privacy Policy: https://www.gyro-n.com/home/privacypolicy/
    • Purpose: To retrieve widget data, the plugin sends the following information from your WordPress server to the Kikicomi VOC API: your Client Token, API Key, and the specified site_id and survey_id (if provided). These requests are performed server-side and are not made directly from the site visitor’s browser. In response, the API may return review-related information such as review text, ratings, display names, dates, store/location information, and other review metadata configured in Kikicomi VOC. The plugin temporarily stores API response data in WordPress Transients for up to 1 hour for caching purposes. To use this plugin, you must have an active Gyro-n account and obtain a Client Token and API Key from the Kikicomi VOC dashboard.

Bundled Third-Party Libraries

  • Material Icons (Apache License 2.0)
    • Provider: Google LLC
    • Source: https://fonts.google.com/icons
    • License: https://www.apache.org/licenses/LICENSE-2.0
    • Files: assets/css/material-icons.css, assets/fonts/material-icons.woff2

Support

For questions or issues, please contact Gyro-n support via the official website: https://www.gyro-n.com/

Source Code

The JavaScript files located in assets/js/kikicomi-voc-card/ (type1.js through type6.js) are unminified source files. No build process is required; the files are included as-is.

Installation

  1. In your WordPress admin dashboard, navigate to “Plugins” -> “Add New Plugin” and search for “Kikicomi VOC Widget”.
  2. Click “Install Now” and then “Activate”.
  3. Go to the “Kikicomi VOC” menu in the admin sidebar.
  4. Enter your “Client Token” and “API Key” obtained from the Kikicomi VOC page in the Gyro-n SEO management dashboard, then click “Save Changes”.
  5. Add the [kikicomi_voc_widget] shortcode to any post or page where you want to display the review widget.

FAQ

Where can I get an API Key and Client Token?

Log in to the Gyro-n SEO management dashboard, navigate to Kikicomi VOC -> “Tag Installation” page to find and issue your Client Token and API Key.

Can I display different widgets for specific stores?

Yes. You can specify a store ID in the shortcode like [kikicomi_voc_widget site_id="1234"].

Can I display different widgets for specific surveys?

Yes. You can specify a survey ID in the shortcode like [kikicomi_voc_widget survey_id="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"].

How often is the widget data updated?

Widget data is automatically cached for 1 hour to ensure fast page loads. If you want to reflect the latest VOC reviews immediately, click “Clear Cache” in the plugin settings page.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Kikicomi VOC Widget” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Kikicomi VOC Widget” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0.0

  • Initial official release.