{"id":27270207,"url":"https://github.com/oveleon/contao-google-recommendation-bundle","last_synced_at":"2025-08-03T06:08:59.487Z","repository":{"id":47235522,"uuid":"210288648","full_name":"oveleon/contao-google-recommendation-bundle","owner":"oveleon","description":"This bundle imports Google reviews into the contao-recommendation-bundle","archived":false,"fork":false,"pushed_at":"2024-02-22T08:02:08.000Z","size":78,"stargazers_count":5,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-20T16:49:09.034Z","etag":null,"topics":["contao","contao-bundle","google","rating","recommendation","reviews"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oveleon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null},"funding":{"github":"oveleon","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2019-09-23T07:14:20.000Z","updated_at":"2024-05-31T18:53:06.000Z","dependencies_parsed_at":"2022-09-17T06:43:11.091Z","dependency_job_id":"7103b52f-214b-4a9b-9d1b-cbd1e99de6b1","html_url":"https://github.com/oveleon/contao-google-recommendation-bundle","commit_stats":{"total_commits":28,"total_committers":6,"mean_commits":4.666666666666667,"dds":0.4642857142857143,"last_synced_commit":"0cf9843203fa3ffce5e0bed00eac8da868e8d76e"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oveleon%2Fcontao-google-recommendation-bundle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oveleon%2Fcontao-google-recommendation-bundle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oveleon%2Fcontao-google-recommendation-bundle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oveleon%2Fcontao-google-recommendation-bundle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oveleon","download_url":"https://codeload.github.com/oveleon/contao-google-recommendation-bundle/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248397658,"owners_count":21097150,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["contao","contao-bundle","google","rating","recommendation","reviews"],"created_at":"2025-04-11T12:09:28.659Z","updated_at":"2025-04-11T12:09:29.135Z","avatar_url":"https://github.com/oveleon.png","language":"PHP","funding_links":["https://github.com/sponsors/oveleon"],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eContao Google Recommendation Bundle\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\u003ci\u003eSyncs your latest google reviews into the contao recommendation bundle.\u003c/i\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://www.oveleon.de\"\u003e\u003cimg src=\"https://img.shields.io/badge/oveleon-maintained-83aa0e?style=flat-square\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABMAAAAUCAYAAABvVQZ0AAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAA/xpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuNi1jMTQ1IDc5LjE2MzQ5OSwgMjAxOC8wOC8xMy0xNjo0MDoyMiAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wTU09Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9tbS8iIHhtbG5zOnN0UmVmPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvc1R5cGUvUmVzb3VyY2VSZWYjIiB4bWxuczp4bXA9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC8iIHhtbG5zOmRjPSJodHRwOi8vcHVybC5vcmcvZGMvZWxlbWVudHMvMS4xLyIgeG1wTU06T3JpZ2luYWxEb2N1bWVudElEPSJ1dWlkOjVEMjA4OTI0OTNCRkRCMTE5MTRBODU5MEQzMTUwOEM4IiB4bXBNTTpEb2N1bWVudElEPSJ4bXAuZGlkOjM5MjZBNjQzMzZFQjExRUFBMTdBQkNFQTAxNjg2RDI4IiB4bXBNTTpJbnN0YW5jZUlEPSJ4bXAuaWlkOjM5MjZBNjQyMzZFQjExRUFBMTdBQkNFQTAxNjg2RDI4IiB4bXA6Q3JlYXRvclRvb2w9IkFkb2JlIElsbHVzdHJhdG9yIENTNiAoV2luZG93cykiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0idXVpZDplMDhkZDhmZC1mOTA4LTQ5YzItYWMwZC00OGE3YTI4ODc2YWEiIHN0UmVmOmRvY3VtZW50SUQ9InhtcC5kaWQ6OTA2RDhGOENERUQxRTgxMTgyMjVBMzBGQ0NBNjE4RUQiLz4gPGRjOnRpdGxlPiA8cmRmOkFsdD4gPHJkZjpsaSB4bWw6bGFuZz0ieC1kZWZhdWx0Ij5Mb2dvX292ZWxlb25fWmVpY2hlbl9yejwvcmRmOmxpPiA8L3JkZjpBbHQ+IDwvZGM6dGl0bGU+IDwvcmRmOkRlc2NyaXB0aW9uPiA8L3JkZjpSREY+IDwveDp4bXBtZXRhPiA8P3hwYWNrZXQgZW5kPSJyIj8+P8iBTQAAAbFJREFUeNqU08srRFEcB/BromGGaJRHKSIaYfIm7JRSsvHIyuM/wMorNeEfUMqKnbKwU2TBwpSUSWYWFmSBDKWmWcgwcX2Pvrc5HXfuXL/6zD2P3z2Puedouq5rilG40JPxAuUmeX84tGTkwyXsghOWYQmKoFazExzVDXFIgEeazcPV9TCnzGplRiHMl7KgCWYghy9vQAasMEfkTqQarJ9JFWw0YlhJFv2rUv8tdKiDhTib0eiHQyhOsR2xyjlp0BF5MBELdr6WohE++X6raBOz6PwWCfiCOLzDN8sRGICYyfdrgBA8Q2kmfnzQJirghlw+XZANUQ5qFmHY52R9/9lWCXjBpbRPcaubDhtHsRoOuN1reAO/1H/PpzfdaqrggzOLK7YFD6zPMqeL9at0gwWZuKa0i3hkuZf1E6tteqEZnmCRbZVwxPIOn3V83litaogzbrPuhDOIwbyUd8q8SavBOpl0rnxROadFugkFVoOJAx1h4rRJvw9e2b9u3ACrY9ENAZaD/L/E0aiHMbbfQc3v7bFxWAchqptHAAqN3HQrM0JcsXFohzzexWPYk5N+BBgAix5VyvzRZbwAAAAASUVORK5CYII=\" alt=\"Oveleon\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/oveleon/contao-google-recommendation-bundle\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-83aa0e?style=flat-square\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://packagist.org/packages/oveleon/contao-recommendation-bundle\"\u003e\u003cimg src=\"https://img.shields.io/packagist/dt/oveleon/contao-google-recommendation-bundle?color=0A7BBC\u0026style=flat-square\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cbr/\u003e\n\n---\n\n\u003e Working with **Contao 4.13** and **Contao 5.1** (PHP ^8.1)\n\n---\n\nThis plugin adds the possibility to synchronize your Google reviews into your recommendation archives.\n\n+ [Features](#features)\n+ [Installation](#installation)\n    + [Composer](#via-composer)\n    + [Contao Manager](#via-contao-manager)\n+ [Setup](#setup)\n    + [Contao Recommendation Bundle](#contao-recommendation-bundle)\n    + [Archive settings](#archive-settings)\n    + [Syncing with Google](#synchronization)\n        + [Limitations of sync](#limitations)\n+ [Google](#google)\n+ [Styled Reviews](#example)\n\n## Features\n\n- Able to synchronize your google reviews into a recommendation archive\n- Able to choose the sync language for your google reviews\n- Cache invalidation after import\n- Automatic import once every 24 hours\n- Manual synchronization for one or all archives\n- Error logging\n\n## Installation\n\n### Via composer\n```\ncomposer require oveleon/contao-google-recommendation-bundle\n```\n\n### Via contao-manager\n```\nSearch for contao google recommendation bundle and add it to your extensions.\n```\n\n\nAfter installing the contao-google-recommendation-bundle, you need to run a **contao install**.\n\n\n## Setup\n\nThis bundle adds new fields to [Contao Recommendation Bundle](https://github.com/oveleon/contao-recommendation-bundle).\n\n### Contao Recommendation Bundle\nFor a full setup, please look [here](https://github.com/oveleon/contao-recommendation-bundle/blob/master/README.md).\n\n\n### Archive settings\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003cth colspan=\"2\"\u003e\u003cstrong\u003eGoogle Reviews\u003c/strong\u003e\u003c/th\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cstrong\u003eOption\u003c/strong\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cstrong\u003eDescription\u003c/strong\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eSync with Google\u003c/td\u003e\n    \u003ctd\u003eActivate to enable synchronization with Google API\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eGoogle API Token\u003c/td\u003e\n    \u003ctd\u003eYour Google API Token. More information on Google: \u003ca href=\"https://cloud.google.com/docs/authentication/api-keys\"\u003eUsing API keys\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eGoogle Places ID\u003c/td\u003e\n    \u003ctd\u003eYour Google Place ID. More information on Google: \u003ca href=\"https://developers.google.com/maps/documentation/places/web-service/place-id\"\u003ePlace IDs\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eLanguage\u003c/td\u003e\n    \u003ctd\u003eHere you can select the imported language for your reviews. More information on Google: \u003ca href=\"https://developers.google.com/maps/faq#languagesupport\"\u003eLanguage Support\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n![Admin View: Recommendation Reader](https://www.oveleon.de/share/github-assets/contao-google-recommendation-bundle/recommendationGoogleArchive.jpg)\n\n### Synchronization\n\nAll archives with enabled synchronization will update once every 24 hours. You are able to trigger the synchronization for each archive or for all archives.\n\n![Admin View: Recommendation Sync](https://www.oveleon.de/share/github-assets/contao-google-recommendation-bundle/recommendationListSync.jpg)\n\n#### Limitations\n\n1. 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.\n2. 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.\n\n### Google\n\nYou 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:\n\n| Error message                                                   | Solution                                                                                         |\n|-----------------------------------------------------------------|--------------------------------------------------------------------------------------------------|\n| API keys with referer restrictions cannot be used with this API | Enable the google places API: https://developers.google.com/maps/documentation/javascript/places |\n| You must enable Billing...                                      | Enable billing for your Google Account                                                           |\n\nAlso 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).\nFor billing issues, make sure that you have to verify your payment method via https://payments.google.com/gp/w/home/paymentmethods as well.\n\n\u003e Any issues regarding setting up the Google API will be closed without an answer. Please read the google docs.\n\n### Example\n\nAn example how to style your reviews on your website\n\n![Admin View: Recommendation Example](https://www.oveleon.de/share/github-assets/contao-google-recommendation-bundle/recommendationExample.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foveleon%2Fcontao-google-recommendation-bundle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foveleon%2Fcontao-google-recommendation-bundle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foveleon%2Fcontao-google-recommendation-bundle/lists"}