| 开发者 | universalwp |
|---|---|
| 更新时间 | 2026年10月16日 14:41 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
universal-reviews plugin ZIP.universal-reviews.zip file.universal-reviews folder./wp-content/plugins/.[unirev_reviews show_form=1]
This displays the review list and enables the form for the current supported target.
Using Elementor? Edit the page, search the widget panel for Reviews List or Review Form, and drag it where you want it.
Requirements: WordPress 6.2 or newer and PHP 7.4 or newer. WooCommerce and Elementor are optional.
Deactivation and uninstall
Deactivating Universal Reviews does not remove review data.
By default, database tables and settings remain available after deactivation. If you want WordPress to remove the plugin's stored data during uninstall, enable Settings → Privacy → Delete all data on uninstall before deleting the plugin.
Use this option carefully because uninstall data deletion is intended to be permanent.
Use-Case Packs
Use-Case Packs set up a whole review workflow in one click. Open Reviews → Use-Case Packs, pick a pack, check the preview and press Apply pack.
[unirev_reviews preset="restaurant"].unirev_use_case_packs filter, or answer the purchase check with unirev_customer_bought_product.https://your-site.example/wp-admin/admin-post.php?action=unirev_google_oauth).[unirev_google_reviews] shortcode, the Google Reviews block or the Elementor widget. Free includes the Classic list; Pro adds grid, carousel, design styles, star colour, autoplay, the rating filter and multiple locations (connection="ID").[unirev_google_reviews]
Optional attributes: connection (location ID, Pro), per_page (1–50), layout (list; grid and carousel need Pro), columns (2–4, grid and carousel), card_style (design style, see below), autoplay (carousel only, 0–15 seconds, 0 = off), min_rating, show_summary, show_name, show_date, show_text, load_more (each 1 or 0), filter (rating filter, needs Pro).
Design styles for card_style (Classic is free, the rest need Pro): default (Classic), aurora (dark glass), candy (playful pastel), soft (neumorphic) and editorial (serif, numbered, dark featured first review). Classic also accepts the finishes shadow, flat and accent. Every style works in the list, grid and carousel layouts. The carousel has arrow buttons, page dots, drag, arrow keys and optional autoplay that pauses on hover and for visitors who prefer reduced motion.
Examples: [unirev_google_reviews per_page="6" show_date="0"] and [unirev_google_reviews layout="carousel" card_style="aurora" columns="3" autoplay="5"]
Review form
[unirev_form]
Default attributes:
slug — Form slug. Default: unirev_form.type — Review type. Default: product.target_type — Target type. Default: post.target_id — Target ID. Defaults to the current supported post when available.[unirev_form type="product" target_type="post" target_id="123"]
Review list
[unirev_reviews]
Available attributes:
typetarget_typetarget_idper_pagesortmin_ratingallow_rating_filtershow_formpreset — a saved display preset (for example one created by a Use-Case Pack). It supplies defaults for per_page, sort, allow_rating_filter, show_form and the helpful-vote button; any attribute you write still wins.[unirev_reviews type="product" target_type="post" target_id="123" per_page="10" show_form="1"]
Rating summary
[unirev_summary]
Available attributes:
typetarget_typetarget_id[unirev_summary type="product" target_type="post" target_id="123"]
Supported target types include:
post — WordPress posts and supported post types.product — WooCommerce products.term — taxonomy terms.user — users.business — the business/site target.unirev/reviews-list
Attributes:
reviewTypetargetTypetargetIdperPagesortminRatingallowRatingFilterunirev/review-form
Attributes:
formSlugreviewTypetargetTypetargetIdunirev/google-reviews
Attributes: connection, perPage, layout, columns, cardStyle, autoplay, minRating, showSummary, showName, showDate, showText, loadMore, filter.
All blocks are server-rendered.No. WooCommerce is not required.
Reviews can target WordPress posts and custom post types, taxonomy terms, users, the site/business and other supported targets. WooCommerce products are supported as the product post type.
Universal Reviews does not read WooCommerce orders for purchase verification. A moderator can mark a review as verified from the Reviews screen, and developers can add their own verification logic through the unirev_verification_providers filter.
Yes. The post target type can work with WordPress post types, including custom post types, when the target is public and supported by the plugin's target validation.
Yes. There are Elementor widgets for the Review Form, the Reviews List and (since 1.1.0) Google Reviews. Drag them onto any Elementor page, template or product layout. They share the same forms, review types and moderation queue as the blocks and shortcodes.
Yes. Elementor is optional. Universal Reviews also works with the WordPress block editor and with shortcodes, and you don't need a special theme.
Add [unirev_reviews show_form=1] to the page, insert the Reviews List block, or drop in the Reviews List widget in Elementor. Visitors will see the rating summary, the approved reviews and the review form.
WooCommerce products are supported as a review target. Add the shortcode, block or Elementor widget to your product description, product template or product layout. Universal Reviews doesn't take over the built-in WooCommerce reviews tab.
Yes. Reviewers can attach JPEG, PNG, WebP or AVIF photos, and you control the size and number of photos. SVG uploads are never accepted. Photos that can't be verified as real images are rejected, and photos are deleted when a review is rejected or marked as spam.
Yes. Use the business target type to collect reviews about your company as a whole, then show them anywhere with the same widgets, blocks and shortcodes.
Yes. The form builder supports multiple field types, required fields, half-width layouts, placeholders, help text, headings, text blocks and custom CSS classes. Form styling uses --unirev-* CSS variables.
Yes. Forms can be created and managed from Reviews → Forms. Forms can be associated with supported review types and embedded with the form shortcode or Review Form block.
Yes, since version 1.0.1. Choose Half stars under Star steps when editing a review type in Reviews → Review Types. Types default to whole stars (1 to 5).
Not by default. IP storage is disabled by default and can be enabled from the privacy settings when a site needs it.
Deactivation does not delete reviews, settings or database tables. Data is removed during uninstall only when Delete all data on uninstall has been enabled in Settings → Privacy.
No. Universal Reviews does not require Redis or Memcached. Rating aggregates are precomputed in a summary table. A persistent object cache can further reduce repeated public queries when available.
When enabled, Universal Reviews can output AggregateRating JSON-LD for supported targets whose review list or summary is actually displayed and which have approved reviews. Structured data eligibility does not guarantee a search-engine rich result.
No. The plugin outputs supported structured data according to its configuration and visible review content, but search engines independently decide whether structured data qualifies for or appears as a rich result.
Yes. Titles, names, answers and avatar initials are cut on character boundaries, so non-Latin text and emoji are no longer corrupted.
Yes. Moderators with the appropriate capability can add owner replies. Replies are displayed beneath the review on the front end.
A pack is a complete, ready-to-use review setup for one kind of business. Instead of building a form and tuning settings yourself, you pick a pack, look at a preview, and press Apply. It creates a review type, a form with smart follow-up questions, moderation and alert defaults, and a saved display preset you use as preset="…".
No. The preview shows what will be created, changed or left alone before anything is saved. If a review type or form with the same name already exists, the pack creates its own copy with a numbered name and leaves yours alone. Site-wide settings are only touched if you tick "Also use the pack's display defaults for the whole site". Everything a pack creates can be undone; a review type that already has reviews is kept, so no review is ever orphaned.
Restaurants & cafés and WooCommerce stores are included in Free. Clinics & healthcare, Courses & training, Agencies & freelancers and Rental properties are part of Pro. Free shows the Pro packs as locked cards.
A smart field appears only when an earlier answer matches, for example a delivery question after someone chooses Delivery. Free allows one condition per field; Pro allows several, with "all" or "any" matching. Rating, name, email, headline, review text and consent are always shown. The check also runs on the server, so a field hidden by its rule is never stored, even if a request tries to send it.
Never. The alert only emails you, through the background queue, so you can reply quickly. The review is published or held exactly as the review type says. The email contains the rating, the review type and a link to your dashboard, but no review text and no reviewer details.
It is off by default. When you switch it on for a review type, Universal Reviews asks WooCommerce a yes-or-no question: has this customer bought this product? A reviewer who is logged in is checked by their own account, not by the email typed into the form. Nothing about the order is stored; the only result is the existing "verified" badge. Publishing verified buyers without approval is a separate, optional choice.
No. Google Reviews is optional. Nothing contacts Google unless you set it up.
Google's Business Profile API terms require each business to use its own approved project. Universal Reviews therefore never shares one project between sites: you create the OAuth client, and you authorize access to your own Business Profile.
Business Profile API access must be requested from Google and approved (the quota for the APIs shows 0 until it is). Then enable the "My Business Account Management API", "My Business Business Information API" and "Google My Business API" in your project. The plugin shows the exact problem and a recommended action, with technical details you can send to support.
Google no longer accepts the saved authorization, usually because access was revoked, the password changed, or the account lost access to the location. Click Reconnect Google.
The Free plan displays up to 50 recent reviews. Your connection keeps working and the rest are not deleted from Google.
Classic (a clean list that follows your theme) is free. Aurora, Candy, Soft and Editorial, the grid and carousel layouts, and autoplay need Pro. On a Free site a Pro style or layout falls back to the Classic list, so a page never breaks.
No. They are a temporary copy kept for at most 30 days and refreshed daily. Disconnecting deletes them immediately.
Your server must be able to make outgoing HTTPS requests to Google (*.googleapis.com and accounts.google.com). Ask your host to allow them, then press Try Again. If you connected the wrong account in the meantime, use Change Google account.
Universal Reviews integrates with the WordPress privacy exporter and eraser. Personal information such as reviewer name, email and stored IP data can be anonymised while the review text remains as a business record.
The admin dashboard (assets/admin/index.js and assets/admin/index.css) is compiled from the human-readable TypeScript/React source in the admin-src/ folder, which ships inside the plugin. To rebuild it, run npm install and then npm run build in the plugin folder (esbuild bundles the JavaScript and the Tailwind CLI builds the CSS; see admin-src/README.md). The bundle includes React, React DOM, Radix UI, lucide-react, class-variance-authority, clsx and tailwind-merge, all under MIT-compatible licences. The front-end scripts (assets/admin/frontend.js and assets/admin/google-reviews.js), the front-end stylesheets, the block editor scripts (blocks/*/edit.js) and the PHP are not minified.
unirev_trusted_proxies filter.[unirev_reviews preset="restaurant"] supplies saved list defaults; an explicit attribute still wins.settings column to the review types table. It updates automatically on first load.
= 1.1.1 = 08 Oct 2026
card_style, the block "Design style" control, the Elementor widget or Reviews → Google Reviews → Display, which now has a visual style picker.[unirev_google_reviews] shortcode, Google Reviews block and Google Reviews Elementor widget..htaccess protection doesn't apply there.@id, merges multiple reviewed items into one @graph, an allow-list of valid types (filter unirev_schema_types) and a unirev_schema_output filter to avoid duplicates with WooCommerce or SEO plugins.[unirev_form], [unirev_reviews] and [unirev_summary] shortcodes.