Difference between revisions of "Setup Facebook integration"

From JReviews Documentation
Jump to: navigation, search
(Created page with '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…')
 
Line 5: Line 5:
 
Currently the actions supported by this integration are submissions of '''unmoderated''' listings, reviews and helpful review votes which is similar to the "like it" functionality of Facebook, but for user reviews in JReviews.
 
Currently the actions supported by this integration are submissions of '''unmoderated''' listings, reviews and helpful review votes which is 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.
+
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:
 +
 
 +
[[File:Wall-post-example.png]]
  
 
Helpful review voting will only generate a wall post if the user has already established a Facebook session because unlike reviews and listings, there's no practical way to ask the user to publish the vote to FB. If users log in to your site via Facebook connect then positive votes will automatically generate a wall post with the review the user liked.  
 
Helpful review voting will only generate a wall post if the user has already established a Facebook session because unlike reviews and listings, there's no practical way to ask the user to publish the vote to FB. If users log in to your site via Facebook connect then positive votes will automatically generate a wall post with the review the user liked.  

Revision as of 22:05, 6 July 2010

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.

Which actions will generated a Wall post?

Currently the actions supported by this integration are submissions of unmoderated listings, reviews and helpful review votes which is 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:

Wall-post-example.png

Helpful review voting will only generate a wall post if the user has already established a Facebook session because unlike reviews and listings, there's no practical way to ask the user to publish the vote to FB. If users log in to your site via Facebook connect then positive votes will automatically generate a wall post with the review the user liked.

Are there any special requirements

The integration will work with or without a Facebook Connect Joomla login. If your site already supports Facebook Connect login, via 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:

Jreviews-publish-to-fb.png

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. All other users will not see this button.

Facebook API Notice

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.

How to setup the Facebook Integration

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 http://facebook.com/developers and create a new application.

Facebook-new-app.jpg

Once you click on 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. Only the relevant tabs are shown below.

Authentication

Facebook-auth.jpg

Connect

Facebook-connect.jpg

Migrations

Facebook-migrations.jpg

When you are done, save the application and you will find the Application ID and Scret strings in the summary page and the basic tab shown below:

Facebook-basic.jpg

Copy these values and paste them in the configuration screen in JReviews Community tab:

Jreviews-facebook-settings.png