Contents

📦 Installation

To install Google Reviews Pro, open System > Install > Extensions in your Joomla administrator, select Upload Package File and upload googlereviewspro-package.zip.

Important: Upload googlereviewspro-package.zip from inside the archive downloaded from AllForJoomla, not the outer archive itself.

After installing the package, enable the Google Reviews Pro system plugin. Go to System > Manage > Plugins, find System - Google Reviews Pro and enable it.

🔑 License Activation

After installation, activate Google Reviews Pro using your Premium License Key.

  1. Log in to your AllForJoomla account and open Purchased extensions.
  2. Copy the License Key for Google Reviews Pro.
  3. In your Joomla administrator, open Components > Google Reviews Pro > Options.
  4. Paste the License Key into the Premium License key field.
  5. Click Save.

After activation, Google Reviews Pro can operate normally and your website can automatically check for extension updates.

🧩 Create a Widget

Widget creation and management is performed in Components > Google Reviews Pro.

Use the integrated visual builder to create a new widget or modify an existing one.

  1. Find the public business you want to display using the integrated business search.
  2. Select the business and customize the widget using the visual builder.
  3. Configure the layout, review template, header, dimensions, colors and other display options as needed.

After creating the widget, its shortcode is displayed in the widgets list. Copy this shortcode and place it where you want the widget to appear on your Joomla website.

🛡️ GDPR-Friendly Media Loading

Google Reviews Pro includes GDPR-Friendly Media Loading, which allows review media to be downloaded and served from your own website server instead of being loaded directly from Google servers in your visitors' browsers.

To enable it, open Components > Google Reviews Pro > Options, find Media Display Mode and select GDPR-Friendly Media Loading.

When this mode is enabled, Google Reviews Pro does not make browser requests to Google servers for loading review media on behalf of your website visitors.

🔗 Shortcode

Open Components > Google Reviews Pro to see the list of your existing widgets.

The shortcode for each widget is displayed in the Shortcode column. Copy the shortcode and paste it where you want the widget to appear.

You can place the shortcode inside Joomla article content, a Custom HTML module or your template files.

🌐 Translation

Quick Extension Translation

If you only need to translate labels displayed by the widget, you can use Joomla Language Overrides.

The language constants available for override include:

  • COM_GOOGLEREVIEWSPRO_RATED_BY
  • COM_GOOGLEREVIEWSPRO_SHOW_MORE
  • COM_GOOGLEREVIEWSPRO_SHOW_LESS
  • COM_GOOGLEREVIEWSPRO_NO_REVIEWS_FOUND
  • COM_GOOGLEREVIEWSPRO_RATE_REQUEST_TEXT
  • COM_GOOGLEREVIEWSPRO_YES
  • COM_GOOGLEREVIEWSPRO_NO
  • COM_GOOGLEREVIEWSPRO_LOAD_MORE
  • COM_GOOGLEREVIEWSPRO_TIME_PASSED

To create a language override:

  1. Open System > Manage > Language Overrides.
  2. Select the required administrator language.
  3. Click New.
  4. Copy the required constant and paste it into the Language Constant field.
  5. Enter the translated text in the Text field.
  6. Select For Both Locations.
  7. Click Save & Close.

Repeat these steps for each language constant you want to override.

Full Extension Translation

To translate the complete extension, copy and translate its language files. Google Reviews Pro uses the following files:

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

For example, to create an Italian translation:

  1. Copy the English language files.
  2. Rename them to it-IT.com_googlereviewspro.ini and it-IT.com_googlereviewspro.sys.ini.
  3. Translate the text values into Italian without changing the language constants.
  4. Place the translated files in /administrator/language/it-IT/.