User Reviews Setup

Overview

This document provides instructions on the extension ' User Reviews'.

When activated the plugin will add a user reviews link to the  WP Admin > Ultimate Member sub-menu. This link will take you to the user reviews page which lists all approved/flagged/pending user reviews on your site. As an admin, you can edit all user reviews and also change the review from approved to pending or vice versa.

Contents

Settings #

Extension's settings #

The extension adds a Reviews tab to the WP Admin > Ultimate Member > Settings page > Appearance tab > Profile Menu sub-tab: On this tab is the following options:

  • Show user rating in members directory – If turned on the star rating of a user will show on the member directories
  • Review date format – Choose the format to display the date of the review
  • Who can flag reviews – Choose who can flag reviews
  • Enable review reply – Enable/disable the reply functionality

Profile Menu settings #

The extension adds options to the Settings page > Appearance tab > Profile Menu sub-tab:

  • Reviews Tab – Allows enabling/disable "Reviews" item in the Profile menu
  • Who can see Reviews Tab? – Manage access to the "Reviews" tab in the Profile menu

Email settings #

The extension adds these email templates:

  • New Review - Send the user an email when the user receives a new review
  • New Review is Pending - Send the admin an email when someone writes a review and its status is "Pending"
  • New Reply - Send the reviewer an email when the user replies to the received review

[Ultimate Member > Settings > Email]

Administrators can edit email templates: enable, disable, change subject or body. Go to the admin page [Ultimate Member > Settings > Email], find the needed email template, and click the button "Edit" (gear icon). You'll see email template settings. Change what you want and save changes. 

User Role settings #

The extension adds a widget to the user role page so you can give each user role unique review/rating permissions

  • Can have user reviews tab? – If turned off user reviews will be disabled for this role.
  • Can review other members? – This option allows you to select if a role can review other members
  • Can review these roles only – If a user role can review other members you can decide if the role can only review certain roles
  • Automatically publish reviews from this role? – If turned off, reviews from this role will be pending admin review and not published automatically.
  • Can edit/remove their own reviews? – If turned off users with this role will not be able to delete their own reviews that they have left for other users
  • Can edit/remove other reviews? – If turned on users with this role will be able to delete user reviews

UM > User Roles > Select Roled and click edit > User Reviews.

Extra Settings #

By default, each member can write a review to another member once. You may use the code below to  allow multiple reviews:

add_filter( 'um_reviews_allow_multiple_reviews', '__return_true' );

You can add custom code to the end of the file functions.php in the active theme directory (using the child theme is recommended). The functions.php is an important theme file, so each theme created for WordPress contains this file.

User meta #

The extension includes the field "User Rating" so you can show a user’s rating in their profile header or anywhere else where user meta can be selected.

How to add User Rating into the profile header #

[ wp-admin > Ultimate Member > Forms > Edit Form (profile) > User Meta ]

How to add User Rating into the profile form #

[ wp-admin > Ultimate Member > Forms > Edit Form (profile) ] Click on the "+" button and select User Rating from the fields manager.

How to remove User Rating from the member cards in the Members Directory #

[ wp-admin > Ultimate Member > Member Directories > Edit Member Directory ]

Shortcode #

The extension adds these shortcodes:

[ultimatemember_top_rated] #

Used for: Display top rated reviews.

Example:

[ultimatemember_top_rated roles="member" number="5" ]

The shortcode attributes:

  • roles (string) - The role of the rated users to be listed. Optional.
  • number (integer) - Total number of users to be listed. Optional. Default value: 5

[ultimatemember_most_rated] #

Used for: Display most rated reviews.

Example:

[ultimatemember_most_rated roles="member" number="5" ]

The shortcode attributes:

  • roles (string) - The role of the rated users to be listed. Optional.
  • number (integer) - Total number of users to be listed. Optional. Default value: 5

[ultimatemember_lowest_rated] #

Used for: Display lowest rated reviews.

Example:

[ultimatemember_lowest_rated roles="member" number="5" ]

The shortcode attributes:

  • roles (string) - The role of the rated users to be listed. Optional.
  • number (integer) - Total number of users to be listed. Optional. Default value: 5