KA Facebook Recommendations
Facebook Recommendations shows personalized recommendations for your website to your website visitors. The content shown in recommendations is hosted by Facebook, when a user visits Facebook Recommendations page they are shown personalized recommendations. These recommendations are suggestions that which topics to view ordered according to the activity of your website on Facebook. Recommendations will be same whether user has logged into your website or not. However if user is logged in to their Facebook account then Facebook Recommendations box will show personalised recommendations by prefernce of the pages that her friends have interacted with.
To generate the recommendations, the module considers all the social interactions with URLs from your site. For a logged in Facebook user, the module will give preference to and highlight objects her friends have interacted with.
You specify a site for which to show recommendations for. Now you can filter URLs using filer setting and also add referrals variable to URLs to track referrals.
The KA Facebook Recommendations shows personalized recommendations to your users. Since the content is hosted by Facebook, the plugin can display personalized recommendations whether or not the user has logged into your site. To generate the recommendations, the plugin considers all the social interactions with URLs from your site. For a logged in Facebook user, the plugin will give preference to and highlight objects her friends have interacted with.
You specify a site for which to show recommendations for. The domain is matched exactly, so a plugin with site=facebook.com would not include URLs from developers.facebook.com. You cannot currently aggregate across multiple domains.
Installation:
Please install module(mod_kafbrecommendations.zip) and plugin(plg_javascriptsdk.zip). Both are required to make Facebook Recomendations work. If you already have plugin(plg_javascriptsdk.zip) installed then only install the module(mod_kafbrecommendations.zip).
To create an Application please read How to create a Facebook Application. Once you have the Application ID, paste it in your JavaScriptSDK plugin and Publish and Save it.
Upgrade:
- First make note of settings of already installed version.
- Then uninstall old version and install new version by going to Extensions > Install/Uninstall in Joomla backend.
- Go to module settings page and reconfigure settings as they were in old version and publish.
Configuration:
| Module Parameters | Default |
Description | |
| Rendering Mode | IFrame |
Select how to render the box, JavaScript or IFrame. IFrame work is most of browsers. |
|
| Domain |
|
The domain for which to show Recommendations Module. Defaults to the domain the plugin is on. |
|
| Width | 300 |
Width of Recommendations Module in pixels (Default: 300). |
|
| Height |
300 |
Height of Recommendations Module in pixels (Default: 300). |
|
| Header |
Hide |
Show the Recommendations Header. |
|
| Colour Scheme |
Light |
The colour scheme of the Recommendations Module. |
|
| Font |
|
The font style of Recommendations Module. |
|
| Border Colour |
|
Border colour of the Recommendations Module. |
|
| Filter |
|
Allows you to filter which URLs are shown in the plugin. The plugin will only include URLs which contain the filter term in the first two path parameters of the URL. If nothing in the first two path parameters of the URL matches the filter, the URL will not be included. |
|
| Referrals | A label for tracking referrals; must be less than 50 characters and can contain alphanumeric characters and some punctuation (currently +/=-.:_). Specifying the ref attribute will add the 'fb_ref' parameter to the referrer URL when a user clicks a link from the plugin. | ||
| CSS | Enable/Disable CSS styling. | ||
| IFrame CSS Styles | Custom CSS styles for IFrame Rendering Mode. Styling is very limited and only works on overall IFrame. Styling for individual elements did not work in our tests and seems Facebook does not allow it at the moment. | ||
| Advanced Parameters |
|
||
| Module Class Suffix |
|
A suffix to be applied to the CSS class of module for individual styling. |
|
| Caching |
Use Global |
Select whether to cache the content of this module. |
|
| Cache Time |
Cache Time |
The time before the module is recached. |
|
|
|
|
||
Version: 2.0
- Added support for Joomla 3.0
Version: 1.5.x.1.1
- Added CSS styling for iframe mode.
- Improved Admin user interface
- Added Filters setting to filter URLs
- Added Referrals setting to track referrals
Version: 1.5.x.0
- First version 1.5.x.0 released.
How to create a Facebook Application
To use Facebook extensions you need to create a Facebook Application and get an Application ID.
http://www.youtube.com/watch?v=aJDtpPja0To
Application ID is needed if you are using JavaScript SDK plugin. You can find JavaScriptSDK settings by going to Extensions > Plugins Manager and then clicking on System - JavaScript SDK.
API key is needed if you are using Fanbox/Likebox. You will also need Page ID for Fanbox/Likebox that you can copy from your Facebook Page URL. Here is a Tutorial for How to create a Facebook Page.
You can manage your created application in Developer Dashboard. Sometimes it takes a few minutes for Facebook to get ready your Application ID to use.
