Hao Nguyen

Init Review System adds a clean and customizable 5-star rating system to your WordPress site. Votes are stored via REST API, tracked with <code>localStorage</code>, and the average score is auto-calculated and optionally displayed with schema markup.
Built to be lightweight, developer-friendly, and easy to integrate into any theme or custom UI. Now with multi-criteria reviews and an emoji reactions system for richer user interaction.
This plugin is part of the <a href="https://en.inithtml.com/init-plugin-suite-minimalist-powerful-and-free-wordpress-plugins/" rel="nofollow ugc">Init Plugin Suite</a> — a collection of minimalist, fast, and developer-focused tools for WordPress.
GitHub repository: <a href="https://github.com/brokensmile2103/init-review-system" rel="nofollow ugc">https://github.com/brokensmile2103/init-review-system</a>
Highlights:
<ul>
<li>5-star voting via frontend</li>
<li>NEW: Multi-criteria review support</li>
<li>NEW: Emoji Reactions with Login Enforcement</li>
<li>Average score display</li>
<li>Optional login requirement</li>
<li>Optional strict IP checking</li>
<li>REST API for vote submission</li>
<li>JSON-LD schema for SEO</li>
<li>Works with any post type</li>
<li>Minimal, theme-friendly UI</li>
</ul>
<h3>Features</h3>
<ul>
<li>5-star rating system</li>
<li>Multi-criteria review scoring (up to 5 custom criteria)</li>
<li>Emoji-based reactions bar with live counts (requires login)</li>
<li>REST API endpoint for reactions: <code>/wp-json/initrsys/v1/reactions/toggle</code></li>
<li>Reactions stored in both post meta and dedicated user↔post mapping table</li>
<li>Accessibility-ready with <code>aria-pressed</code> + <code>aria-live</code> updates</li>
<li>Shortcode-based integration</li>
<li>Auto-insert blocks before/after content or comments</li>
<li>Optional login + IP check to prevent abuse</li>
<li>REST API endpoint: <code>/wp-json/initrsys/v1/vote</code></li>
<li>Developer filters and extensible architecture</li>
<li>No jQuery, only minimal assets loaded when needed</li>
</ul>
<h3>Usage</h3>
<h3>[init_review_system]</h3>
Displays interactive 5-star voting block.
Attributes: 
– <code>id</code>: Post ID (default: current post) 
– <code>class</code>: Custom CSS class 
– <code>schema</code>: <code>true|false</code> – Output JSON-LD schema markup
<h3>[init_review_score]</h3>
Displays average score (read-only).
Attributes: 
– <code>id</code>: Post ID (default: current post) 
– <code>icon</code>: <code>true|false</code> – Show star icon (default: false) 
– <code>sub</code>: <code>true|false</code> – Show <code>/5</code> subtext (default: true) 
– <code>class</code>: Custom CSS class 
– <code>hide_if_empty</code>: <code>true|false</code> – Hide if no reviews (default: false)
<h3>[init_review_criteria]</h3>
Displays multi-criteria review block.
Attributes: 
– <code>id</code>: Post ID (default: current post) 
– <code>class</code>: Custom CSS class 
– <code>schema</code>: <code>true|false</code> – Output schema markup (default: false) 
– <code>per_page</code>: Number of reviews to show (default: 0 = all) 
– <code>paged</code>: Current review page number (default: 1)
<h3>[init_reactions]</h3>
Displays emoji reactions bar under a post.
Attributes: 
– <code>id</code>: Post ID (default: current post) 
– <code>class</code>: Custom CSS class 
– <code>require_login</code>: Always true (login required)
<h3>Filters for Developers</h3>
This plugin provides filters and actions to let developers customize auto-insert behavior, schema output, review permissions, and REST API logic.
<code>init_plugin_suite_review_system_auto_insert_enabled_score</code> 
Enable or disable automatic score output (before/after content). 
Applies to: Frontend filter 
Params: <code>bool $enabled</code>, <code>string $position</code>, <code>string $post_type</code>
<code>init_plugin_suite_review_system_auto_insert_enabled_vote</code> 
Enable or disable automatic voting block insertion. 
Applies to: Frontend filter 
Params: <code>bool $enabled</code>, <code>string $position</code>, <code>string $post_type</code>
<code>init_plugin_suite_review_system_default_score_shortcode</code> 
Change the default shortcode used for score auto-insertion. 
Applies to: Frontend 
Params: <code>string $shortcode</code>
<code>init_plugin_suite_review_system_default_vote_shortcode</code> 
Change the default shortcode used for voting block auto-insertion. 
Applies to: Frontend 
Params: <code>string $shortcode</code>
<code>init_plugin_suite_review_system_require_login</code> 
Force login for submitting reviews, even if disabled in settings. 
Applies to: REST <code>/submit-criteria-review</code> 
Params: <code>bool $require_login</code>
<code>init_plugin_suite_review_system_min_len_for_ws_check</code> 
Adjust minimum length threshold for triggering no-whitespace check. 
Applies to: Backend + JS precheck 
Params: <code>int $threshold</code> (default <code>20</code>)
<code>init_plugin_suite_review_system_repetition_threshold</code> 
Adjust repetition threshold for detecting excessive word repetition. 
Applies to: Backend + JS precheck 
Params: <code>int $threshold</code> (default <code>8</code>)
<code>init_plugin_suite_review_system_schema_type</code> 
Customize schema.org type (e.g., <code>Book</code>, <code>Product</code>, <code>Course</code>). 
Applies to: Shortcode output 
Params: <code>string $type</code>, <code>string $post_type</code>
<code>init_plugin_suite_review_system_schema_data</code> 
Modify JSON-LD schema output array. 
Applies to: Shortcode output 
Params: <code>array $data</code>, <code>int $post_id</code>, <code>string $schema_type</code>
<code>init_plugin_suite_review_system_after_vote</code> 
Run custom logic after a single-star vote is submitted. 
Applies to: REST <code>/vote</code> 
Params: <code>int $post_id</code>, <code>float $score</code>, <code>float $avg_score</code>, <code>int $total_votes</code>
<code>init_plugin_suite_review_system_after_criteria_review</code> 
Trigger custom logic after a multi-criteria review is submitted. 
Applies to: REST <code>/submit-criteria-review</code> 
Params: <code>int $post_id</code>, <code>int $user_id</code>, <code>float $avg_score</code>, <code>string $review_content</code>, <code>array $scores</code>
<code>init_plugin_suite_review_system_get_reaction_types</code> 
Customize available reaction types (labels + emojis). 
Applies to: Reactions system 
Params: <code>array $types</code>
<code>init_plugin_suite_review_system_reaction_meta_key</code> 
Customize the meta key used for storing reaction counts. 
Applies to: Reaction counts storage 
Params: <code>string $meta_key</code>, <code>string $rx_key</code>
<h3>License</h3>
This plugin is licensed under the GPLv2 or later. 
You are free to use, modify, and distribute it under the same license.

Init Review System – Reactions, Multi-Criteria, Guest-Friendly

Fast 5-star rating plugin with schema, REST API, shortcode control, localStorage voting. Now with multi-criteria review support.

Init Review System – Reactions, Multi-Criteria, Guest-Friendly vs ReviewX – WooCommerce Product Reviews with Multi-Criteria, Reminder Emails, Google Reviews, Schema & More