Site Reviews

Description

ATTENTION: This plugin requires your server to be running a minimum of PHP v5.4 and WordPress 4.0.0. The plugin will NOT work If your server does not meet these minimum requirements.

Site Reviews is a plugin that allows your visitors to submit site reviews with a 1-5 star rating on your website, similar to the way you would on TripAdvisor or Yelp, and then allows you to display them using a widget or shortcode.

You can pin your best reviews so that they are always shown first, require approval before new review submissions are published, require visitors to be logged-in in order to write a review, send custom notifications on a new submission, and more. The plugin provides both widgets and shortcodes along with full shortcode documentation.

Add-ons are being developed to support syncing your TripAdvisor and Yelp reviews in order to display them locally on your website, as well as Post/Page/CPT/Comment ratings/reviews.

The plugin roadmap includes tentative upcoming features.

Follow plugin development on github at: https://github.com/geminilabs/site-reviews/

Current Features

  • [new] Review blacklist
  • Actively developed and supported
  • Ajax pagination of reviews
  • Akismet integration to provide spam-validation
  • Assign reviews to a Post/Page ID
  • Autocomplete AssignedTo metabox
  • Bayesian ranking for posts with assigned reviews (can be used for WP_Query sorting)
  • Clean and easy-to-configure user interface
  • Configurable Widgets
  • Custom notifications (including Slack support)
  • Easy setup and implementation
  • Filter reviews by rating
  • Helper functions to easily access review meta
  • Honeypot (spam trap) implemented in the submission form
  • Logging
  • MCE shortcode button dropdown
  • Minimal widget styling (tested with all official WP themes)
  • Publicly respond to a review
  • Relative dates option
  • Review avatars (gravatar.com)
  • Review categories
  • Review pagination
  • Reviews Summary shortcode: [site_reviews_summary]
  • Rich snippets for reviews (schema.org)
  • Shortcodes: Display reviews in your post content and templates
  • Translate any plugin text
  • Use Google’s Invisible reCAPTCHA on submission forms
  • WordPress.org support
  • WP Filter Hooks

Screenshots

  • A view of the All Reviews page

  • A view of the Edit Review page

  • A view of the MCE shortcode dropdown button

  • A view of the Site Reviews > Settings > General page

  • A view of the Site Reviews > Settings > Translations page

  • A view of the Site Reviews > Get Help > Documentation tab

  • A view of the Site Reviews > Get Help > System Info tab

  • A view of the Recent Site Reviews widget settings

  • A view of the Submit a Site Review widget settings

  • How the Recent Site Reviews widget/shortcode looks like using the Twenty Sixteen WordPress theme

  • How the Submit a Site Review widget/shortcode looks like using the Twenty Sixteen WordPress theme

  • How the Site Reviews Summary shortcode looks like using the Twenty Sixteen WordPress theme

  • How the Slack notifications look like

  • Add-Ons are being built to extend the functionality on the Site Reviews plugin

Installation

Minimum plugin requirements

  • WordPress 4.0.0
  • PHP 5.4

Automatic installation

Log in to your WordPress dashboard, navigate to the Plugins menu and click “Add New”.

In the search field type “Site Reviews” and click Search Plugins. Once you have found the plugin you can view details about it such as the point release, rating and description. You can install it by simply clicking “Install Now”.

Manual installation

Download the Site Reviews plugin and uploading it to your server via your favorite FTP application. The WordPress codex contains instructions on how to do this here.

FAQ

Installation Instructions

Minimum plugin requirements

  • WordPress 4.0.0
  • PHP 5.4

Automatic installation

Log in to your WordPress dashboard, navigate to the Plugins menu and click “Add New”.

In the search field type “Site Reviews” and click Search Plugins. Once you have found the plugin you can view details about it such as the point release, rating and description. You can install it by simply clicking “Install Now”.

Manual installation

Download the Site Reviews plugin and uploading it to your server via your favorite FTP application. The WordPress codex contains instructions on how to do this here.

How do I use Site Reviews?

Please watch the Getting Started with Site Reviews Screencast for a quick step-by-step visual on how to get started with Site Reviews.

How do I send you a translation of Site Reviews in my language?

It’s super easy to contribute a translation in your language.

  1. https://translate.wordpress.org/projects/wp-plugins/site-reviews/dev
  2. Select your language
  3. Suggest translations!
