Difference between revisions of "EasySocial integration"

From JReviews Documentation
Jump to: navigation, search
(Created page with "== 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...")
 
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Displaying user avatars in their listings, reviews, comments and linking to their profiles ==
+
== Displaying avatars of users in their listings, reviews, comments and linking to their profiles ==
  
 
To show user avatars in their listings, reviews and comments with links to their EasySocial profiles, it is required to enable EasySocial integration in JReviews Configuration:
 
To show user avatars in their listings, reviews and comments with links to their EasySocial profiles, it is required to enable EasySocial integration in JReviews Configuration:
Line 5: Line 5:
 
[[File:Easysocial1.png]]
 
[[File:Easysocial1.png]]
  
Example of a user review with avatar and a link to the user profile:
+
'''Example of a user review with avatar and a link to the user profile:'''
  
 
[[File:Easysocial2.png]]
 
[[File:Easysocial2.png]]
 
  
 
== Integrating with EasySocial Activity Stream ==
 
== Integrating with EasySocial Activity Stream ==
Line 16: Line 15:
 
[[File:Easysocial3.png]]
 
[[File:Easysocial3.png]]
  
In EasySocial Applications page you need to enable the JReviews Activity Stream app (the app is automatically installed):
+
In the EasySocial Applications page you need to enable the JReviews Activity Stream App. This App is automatically installed by JReviews if it detects EasySocial is already installed. Otherwise you need to get the App from the JReviews download package and install it via the EasySocial Applications installer.
  
 
[[File:Easysocial4.png]]
 
[[File:Easysocial4.png]]
  
Example of an activity when someone votes on a review:
+
'''Example of an activity when someone votes on a review:'''
  
 
[[File:Easysocial5.png]]
 
[[File:Easysocial5.png]]
  
 +
== Displaying listings, reviews and favorites of users on their profile pages ==
  
== Displaying user's listings, reviews and favorites on their profile pages ==
+
JReviews provides 3 EasySocial Apps for user profiles:
 
+
JReviews provides 3 EasySocial apps for user profiles:
+
  
 
* '''MyListings''' - displays listings submitted by the user
 
* '''MyListings''' - displays listings submitted by the user
Line 33: Line 31:
 
* '''MyFavorites''' - displays list of user's favorite listings
 
* '''MyFavorites''' - displays list of user's favorite listings
  
These apps are not installed by default. To install them, download the latest JReviews package from the client area and locate these installation files:
+
These Apps 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_easysocial/mylistings.zip
 
* /package_jreviews_2.4.x_unzip_first/plugins_easysocial/mylistings.zip
Line 39: Line 37:
 
* /package_jreviews_2.4.x_unzip_first/plugins_easysocial/myfavorites.zip
 
* /package_jreviews_2.4.x_unzip_first/plugins_easysocial/myfavorites.zip
  
Apps need to be installed using EasySocial Appliation installer:
+
Apps need to be installed using EasySocial Application installer:
  
 
[[File:Easysocial6.png]]
 
[[File:Easysocial6.png]]
Line 45: Line 43:
 
After the installation, reload the EasySocial Applications page and publish the plugins.
 
After the installation, reload the EasySocial Applications page and publish the plugins.
  
Click on the Apps to adjust their parameters. Most of the app parameters are the same as those of JReviews Listings and JReviews Reviews modules, but there are 3 important EasySocial parameters that define how the app will display in user profiles:
+
Click on the Apps to adjust their parameters. Most of the App parameters are the same as those of JReviews Listings and JReviews Reviews modules, but there are 3 important EasySocial parameters that define how the App will display in user profiles:
  
