Integrating Everywhere add-on with JomSocial profile system

From JReviews Documentation
Jump to: navigation, search

When you integrate JReviews Everywhere add-on with JomSocial profile system, members of your site will be able to rate and review each other.

Creating a JReviews listing type for JomSocial profiles

The first step is to create a listing type for members in JReviews Listing Types Manager:

Listing-types-manager.png

Click the New button in top right corner to create a new listing type:


Members-listing-type.png

Title - enter the listing type title.

Comments & Ratings - 3 options are available:

  • Allow comments and ratings - users will be able to rate and review each other.
  • Allow comments without ratings - users will be able to review each other without ratings.
  • Disable comments and ratings - reviews and ratings disabled - don't choose this.

Select all the field groups you want to associate to this listing type - here you can select review field groups in case you want to include extra review fields besides the standard "Comments" text area.

Display in Advanced Search Page - choose No, this is only for JReviews listings.

Rating Criteria - create rating criteria based on which users will review each other:

  • Rating Criterion - enter the title of the rating criterion.
  • Required - uncheck if you want the criterion to be optional.
  • Weight - criteria weights for weighted average rating calculation. The total must add to 100, do not enter the % character. If left blank a simple average will be calculated.
  • Tooltip - hints for users on how to rate in the review form.

Under Advanced Setup you will find many settings. Since this listing type will be used with EasySocial profiles, only the review related settings will be used:

Members-listing-type2.png

It is recommended to set Stop users from reviewing their own listings to Yes so that users won't be able to review themselves.

The integration includes only user reviews functionality, editor reviews are not available, so none of the editor related settings will be used.

Assigning the JReviews listing type to JomSocial categories (user groups)

Next step is to go to the Everywhere add-on:

Everywhere-link.png

Click the Select Extension dropdown, choose JomSocial - Access Groups and click the Setup New button:

Everywhere-js1.png

In the popup form select the listing type that you created and choose user groups for which you want to enable reviews:

Everywhere-js2.png

Displaying the review form and reviews in JomSocial profiles

To display the review form in JomSocial profiles, it is necessary to install the Reviews of Me plugin for JomSocial which can be found in the JReviews package that you downloaded from the Client Area. The file that you need to install is this:

  • /package_jreviews_2.4.x_unzip_first/plugins_everywhere_addon/jomsocial/jreviews_reviewme.zip

To install it, go to the Joomla Extension Manager:

Joomla-extension-manager-installer.png

After you install the plugin, go to the Joomla Plugin Manager and publish the Reviews of Me plugin. Then the plugin will show up in all profiles for which you enabled the integration:

Everywhere-js3.png