How do I change the order of the Submission Form fields?

https://github.com/geminilabs/site-reviews/wiki/Custom-Submission-Form-Field-Order

How do I change the order of the review content?

https://github.com/geminilabs/site-reviews/wiki/How-to-change-the-order-of-the-parts-of-a-rendered-review

How do I customise the JSON–LD schema of Site Reviews?

https://github.com/geminilabs/site-reviews/wiki/How-to-add-additional-values-to-Site-Reviews-JSON%E2%80%93LD-schema

How do I disable the star rating on the submission form?

https://github.com/geminilabs/site-reviews/wiki/How-to-disable-the-star-rating-on-the-submission-form

How do I limit review submissions to one review per email?

https://github.com/geminilabs/site-reviews/wiki/How-to-limit-review-submissions-to-one-review-per-email

How to query and sort pages with assigned reviews by their overall score?

https://github.com/geminilabs/site-reviews/wiki/How-to-query-and-sort-posts-pages-that-have-assigned-reviews-by-their-ranking

I need help with something else

All documentation can be found in the “Get Help” page of the plugin. You can also visit the Site Reviews Wiki for tips on advanced usage.

Reviews

Perfect plugin!

I highly recommend this awesome plugin not only for its state-of-the-art technology but also kind and cooperative Author! Many thanks. Keep up the good work.

Awesome!

Very easy, simply customizable and powerful plugin. Really the best one you could use.

Awesome plugin

This plugin is the most useful one I’ve ever used in my WP life.That’s not an exaggeration.You can get whatever you want for reviews function really easily on your website.I still can’t believe this is for free.What’s more,the author is way too nice and kind.I asked him some questions about some functions(I might be a little bit nurve)via E-mail,then he replied to me soon and solved my problems so easily.Thank you so much.Highly recommeded

Great plugin, great support!

This plugin was the exact thing that I needed to review specific posts on my website. I was able to really push the limits of the plugin too, to use it to its full potential, integrating it with another plugin on my website ‘Essential Grids’. I got stuck once or twice, not knowing how to make certain bits work, so I reached out to the support with numerous questions and they got back to me with comprehensive answers each time, fixing each issue one at a time. Love the plugin, and love the service!

Love this widget

I was looking for a widget with this functionality. But i only found widgets with a lot of extra stuff which was unusable and which brought a lot of extra work with it.

This widget is just what it is and for me it’s strength is it’s simplicity.

So for me the best review widget out there!!

Read all 37 reviews

Contributors & Developers

“Site Reviews” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Site Reviews” into your language.

Interested in development?

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

Changelog

2.12.5 (2018-02-16)

  • Added a [site_reviews_summary] “text” attribute (see shortcode documentation for details)
  • Fixed star-ratings not rendering correctly from an ajax request

2.12.3 (2018-02-11)

  • Fixed schema DateTime error
  • Fixed system info plugin settings formatting

2.12.2 (2018-02-10)

  • [feature] Review blacklist
  • Notification errors are now logged
  • Removed “site-reviews/notification/template-tags” filter hook (use “site-reviews/email/compose” instead)
  • Show the reviewer’s IP address in the details metabox
  • Fixed plugin notices
  • Fixed review rendering to check for an assigned_to value
  • Fixed Slack notifications
  • Fixed the post ranking calculation on new review submissions

2.11.3 (2018-01-31)

  • Fixed plugin session management

2.11.2 (2018-01-30)

  • [feature] Added an autocomplete searchbox in the Assigned To metabox
  • [feature] Added Akismet integration to provide spam-validation
  • Added a default subject to the mailto link in the details metabox
  • Added a link to the WordPress user who submitted the review in the details metabox
  • Changed author name default to “Anonymous”
  • Fixed a possible error from occuring when the user has manually edited the database
  • Fixed internal IP detection

2.10.4 (2018-01-26)

  • Fixed the form error message CSS
  • Fixed the Invisible reCaptcha plugin integration when multiple HTML forms exist on the same page

2.10.3 (2018-01-17)

  • Changed the notification title/subject to show the title of the post a review is assigned to.

2.10.2 (2018-01-10)

  • Fixed javascript error (oops!)

2.10.1 (2018-01-09)

  • Empty author name defaults to “Anonymous”
  • Fixed review pagination on static frontpage