* '''Default application''' - if set to ''Yes'', the app will be automatically installed for all users. If set to ''No'', the app will be displayed only in profiles of users that installed it themselves via their profile settings.
+
* '''Default application''' - if set to ''Yes'', the App will be automatically installed for all users. If set to ''No'', the app will be displayed only in profiles of users that installed it themselves via their profile settings.
* '''Display as''' - if you choose ''Widget'', the app will be outputted on the main profile page. If you choose ''Application Canvas'', the app will be displayed as a separate page with a link to the app in the user's profile.
+
* '''Display as''' - if you choose ''Widget'', the App will be displayed on the main profile page. If you choose ''Application Canvas'', the App will be displayed as a separate page with a link to the App in the user's profile.
* '''Widget Position''' - if you selected ''Widget'' in the previous setting, here you can choose the position of the app in the profile page.
+
* '''Widget Position''' - if you selected ''Widget'' in the previous setting, here you can choose the position of the App in the profile page.
  
Example of a MyFavorites app displayed in a profile as a widget:
+
'''Example of a MyFavorites App displayed in a profile as a widget:'''
  
 
[[File:Easysocial7.png]]
 
[[File:Easysocial7.png]]
  
On the same screenshot you can see in the sidebar links to other apps that have been set to display as Application Canvas.
+
On the same screenshot you can see in the sidebar links to other Apps that have been set to display as Application Canvas.
  
Example of a MyReviews app outputted as application canvas in user profile:
+
'''Example of a MyReviews App displayed as application canvas in user profile:'''
  
 
[[File:Easysocial8.png]]
 
[[File:Easysocial8.png]]
 
  
 
== Integrating with EasySocial User Points ==
 
== Integrating with EasySocial User Points ==
Line 73: Line 70:
  
 
You can unpublish rules that you don't want to use and adjust the number of points that will be awarded.
 
You can unpublish rules that you don't want to use and adjust the number of points that will be awarded.
 +
 +
== Integrating with EasySocial Achievements ==
 +
 +
Please refer to the [[Setup_EasySocial_Achievements|Setup EasySocial Achievements]] to begin using this feature.
 +
 +
== Integrating EasySocial 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 [[JReviews Everywhere Add-on|Everywhere Add-on manual]].
  
  
 
[[Category:JReviews]]
 
[[Category:JReviews]]
 
[[Category:Community]]
 
[[Category:Community]]

Latest revision as of 23:59, 25 September 2014

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

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

Easysocial1.png

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

Easysocial2.png

Integrating with EasySocial Activity Stream

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

Easysocial3.png

In the EasySocial Applications page you need to enable the JReviews Activity Stream App. This App is automatically installed by JReviews if it detects EasySocial is already installed. Otherwise you need to get the App from the JReviews download package and install it via the EasySocial Applications installer.

Easysocial4.png

Example of an activity when someone votes on a review:

Easysocial5.png

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

JReviews provides 3 EasySocial Apps 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 Apps 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_easysocial/mylistings.zip
  • /package_jreviews_2.4.x_unzip_first/plugins_easysocial/myreviews.zip
  • /package_jreviews_2.4.x_unzip_first/plugins_easysocial/myfavorites.zip

Apps need to be installed using EasySocial Application installer:

Easysocial6.png

After the installation, reload the EasySocial Applications page and publish the plugins.

Click on the Apps to adjust their parameters. Most of the App parameters are the same as those of JReviews Listings and JReviews Reviews modules, but there are 3 important EasySocial parameters that define how the App will display in user profiles:

  • Default application - if set to Yes, the App will be automatically installed for all users. If set to No, the app will be displayed only in profiles of users that installed it themselves via their profile settings.
  • Display as - if you choose Widget, the App will be displayed on the main profile page. If you choose Application Canvas, the App will be displayed as a separate page with a link to the App in the user's profile.
  • Widget Position - if you selected Widget in the previous setting, here you can choose the position of the App in the profile page.

Example of a MyFavorites App displayed in a profile as a widget:

Easysocial7.png

On the same screenshot you can see in the sidebar links to other Apps that have been set to display as Application Canvas.

Example of a MyReviews App displayed as application canvas in user profile:

Easysocial8.png

Integrating with EasySocial 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 EasySocial's User Points page, click the Discover link and then click the Start Scan button:

Easysocial9.png

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

Easysocial10.png

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

Integrating with EasySocial Achievements

Please refer to the Setup EasySocial Achievements to begin using this feature.

Integrating EasySocial 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.