oveleon/contao-google-recommendation-bundle

Google Places API integration for Contao Recommendation Bundle

Fund package maintenance!
oveleon

Installs: 1 610

Dependents: 0

Suggesters: 1

Security: 0

Stars: 5

Watchers: 4

Forks: 2

Open Issues: 1

Type:contao-bundle

1.3.0 2023-06-01 17:48 UTC

This package is auto-updated.

Last update: 2024-05-22 08:26:21 UTC


README

Syncs your latest google reviews into the contao recommendation bundle.

Oveleon 68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d3833616130653f7374796c653d666c61742d737175617265 68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f76656c656f6e2f636f6e74616f2d676f6f676c652d7265636f6d6d656e646174696f6e2d62756e646c653f636f6c6f723d304137424243267374796c653d666c61742d737175617265


Working with Contao 4.13 and Contao 5.1 (PHP ^8.1)

This plugin adds the possibility to synchronize your Google reviews into your recommendation archives.

Features

  • Able to synchronize your google reviews into a recommendation archive
  • Able to choose the sync language for your google reviews
  • Cache invalidation after import
  • Automatic import once every 24 hours
  • Manual synchronization for one or all archives
  • Error logging

Installation

Via composer

composer require oveleon/contao-google-recommendation-bundle

Via contao-manager

Search for contao google recommendation bundle and add it to your extensions.

After installing the contao-google-recommendation-bundle, you need to run a contao install.

Setup

This bundle adds new fields to Contao Recommendation Bundle.

Contao Recommendation Bundle

For a full setup, please look here.

Archive settings

Google Reviews
Option Description
Sync with Google Activate to enable synchronization with Google API
Google API Token Your Google API Token. More information on Google: Using API keys
Google Places ID Your Google Place ID. More information on Google: Place IDs
Language Here you can select the imported language for your reviews. More information on Google: Language Support

Admin View: Recommendation Reader

Synchronization

All archives with enabled synchronization will update once every 24 hours. You are able to trigger the synchronization for each archive or for all archives.

Admin View: Recommendation Sync

Limitations

  1. Currently, the Google API only allows to retrieve the last 5 reviews. This should be sufficient for daily synchronization, but does not allow an initial import of all available ratings.
  2. The extension currently only allows the import of reviews with an entered text. If there is no text vavailable, the importer will skip the review.

Google

You may encounter issues regarding using the Google Places API so follow the following steps to enable it and allow the usage of the API-Key:

Error message Solution
API keys with referer restrictions cannot be used with this API Enable the google places API: https://developers.google.com/maps/documentation/javascript/places
You must enable Billing... Enable billing for your Google Account

Also make sure that your API-Key for the Places-API is usable by your server (IP-Address) and do not lock it to a URL (The cronjob doesn't work via URL but the IP). For billing issues, make sure that you have to verify your payment method via https://payments.google.com/gp/w/home/paymentmethods as well.

Any issues regarding setting up the Google API will be closed without an answer. Please read the google docs.

Example

An example how to style your reviews on your website

Admin View: Recommendation Example