內容簡介
Init Review System 為 WordPress 網站提供輕量且可自訂的五星評分系統，支援多條件評分與表情符號反應功能，透過 REST API 儲存投票資料並自動計算平均分數，同時可輸出 JSON-LD 結構化標記以提升 SEO 表現。
【主要功能】
• 前台五星評分與平均分數即時顯示
• 多條件評分，最多可設定 5 項自訂評分標準
• 表情符號反應列，支援即時計數與登入驗證
• REST API 投票與反應端點，架構易於擴充
• 可選登入限制與 IP 檢查，防止濫用灌票
• JSON-LD 結構化標記輸出，強化搜尋引擎優化
外掛標籤
開發者團隊
② 後台搜尋「Init Review System – Reactions, Multi-Criteria, Guest-Friendly」→ 直接安裝（推薦）
原文外掛簡介
Init Review System adds a clean and customizable 5-star rating system to your WordPress site. Votes are stored via REST API, tracked with localStorage, 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 Init Plugin Suite — a collection of minimalist, fast, and developer-focused tools for WordPress.
GitHub repository: https://github.com/brokensmile2103/init-review-system
Highlights:
5-star voting via frontend
NEW: Multi-criteria review support
NEW: Emoji Reactions with Login Enforcement
Average score display
Optional login requirement
Optional strict IP checking
REST API for vote submission
JSON-LD schema for SEO
Works with any post type
Minimal, theme-friendly UI
Features
5-star rating system
Multi-criteria review scoring (up to 5 custom criteria)
Emoji-based reactions bar with live counts (requires login)
REST API endpoint for reactions: /wp-json/initrsys/v1/reactions/toggle
Reactions stored in both post meta and dedicated user↔post mapping table
Accessibility-ready with aria-pressed + aria-live updates
Shortcode-based integration
Auto-insert blocks before/after content or comments
Optional login + IP check to prevent abuse
REST API endpoint: /wp-json/initrsys/v1/vote
Developer filters and extensible architecture
No jQuery, only minimal assets loaded when needed
Usage
[init_review_system]
Displays interactive 5-star voting block.
Attributes:
– id: Post ID (default: current post)
– class: Custom CSS class
– schema: true|false – Output JSON-LD schema markup
[init_review_score]
Displays average score (read-only).
Attributes:
– id: Post ID (default: current post)
– icon: true|false – Show star icon (default: false)
– sub: true|false – Show /5 subtext (default: true)
– class: Custom CSS class
– hide_if_empty: true|false – Hide if no reviews (default: false)
[init_review_criteria]
Displays multi-criteria review block.
Attributes:
– id: Post ID (default: current post)
– class: Custom CSS class
– schema: true|false – Output schema markup (default: false)
– per_page: Number of reviews to show (default: 0 = all)
– paged: Current review page number (default: 1)
[init_reactions]
Displays emoji reactions bar under a post.
Attributes:
– id: Post ID (default: current post)
– class: Custom CSS class
– require_login: Always true (login required)
Filters for Developers
This plugin provides filters and actions to let developers customize auto-insert behavior, schema output, review permissions, and REST API logic.
init_plugin_suite_review_system_auto_insert_enabled_score
Enable or disable automatic score output (before/after content).
Applies to: Frontend filter
Params: bool $enabled, string $position, string $post_type
init_plugin_suite_review_system_auto_insert_enabled_vote
Enable or disable automatic voting block insertion.
Applies to: Frontend filter
Params: bool $enabled, string $position, string $post_type
init_plugin_suite_review_system_default_score_shortcode
Change the default shortcode used for score auto-insertion.
Applies to: Frontend
Params: string $shortcode
init_plugin_suite_review_system_default_vote_shortcode
Change the default shortcode used for voting block auto-insertion.
Applies to: Frontend
Params: string $shortcode
init_plugin_suite_review_system_require_login
Force login for submitting reviews, even if disabled in settings.
Applies to: REST /submit-criteria-review
Params: bool $require_login
init_plugin_suite_review_system_min_len_for_ws_check
Adjust minimum length threshold for triggering no-whitespace check.
Applies to: Backend + JS precheck
Params: int $threshold (default 20)
init_plugin_suite_review_system_repetition_threshold
Adjust repetition threshold for detecting excessive word repetition.
Applies to: Backend + JS precheck
Params: int $threshold (default 8)
init_plugin_suite_review_system_schema_type
Customize schema.org type (e.g., Book, Product, Course).
Applies to: Shortcode output
Params: string $type, string $post_type
init_plugin_suite_review_system_schema_data
Modify JSON-LD schema output array.
Applies to: Shortcode output
Params: array $data, int $post_id, string $schema_type
init_plugin_suite_review_system_after_vote
Run custom logic after a single-star vote is submitted.
Applies to: REST /vote
Params: int $post_id, float $score, float $avg_score, int $total_votes
init_plugin_suite_review_system_after_criteria_review
Trigger custom logic after a multi-criteria review is submitted.
Applies to: REST /submit-criteria-review
Params: int $post_id, int $user_id, float $avg_score, string $review_content, array $scores
init_plugin_suite_review_system_get_reaction_types
Customize available reaction types (labels + emojis).
Applies to: Reactions system
Params: array $types
init_plugin_suite_review_system_reaction_meta_key
Customize the meta key used for storing reaction counts.
Applies to: Reaction counts storage
Params: string $meta_key, string $rx_key
init_plugin_suite_review_system_ttl
Set TTL (in seconds) for object cache on review queries. Defaults to 0 (cache disabled). Set a value greater than 0 to enable caching via wp_cache_set with group init_review_system.
Applies to: REST get reviews, get total reviews
Params: int $ttl (default 0)
License
This plugin is licensed under the GPLv2 or later.
You are free to use, modify, and distribute it under the same license.
