oveleon / contao-google-recommendation-bundle
Google Places API integration for Contao Recommendation Bundle
Fund package maintenance!
oveleon
Installs: 2 151
Dependents: 0
Suggesters: 1
Security: 0
Stars: 5
Watchers: 4
Forks: 2
Open Issues: 0
Type:contao-bundle
Requires
- php: ^8.1
- contao/core-bundle: ^4.13 || ^5.1
- oveleon/contao-recommendation-bundle: ^1.3
Requires (Dev)
- contao/manager-plugin: ^2.3.1
- contao/test-case: ^5.1
- phpunit/phpunit: ^9.5
- symfony/http-client: ^5.4 || ^6.0
- symfony/phpunit-bridge: ^5.4 || ^6.0
Conflicts
- contao/core: *
- contao/manager-plugin: <2.0 || >=3.0
README
Syncs your latest google reviews into the contao recommendation bundle.
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
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.
Limitations
- 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.
- 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.
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:
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