JomSocial integration

From JReviews Documentation
Jump to: navigation, search

Displaying user avatars in their listings, reviews, comments and linking to their profiles

To show user avatars in their listings, reviews and comments with links to their JomSocial profiles, it is required to enable JomSocial integration in JReviews Configuration:

Jomsocial1.png

Example of a user review with avatar and a link to the user profile:

Jomsocial2.png

Integrating with JomSocial Activity Stream

To integrate with JomSocial Activity Stream, go to the JReviews Configuration (Community tab) and select posts that will be sent to JomSocial:

Jomsocial3.png

Next, go to the Joomla Plugin Manager and enable the JReviews Activity Stream plugin. This plugin is automatically installed by JReviews if it detects JomSocial is already installed. Otherwise you need to get the plugin from the JReviews download package and install it via the Joomla Extension installer.

Jomsocial4.png

Example of an activity when someone votes on a review:

Jomsocial5.png

Displaying listings, reviews and favorites of users on their profile pages

JReviews provides 3 JomSocial plugins for user profiles:

  • MyListings - displays listings submitted by the user
  • MyReviews - displays reviews submitted by the user
  • MyFavorites - displays list of user's favorite listings

These plugins are not installed by default. To install them, download the latest JReviews package from the client area and locate these installation files:

  • /package_jreviews_2.4.x_unzip_first/plugins_jomsocial/jreviews_mylistings.zip
  • /package_jreviews_2.4.x_unzip_first/plugins_jomsocial/jreviews_myreviews.zip
  • /package_jreviews_2.4.x_unzip_first/plugins_jomsocial/jreviews_myfavorites.zip

Those plugins need to be installed using Joomla Extension Manager installer:

Joomla-extension-manager-installer.png

After the installation, go to the Joomla Plugin Manager and publish the plugins.

Click on the plugins to adjust their parameters. Most of the plugin parameters are the same as those of JReviews Listings and JReviews Reviews modules, but there are 2 additional JomSocial parameters that define how the plugin will display in user profiles:

  • Core Application - if set to Yes, the plugin will be automatically installed for all users. If set to No, the plugin will be displayed only in profiles of users that installed it themselves via their profile settings.
  • Position - you can choose to show the plugin in the Main content of the user profile or in the profile sidebar.

Example of a MyReviews plugin displayed in a user profile:

Jomsocial6.png

Integrating with JomSocial User Points

If you want users to be awarded with points when they submit listings, reviews, comments or media, it is necessary to import JReviews rules for points. They are automatically installed, you only need to go to the JomSocial's User Points page and click the Rule Scan button:

Jomsocial7.png

Go to the main User Points page and you should see all JReviews rules:

Jomsocial8.png

You can unpublish rules that you don't want to use and adjust the number of points that will be awarded.

Integrating JomSocial and JReviews Everywhere add-on for profile reviews

With JReviews Everywhere add-on you can have the ability for users to review each other. This integration is shown in the Everywhere Add-on manual.