View source for EasySocial integration

== 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:

[[File:Easysocial1.png]]

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

[[File: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:

[[File: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.

[[File:Easysocial4.png]]

'''Example of an activity when someone votes on a review:'''

[[File: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:

[[File: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:'''

[[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.

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

[[File: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:

[[File:Easysocial9.png]]

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

[[File:Easysocial10.png]]

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

== EasySocial Achievements ==

Please refer to the [[http://docs.reviewsforjoomla.com/?title=Setup_EasySocial_Achievements|dedicated article for setting up EasySocial Achievements for JReviews]]

== 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:Community]]