How to install, set-up and manage Facebook Page Reviews extension for Joomla...

Installation

To install Facebook Page Reviews, log-in to admin area Extensions > Extension manager > Install, choose "Upload package file" and choose facebookpagereviews-package.zip.

Warning Make sure that you choose not the file you downloaded from AllForJoomla, but the file inside the main archive.

After the package installataion you need to activate the plugin "System - Facebook Page Reviews". To do that go to Extensions > Plugin manager find and activate plugin "System - Facebook Page Reviews".

Activation

Updating this plugin is important due to bugfixes and new features. To set up automatic updates for the Facebook Page Reviews, please follow these steps:

  1. Open the component settings: Components > Facebook Page Reviews > Options
  2. Paste your Premium License Key into the "Premium License key" field. You can find this key inside your account on AllForJoomla.com -> Purchased extensions

After saving your website will automatically check for updates of the Facebook Page Reviews.

Warning The update will install only if you have active support otherwise it will throw an error. There are only 6 months of support included in the purchase price. To extend the support please choose "Extend support" inside your account on AllForJoomla.com -> Purchased extensions.

Create a widget

Widget creation and widget management is performed in admin section Components > Facebook Page Reviews.

To create or modify existing widget, just use integrated visual builder.

  1. First you need to Connect to Facebook API. To do that click on the "Connect to Facebook" button. In the popup window authorize the application.
  2. Then check Facebook connection status at the left hand side.
  3. If everything is ok, you can choose your Facebook Page and customize the widget.

After creating a widget you will see it's shortcode in the widgets list. You need to place this shortcode in the place where you want this widget to be displayed. More about shortcodes in the "Shortcode" section.

Shortcode

In the admin section of your website Components > Facebook Page Reviews you can see a list of existing widgets. In the "Shortcode" column you can see a shortcode of every widget.

This shortcode you need to copy and paste to the place of your website where you want to see the widget. This shortcode you can paste inside the content (article), module html or even into the template files.

Translation

Quick extension translation

By quick translation we mean translating only some labels displayed in the widget.

To translate those labels you can use Joomla Language Overrides.

The language constants you need to override are:

  • COM_FACEBOOKPAGEREVIEWS_RATED_BY
  • COM_FACEBOOKPAGEREVIEWS_NO_REVIEWS
  • COM_FACEBOOKPAGEREVIEWS_NOT_AVAILABLE
  • COM_FACEBOOKPAGEREVIEWS_VIEW_ON_FB
  • COM_FACEBOOKPAGEREVIEWS_LOAD_MORE
  • COM_FACEBOOKPAGEREVIEWS_SHOW_MORE
  • COM_FACEBOOKPAGEREVIEWS_SHOW_LESS
  • COM_FACEBOOKPAGEREVIEWS_AJAX_ERROR
  • COM_FACEBOOKPAGEREVIEWS_NETWORK_ERROR
  • COM_FACEBOOKPAGEREVIEWS_CONNECT_TO_FACEBOOK
  • COM_FACEBOOKPAGEREVIEWS_NO_REVIEWS_FOUND
  • COM_FACEBOOKPAGEREVIEWS_RATE_REQUEST_TEXT
  • COM_FACEBOOKPAGEREVIEWS_YES
  • COM_FACEBOOKPAGEREVIEWS_NO

To create language overrides follow these steps:

  1. Go to Extensions -> Language -> Overrides
  2. Select your website language (administrator) in the filtering
  3. Create new override by clicking "New" button
  4. Copy the desired constant for override (constants are listed previously) and paste it into the "Language Constant" field
  5. Write your translation of the constant into the "Text" field
  6. Select the "For Both Locations" checkbox
  7. Save the override

Repeat those steps for every language constant that you want to override translation.

Full extension translation

You can translate the plugin into desired language by translating the language files, renaming and putting them into specific folder:

  • /administrator/language/en-GB/en-GB.com_facebookpagereviews.ini
  • /administrator/language/en-GB/en-GB.com_facebookpagereviews.sys.ini

For example if you translating it to Italian language, you need to:

  1. Copy mentioned files, rename them to it-IT.com_facebookpagereviews.ini and it-IT.com_facebookpagereviews.sys.ini
  2. Translate new files in to Italian language
  3. Put them to the folder /administrator/language/it-IT/