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 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 Settings page, Extensions 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 format to display the date of 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 to enable/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 “New Review Notification” email template to the Settings page, Email tab. Administrator can disable or enable this email, also edit template subject and content.

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

Extra Settings #

By default, each member can write a review to another member once. You may use 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 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) ]

How to add User Rating into the profile form #

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

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