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::
Example of a user review with avatar and a link to the user profile:
To integrate with EasySocial Activity Stream, go to the JReviews Configuration (Community tab) and select posts that will be sent to EasySocial:
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.
Example of an activity when someone votes on a review:
JReviews provides 3 EasySocial Apps for user profiles:
These Apps are not installed by default. To install them, download the latest JReviews package from the client area and locate these installation files:
Apps need to be installed using EasySocial Application installer:
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:
Example of a MyFavorites App displayed in a profile as a widget:
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:
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:
Go to the main User Points page and you should see all JReviews rules:
You can unpublish rules that you don't want to use and adjust the number of points that will be awarded.
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.
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:
Example of a user review with avatar and a link to the user profile:
To integrate with JomSocial Activity Stream, go to the JReviews Configuration (Community tab) and select posts that will be sent to JomSocial:
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.
Example of an activity when someone votes on a review:
JReviews provides 3 JomSocial plugins for user profiles:
These plugins are not installed by default. To install them, download the latest JReviews package from the client area and locate these installation files:
Those plugins need to be installed using Joomla Extension Manager installer:
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:
Example of a MyReviews plugin displayed in a user profile:
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:
Go to the main User Points page and you should see all JReviews rules:
You can unpublish rules that you don't want to use and adjust the number of points that will be awarded.
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.
To show user avatars in their listings, reviews and comments with links to their Community Builder profiles, it is required to enable Community Builder integration in JReviews Configuration:
Example of a user review with avatar and a link to the user profile:
JReviews provides 3 Community Builder plugins for user profiles:
These plugins are not installed by default. To install them, download the latest JReviews package from the client area and locate these installation files:
To install the plugins, go to the Community Builder component, click the Plugin Management and at the bottom of the page you will find the plugin installer:
Publish the plugins after the installation.
To configure the plugins, go to the Community Builder Tab Management and click on a plugin name. Most of the plugin parameters are the same as those of JReviews Listings and JReviews Reviews modules.
Example of a MyReviews plugin displayed in a user profile:
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.
The JReviews integration with Facebook allows you to create incremental traffic to your site, by posting user submitted actions to their Facebook walls. These will also appear in the newsfeeds of the user's friends which creates a viral effect.
Currently the actions supported by this integration are submissions of unmoderated listings, reviews and helpful review votes, which are similar to the "like it" functionality of Facebook, but for user reviews in JReviews.
With any of the above actions, the listing or review information will appear in the user's Facebook wall, including a link back to the detail page, the listing image if available, and the user rating where appropriate. This is how a review submission will look like in the reviewer's wall:
Helpful review voting will only generate a wall post if the user has already established a Facebook session; unlike reviews and listings, there's no practical way to ask the user to publish the vote to FB. If users log into your site via Facebook connect, then positive votes will automatically generate a wall post with the review the user liked.
The integration will work with or without a Facebook Connect Joomla login. If your site already supports Facebook Connect login, via JFBConnect, JomSocial, Community Builder or any other solution, then JReviews is able to identify the Facebook session for the current user and use it to submit directly to his Wall. This is transparent to the user.
If the user has not granted publish stream permissions or if the user is not logged in via Facebook, then he will see the following checkbox option above the submit button in both review and listing forms:
When the user clicks on the checkbox or FB button the Facebook Popup will appear requesting login information or publish stream permissions or both. This button will only appear for users not logged in via Facebook or users that haven't granted publish permissions. If you decide you want to allow users to opt-out of publishing the submissions to their Facebook wall, you can enable the opt-out setting in the JReviews configuration for Facebook.
JReviews uses only the latest FB javascript and PHP APIs and will not work with websites that use the old API for Facebook Connect functionality. You can find references to the old JavaScript SDK by searching for the string "FeatureLoader.js.php in your page source.
In the JReviews configuration, under the Community tab you need to enter a Facebook Application ID and Secret strings. If you already have a Facebook application for your site login, then you can use the strings from that application, otherwise you need to go to https://developers.facebook.com/apps and create a new application.
Once you click the Create New App, you'll need to enter the application name and agree to the license terms.
The next step is to configure the application:
Copy the Application ID and Secret values from your new app and paste them in the JReviews Configuration, Community tab:
Testing the integration
To test whether the integration is working, make sure you don't have an active Facebook session when using Facebook Connect to log in to your site. Go to the Facebook site and log out. Then go back to your site and navigate to a page where you can see the review form. Click on add review and look for the Publish to Facebook button as shown in the second image from the top. If it's not there, make sure you are accessing the site as a user for which moderation is not enabled because this only works without moderation.
A few steps to go over if it doesn't work
If you have another Facebook Connect extension used for user login, make sure it uses the most recent javascript SDK (API). Instructions for checking this are above
Make sure you used the Facebook Application ID in the configuration instead of the API Key. Components like JomSocial use the API Key; therefore just copying your settings will not work.
Make sure you disabled the moderation for listings and/or reviews for the user group for which you are testing this feature. The FB integration only works with unmoderated submissions.
The JReviews integration with Twitter allows you to create incremental traffic to your site by posting updates to your Twitter account based on user submitted actions.
Currently the actions supported by this integration are submissions of new listings, reviews and review comments.
With any of the above actions there will be a Twitter update to your account linking back to the related page on your site. For moderated submissions the updates will be posted on moderator approval.
First you need to create a Twitter app. Go to http://developer.twitter.com and log in. Under your username click on "My Applications" link:
On the next page click the Create a new application button:
Then fill in your app details:
On this page you'll need to accept "Developer Rules", fill in captcha and click the Create your Twitter application button at the bottom.
On the next page click on the Settings tab and choose Read & Write for app access:
At the bottom of the page click Update this Twitter's application setting button and then return to the first tab.
On the first tab click Create my access token button and reload the page.
Now you have all required app information that you need to enter in JReviews Configuration settings:
For the automatic tweets to include links to the listings on your site, you also need a bit.ly account. Make sure to create a real account instead of using your Twitter account to access bit.ly.
In JReviews Configuration you will need to enter your bit.ly username and API Key. To find the API Key, in your bit.ly account click on the Settings link, go to the Advanced tab and click the Show legacy API key link:
If the twitter integration is not working, these are the first things you need to check:
Make sure your Twitter App has Read & Write access.
Make sure you entered the callback url as shown above.
Make sure your server time settings are correct. If the server time settings are different than those of Twitter then the Oauth athentication will result in a 401 error. More details about this problem can be read here https://github.com/abraham/twitteroauth/issues/44.