PHPackages                             kiyoh/reviews - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. kiyoh/reviews

ActiveMagento2-module[Utility &amp; Helpers](/categories/utility)

kiyoh/reviews
=============

Kiyoh Reviews integration for Magento 2 - Shop and Product Reviews

v1.1.0(2mo ago)014↓70%proprietaryPHPPHP &gt;=7.2.0

Since Oct 17Pushed 1mo agoCompare

[ Source](https://github.com/Kiyoh-Klantenvertellen-plugins/Kiyoh-Magento-2-Plugin)[ Packagist](https://packagist.org/packages/kiyoh/reviews)[ RSS](/packages/kiyoh-reviews/feed)WikiDiscussions master Synced 4w ago

READMEChangelog (6)Dependencies (18)Versions (6)Used By (0)

Kiyoh Reviews - User Guide
==========================

[](#kiyoh-reviews---user-guide)

**Collect more reviews and boost your store's credibility with automated review requests**

What is Kiyoh Reviews?
----------------------

[](#what-is-kiyoh-reviews)

Kiyoh Reviews is a Magento 2 extension that automatically collects customer reviews for your store and products. It integrates seamlessly with Kiyoh and Klantenvertellen review platforms, helping you build trust and increase conversions.

Key Benefits
------------

[](#key-benefits)

✅ **Automated Review Collection**: Automatically send review requests after orders are completed
✅ **Product Reviews**: Collect reviews for specific products customers purchased
✅ **Perfect Timing**: Send review requests at the optimal time (e.g., 7 days after delivery)
✅ **Multi-Language**: Automatically detects customer language for personalized emails
✅ **Easy Setup**: Configure once and let it run automatically
✅ **Boost SEO**: Product reviews improve search engine rankings
✅ **Increase Trust**: Display ratings and reviews to build customer confidence

System Requirements
-------------------

[](#system-requirements)

### Minimum Requirements

[](#minimum-requirements)

- **Magento**: 2.3.0 or higher
- **PHP**: 7.2 or higher
- **Server Extensions**: cURL, JSON (usually pre-installed)

### Recommended for Best Performance

[](#recommended-for-best-performance)

- **Magento**: 2.4.6 or higher (LTS version)
- **PHP**: 8.1 or higher
- **SSL Certificate**: For secure API communication

### Compatibility

[](#compatibility)

The extension is compatible with:

- ✅ Magento Open Source 2.3.x and 2.4.x
- ✅ Adobe Commerce (Magento Commerce) 2.3.x and 2.4.x
- ✅ All standard Magento installations
- ✅ Multi-store and multi-website setups
- ✅ Cloud hosting and on-premise installations

**Note for older Magento installations:**

- Magento 2.3.x is supported but end-of-life (no security updates)
- We recommend upgrading to Magento 2.4.x for security and performance
- If you're on Magento 2.2.x or older, contact your technical team about upgrading

Getting Started
---------------

[](#getting-started)

### Step 1: Get Your API Credentials

[](#step-1-get-your-api-credentials)

Contact your Kiyoh or Klantenvertellen account manager to receive:

- Your Location ID
- Your API Token

Keep these credentials handy for the next step.

### Step 2: Install the Extension

[](#step-2-install-the-extension)

Your developer or technical team will install the extension. The installation process typically takes 5-10 minutes.

**Composer installation:**

1. Run `composer require kiyoh/reviews`
2. Run `php bin/magento setup:upgrade`
3. If the store is in production mode, run `php bin/magento setup:di:compile`
4. Clear cache with `php bin/magento cache:flush`

Once installed, you'll see a new "Kiyoh" section in your Magento admin panel under **Stores &gt; Configuration**.

**Compatibility Check:**If you're running an older version of Magento (2.3.x), ensure your PHP version is at least 7.2. Your technical team can verify this and upgrade if needed.

### Step 3: Configure the Extension

[](#step-3-configure-the-extension)

1. Log into your Magento admin panel
2. Go to **Stores &gt; Configuration**
3. Find **Kiyoh** in the left menu
4. Click **Reviews Configuration**

#### Enter Your API Credentials

[](#enter-your-api-credentials)

In the **API Settings** section:

- **Enable Kiyoh Reviews**: Set to **Yes**
- **Server**: Select your platform (e.g., klantenvertellen.nl)
- **Location ID**: Enter your Location ID
- **API Token**: Enter your API Token
- Click **Save Config**

The system will automatically verify your credentials when you save.

#### Configure Review Invitations

[](#configure-review-invitations)

In the **Review Invitations** section:

**Basic Settings:**

- **Enable Review Invitations**: Set to **Yes**
- **Invitation Type**: Choose what to request
    - **Shop + Product Reviews**: Ask for both store and product reviews (recommended)
    - **Product Reviews Only**: Only ask for product reviews
    - **Shop Reviews Only**: Only ask for store reviews (no product-specific reviews)
- **Order Status Trigger**: Select when to send invitations (usually "Complete")
- **Delay (Days)**: How many days to wait before sending (recommended: 7 days)

**Advanced Settings:**

- **Maximum Products Per Invitation**: How many products to include (recommended: 3-5)
    - Too many products can overwhelm customers
    - Focus on the most important items
- **Product Sort Order**: Choose how to prioritize products when multiple items are in an order
    - **Cart Order**: Use the order items appear in the cart (default)
    - **Price (High to Low)**: Prioritize expensive items first
    - **Price (Low to High)**: Prioritize cheaper items first
    - **Name (A to Z)**: Sort products alphabetically
    - **Name (Z to A)**: Sort products reverse alphabetically
    - **SKU (A to Z)**: Sort by product code alphabetically
    - **SKU (Z to A)**: Sort by product code reverse alphabetically
- **Fallback Language**: Default language if customer language can't be detected (e.g., "en" for English)

**Choosing the Right Invitation Type:**

- **Shop + Product Reviews**: Best for most stores - gives comprehensive feedback
- **Product Reviews Only**: Good for stores focused on product quality and SEO
- **Shop Reviews Only**: Ideal for service-based businesses or when you want to focus on overall customer experience

**Optional Filters:**

- **Exclude Customer Groups**: Skip certain customer groups (e.g., wholesale customers)
- **Exclude Product Attribute Sets**: Skip certain product types (e.g., gift cards)

Click **Save Config** when done.

#### Enable Product Synchronization

[](#enable-product-synchronization)

In the **Product Synchronization** section:

- **Enable Product Sync**: Set to **Yes**
- **Auto Sync on Product Changes**: Set to **Yes** (recommended)
    - This automatically updates product information when you edit products
- **Excluded Product Types**: Select product types you don't want to sync (optional)
    - Example: Virtual products, downloadable products
- **Excluded Product Codes**: Enter specific SKUs to exclude (optional)
    - Example: SAMPLE-001, TEST-SKU

**Initial Product Sync:**

- Important: first input your API key and Location ID and click save.
- Next click the **Bulk Product Sync** button to sync all existing products
- Do not leave the page while the sync is in progress
- This may take a few minutes depending on your catalog size
- You only need to do this once

Click **Save Config** when done.

How It Works
------------

[](#how-it-works)

### Automatic Review Requests

[](#automatic-review-requests)

Once configured, the extension works automatically:

1. **Customer Places Order**: A customer completes a purchase
2. **Order is Completed**: You mark the order as "Complete" (or your configured status)
3. **Waiting Period**: The system waits the configured delay (e.g., 7 days)
4. **Review Request Sent**: Customer receives an email from Kiyoh/Klantenvertellen
5. **Customer Leaves Review**: Customer clicks the link and writes a review
6. **Review Published**: Review appears on your Kiyoh profile and can be displayed on your website

### What Customers Receive

[](#what-customers-receive)

Customers receive a personalized email in their language with:

- A friendly greeting using their name
- A link to leave a review
- The products they purchased (with images) - if product reviews are enabled
- A simple rating system

**Note**: If you choose "Shop Reviews Only", customers will only be asked to review your store, not specific products. This is useful if you prefer to focus on overall service quality rather than individual product feedback.

Managing Reviews
----------------

[](#managing-reviews)

### Where to See Your Reviews

[](#where-to-see-your-reviews)

1. **Kiyoh Dashboard**: Log into your Kiyoh/Klantenvertellen account to see all reviews
2. **Email Notifications**: You'll receive email alerts for new reviews
3. **Magento Logs**: Your technical team can check logs for invitation status

### Responding to Reviews

[](#responding-to-reviews)

- Log into your Kiyoh/Klantenvertellen dashboard
- Navigate to the reviews section
- Click on a review to respond
- Your response appears publicly below the review

### Handling Negative Reviews

[](#handling-negative-reviews)

1. **Respond Quickly**: Address concerns within 24-48 hours
2. **Be Professional**: Stay calm and courteous
3. **Offer Solutions**: Provide ways to resolve the issue
4. **Take It Offline**: Invite them to contact you directly
5. **Learn and Improve**: Use feedback to improve your service

About This Extension
--------------------

[](#about-this-extension)

**Versioning**: Composer/Packagist releases follow Git tags
**Compatibility**: Magento 2.3.0+ and PHP 7.2+
**Developer**: Kiyoh
**License**: Proprietary
**Last Updated**: October 2025

---

*This extension is part of your Kiyoh/Klantenvertellen subscription. For questions about your subscription, pricing, or additional features, contact your account manager.*

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance87

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~45 days

Total

5

Last Release

75d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b0a2d52e62ac73f6ef77d3cfd5146a1ab94a3d5d113669adcd0234f66edf6ae5?d=identicon)[Dolphin-ZAAZ](/maintainers/Dolphin-ZAAZ)

---

Top Contributors

[![Dolphin-ZAAZ](https://avatars.githubusercontent.com/u/141278240?v=4)](https://github.com/Dolphin-ZAAZ "Dolphin-ZAAZ (20 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/kiyoh-reviews/health.svg)

```
[![Health](https://phpackages.com/badges/kiyoh-reviews/health.svg)](https://phpackages.com/packages/kiyoh-reviews)
```

###  Alternatives

[mollie/magento2

Mollie Payment Module for Magento 2

1131.9M16](/packages/mollie-magento2)[loki/magento2-components

Core module for defining Alpine.js components with advanced AJAX features

1011.8k23](/packages/loki-magento2-components)[run-as-root/magento2-prometheus-exporter

Magento2 Prometheus Exporter

68357.9k](/packages/run-as-root-magento2-prometheus-exporter)[buckaroo/magento2

Buckaroo Magento 2 extension

32420.3k7](/packages/buckaroo-magento2)[mage-os/module-inventory-reservations-grid

Add a grid with the list of inventory reservations.

1615.9k](/packages/mage-os-module-inventory-reservations-grid)[angeo/module-llms-txt

Magento 2 module for AI Engine Optimization (AEO). Generates spec-compliant llms.txt and llms-full.txt per llmstxt.org standard, plus streaming JSONL for vector indexing. Multi-store, multi-website, CLI, cron, async admin UI, Page Builder-aware sanitization, customer-group pricing, atomic writes, ETag/Cache-Control, .md mirrors.

111.1k](/packages/angeo-module-llms-txt)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