2.10.0 (2018-01-08)

  • [feature] Added option to show a link of the assigned post in reviews
  • Fixed bug when rendering links of invalid assigned post IDs
  • Fixed regeneration of “show more” links
  • Fixed review pagination for non-hierarchical post types
  • Tweaked styles for twentyfifteen theme
  • Tweaked the scroll-to-top functionality of ajax pagination

2.9.5 (2018-01-02)

  • Added “offset” option to [site_reviews] shortcode

2.9.4 (2018-01-02)

  • Added “site-reviews/local/review/submitted/message” filter hook to modify the successful submission message.
  • Added a new helper function for logging variables: glsr_log()

2.9.3 (2018-01-01)

  • Fix required fields setting

2.9.2 (2017-12-13)

  • Fix escaped unicode characters in JSON-LD
  • Fix PHP 7.2 compatibility
  • Fix white-space for <br> in reviews

2.9.1 (2017-12-08)

  • Fix “read more” links with ajax pagination

2.9.0 (2017-12-08)

  • [feature] Assign a post ID to multiple reviews in bulk
  • [feature] Bayesian ranking values are stored in posts that have assigned reviews (can be used for query sorting)
  • Fix CSS for themes that do not implement the .screen-reader-text class
  • Fix System Info PHP error when detecting server IP address

2.8.4 (2017-11-16)

  • Added “site-reviews/enqueue/localize” filter hook so that the “ajaxpagination” selector array for fixed elements can be modified.

2.8.3 (2017-11-15)

  • Fix a PHP type error when a shortcode contains no arguments

2.8.2 (2017-11-15)

  • Added ajax pagination automatic scrolling and loader animation

2.8.1 (2017-11-15)

  • Fix ajax pagination when the HTMLElement class attribute has a trailing space

2.8.0 (2017-11-13)

  • [feature] Allow ajax pagination of reviews

2.7.4 (2017-11-11)

  • Fix activation notice for unsupported PHP and WordPress versions
  • Fix database upgrade for people using Site Reviews v2.1.0 or earlier
  • Fix deletion of plugin for unsupported PHP versions

2.7.3 (2017-11-09)

  • Fix “assign_to” and “assigned_to” widget options

2.7.2 (2017-10-31)

  • Fix compatibilty with some themes that use javascript to modify form elements
  • Remove recaptcha key/secret from the systemlog

2.7.1 (2017-10-24)

  • Fix [site_reviews_summary] class attribute

2.7.0 (2017-10-24)

  • Added option to show a register link when login is required to submit a review
  • Added “site-reviews/rendered/review-form/login-register” hook

2.6.2 (2017-10-19)

  • Only build rating schema for reviews with a rating
  • Prevent HTML from being generated for empty review fields
  • Remove obsolete schema meta tags

2.6.1 (2017-10-19)

  • Added “site-reviews/validation/rules” hook

2.6.0 (2017-10-17)

  • [feature] Set whether or not a field is required
  • Added “site-reviews/rendered/review” hook
  • Added post_id of review to ‘site-reviews/local/review/create’ hook

2.5.2 (2017-08-21)

  • Fix plugin localization

2.5.1 (2017-08-10)

  • Added “site-reviews/validate/review/submission” hook

2.5.0 (2017-08-08)

  • [feature] Added a Honeypot (spam trap) to the submission form
  • Fix Translator to use UTF-8 encoding when converting html entities

2.4.5 (2017-08-07)

  • Fix Translator to correctly handle htmlentities in plugin strings

2.4.3 (2017-07-29)

  • Fix a possible Translator bug
  • Fix “Assigned To” input from updating page on Enter key
  • Fix “hide_response” from showing unnecessarily with the TMCE button [site_reviews] shortcode
  • Show plugin settings in system info

2.4.1 (2017-07-22)

  • Fix the schema URL for a page
  • Update screenshots

2.4.0 (2017-07-05)

  • [feature] Publicly respond to a review
  • Allow multi-line reviews

2.3.2 (2017-07-02)

  • Fix a possible translation error from occurring

2.3.1 (2017-06-30)

  • Fix hooks documentation

2.3.0 (2017-06-26)

  • [feature] Reviews Summary shortcode: [site_reviews_summary]
  • [feature] Relative dates option
  • [feature] Rich snippets for reviews (schema.org)
  • [feature] Translate any plugin text
  • [changed] The default minimum rating for displaying reviews has been changed to 1 (instead of 5)
  • Added “show more” links to review excerpts
  • Extended “assign_to” and “assigned_to” attributes in the widgets and shortcodes to accept “post_id” as a value which automatically equals the current post ID
  • Removed “Submission Form” custom text options (replaced by the new Translation options)
  • Fix tinymce shortcode dialog tooltips

2.2.3 (2017-05-07)

  • Added option to change submit button text

2.2.2 (2017-05-06)

  • Added JS event that is triggered on form submission response (site-reviews/after/submission)
  • Fix form submission without ajax

2.2.1 (2017-05-06)

  • Added hook that runs immediately after a review has successfully been submitted (site-reviews/local/review/submitted)
  • Use new IP detection when submitting a review

2.2.0 (2017-05-03)

  • [feature] use Google’s Invisible reCAPTCHA on submission forms

2.1.8 (2017-04-19)

  • Fix [site_reviews] shortcode pagination option
  • Fix possible JS race condition which breaks the star rating functionality

2.1.6 (2017-04-02)

  • Fix the category feature to work properly when a user was not logged in
  • Corectly remove the “create_site-review” capability

2.1.3 (2017-04-01)

  • Changed capability requirement to “edit_others_pages”

2.1.1 (2017-03-21)

  • Fixed a bug causing reviews to not load correctly introduced by v2.1.0 (sorry!)

2.1.0 (2017-03-19)

  • [feature] Assign reviews to a page/post
  • [deprecated] The ‘post_id’ review key is deprecated in favour of ‘ID’ in reviews returned from the glsr_get_review() and glsr_get_review() functions
  • Added hook that runs immediately after a review has been created

2.0.4 (2017-03-09)

  • Fix WordPress customizer compatibility (see: https://codex.wordpress.org/Function_Reference/get_current_screen#Usage_Restrictions)

2.0.3 (2017-03-09)

  • Fix incorrect plugin update check

2.0.2 (2017-01-24)

  • Added hook to filter metabox details

2.0.1 (2017-01-23)

  • Prevent the taxonomy object from containing recursion

2.0.0 (2017-01-12)

  • [feature] Helper functions to easily access review meta
  • [feature] MCE shortcode button dropdown
  • [feature] Review avatars (gravatar.com)
  • [feature] Review categories
  • [breaking] Changed internal widget/shortcode hook names
  • [breaking] Changed shortcode variables
  • [breaking] Consolidated all plugin settings into a single setting variable
  • Ajaxified approve/unapprove
  • Custom Published/Pending labels
  • New settings page for reviews
  • Removed “site-reviews/reviews/excerpt_length” filter hook
  • Removed “site-reviews/reviews/use_excerpt” filter hook

1.2.2 (2017-01-06)

  • Added hook to change excerpt length
  • Added hook to disable the excerpt and instead display the full review content

1.2.1 (2016-12-28)

  • Fix PHP 5.4 compatibility regression

1.2.0 (2016-12-27)

  • [feature] Send notifications to Slack
  • Fix notifications to use the email template setting

1.1.1 (2016-12-05)

  • Remove “.star-rating” class on frontend which conflicts with the woocommerce plugin CSS
  • Added hooks to modify rendered fields/partials HTML

1.1.0 (2016-11-16)

  • [feature] Pagination
  • [breaking] Changed internal widget hook names
  • [breaking] Changed text-domain to “site-reviews”
  • Set post_meta defaults when creating a review
  • [addon support] Display read-only reviews
  • [addon support] Display widget link options (conditional field)
  • [addon support] Show all review types by default in widgets and shortcodes

1.0.4 (2016-11-14)

  • use the logged-in user’s display_name by default instead of “Anonymous” when submitting reviews
  • Fix shortcodes to insert in the_content correctly

1.0.3 (2016-11-09)

  • Updated plugin description
  • Fix plain-text emails
  • Fix inconsistencies with plugin settings form fields
  • Fix internal add-on integration code

1.0.2 (2016-10-24)

  • Set widget and settings defaults
  • Fix PHP error that is thrown when settings have not yet been saved to DB

1.0.0 (2016-10-21)

  • Initial plugin release