PHPackages                             emplify-software/statamic-google-reviews - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. emplify-software/statamic-google-reviews

ActiveLibrary

emplify-software/statamic-google-reviews
========================================

v2.0.0(1mo ago)3614↓100%2MITPHP

Since May 28Pushed 1mo agoCompare

[ Source](https://github.com/emplify-software/statamic-google-reviews)[ Packagist](https://packagist.org/packages/emplify-software/statamic-google-reviews)[ RSS](/packages/emplify-software-statamic-google-reviews/feed)WikiDiscussions main Synced today

READMEChangelog (3)Dependencies (3)Versions (5)Used By (0)

Statamic Google Reviews
=======================

[](#statamic-google-reviews)

[![Statamic v6](https://camo.githubusercontent.com/f5da75a380a54dfac7b1573728199bc0ae2aa2d93facf29730f13e123cba7146/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53746174616d69632d362e302d4646323639453f7374796c653d666f722d7468652d6261646765266c696e6b3d68747470733a2f2f73746174616d69632e636f6d)](https://statamic.com)

Display Google Reviews on your Statamic site using the Google Places API.

Features
--------

[](#features)

This Statamic addon fetches Google customer reviews for one or multiple locations using the Google Places API.

Note

This addon does not require the Google My Business API, which makes it easier to set up and use.

✅ Simple configuration
✅ Supports multiple locations
✅ Reviews are cached in a collection
✅ Manual review editing and removal
✅ No client-side API calls to Google - GDPR compliant

🛠️ How to Install
-----------------

[](#️-how-to-install)

You can search for this addon in the `Tools > Addons` section of the Statamic control panel and click **install**, or run the following command from your project root:

```
composer require emplify-software/statamic-google-reviews
```

After the addon is installed, publish the configuration file, blueprints and collections for the addon by running:

```
php artisan vendor:publish --tag=statamic-google-reviews
```

After running the publish command, you will find the configuration file at `config/statamic-google-reviews.php`. Since you can define all configuration options in the `.env` file (see [Configuration](#configuration)), you normally do not need to edit the configuration file directly. A new collection called `Google Reviews` will also be created, as well as a new taxonomy called `Google Review Places`.

💡 How to Use
------------

[](#-how-to-use)

### Generating an API Key for Google Places API

[](#generating-an-api-key-for-google-places-api)

1. Use an existing Google Cloud project or create a new one at [Google Cloud Console](https://console.cloud.google.com/).
2. Create a new API key for the project:
    - Go to the [Google Maps Platform &gt; Credentials](https://console.cloud.google.com/project/_/google/maps-apis/credentials) section and select the project.
    - Click **Create credentials** and select **API key**.
    - Under **API restrictions**, select **Places API** or **Places API (New)**.
    - The API key will be displayed on the screen.

### Configuration

[](#configuration)

1. Add your Google Places API key to the `.env` file:

    ```
    GOOGLE_REVIEWS_API_KEY=your-api-key
    ```
2. Reviews can be retrieved with translated texts. Per default, the current app locale is used as the language for the reviews. If you want to use a different language, set `GOOGLE_REVIEWS_LANGUAGE` in the `.env` file:

    ```
    GOOGLE_REVIEWS_LANGUAGE=de
    ```
3. If you are using the legacy "Places API" (not "Places API (New)"), set `GOOGLE_REVIEWS_LEGACY_API` to `true` in the `.env` file:

    ```
    GOOGLE_REVIEWS_LEGACY_API=true
    ```

### Adding Places

[](#adding-places)

The addon automatically generates a taxonomy called `Google Review Places`. To register a new place, follow these steps:

1. Go to `Taxonomies > Google Review Places` in the control panel
2. Click **Create Term**
3. Enter a name for the place. You can name it whatever you want, e.g. "My Restaurant" or "Berlin Office".
4. Enter the Google Place ID for the location. You can find the Place ID by searching for the location on the [Place ID Finder](https://developers.google.com/maps/documentation/javascript/examples/places-placeid-finder).
5. Click **Save &amp; Publish**
6. The latest reviews for the new place will automatically be fetched after saving the term. If the place has reviews, you will now see them under `Collections > Google Reviews` in the control panel.

### Fetching Reviews

[](#fetching-reviews)

You can manually fetch the reviews for all registered places by running the following command:

```
php artisan emplify-software:google-reviews:crawl
```

### Scheduling Review Fetching

[](#scheduling-review-fetching)

To keep the reviews up-to-date, you can set up a scheduled task to automatically fetch the reviews at regular intervals. Like any other command, you can schedule the `emplify-software:google-reviews:crawl` command in the console kernel:

```
// app/Console/Kernel.php
protected function schedule(Schedule $schedule)
{
    $schedule->command('emplify-software:google-reviews:crawl')->daily();
}
```

If you are using Laravel 11 or later, you can also directly add the schedule command to the `routes/console.php` file:

```
// routes/console.php
use Illuminate\Support\Facades\Schedule;

Schedule::command('emplify-software:google-reviews:crawl')->daily();
```

If the crawling command fails, it will return an error code, which can be handled in the scheduler if needed:

```
$schedule
    ->command('emplify-software:google-reviews:crawl')->daily()
    ->onFailure(function () {
        // Handle the failure, e.g. send a notification
    });
```

### Removing and editing reviews

[](#removing-and-editing-reviews)

The reviews are stored in a collection called `Google Reviews` (`Collections > Google Reviews`). To remove a review, simply unpublish it.

Note

Do not completely delete reviews from the collection. Deleted reviews will be re-fetched on the next crawl.

It is also possible to edit the review content in the entry (e.g. to fix spelling mistakes or adjust the translation). To make sure the review is not overwritten on the next crawl, activate the `Manual Override` switch for the entry.

### Displaying Reviews

[](#displaying-reviews)

You can display the reviews on your site by iterating over the `Google Reviews` collection using the `collection:google-reviews` tag:

```
{{ collection:google-reviews }}

            Author: {{ author_name }}

            Rating: {{ rating }}

            Time: {{ time }}

            Text: {{ text }}

            Place: {{ place['title'] }}

{{ /collection:google-reviews }}
```

Since the reviews are stored in a collection, you can also use the collection tag to filter and sort the reviews as needed (See ).

*Example: Only display the reviews for a specific place:*

```
{{ collection:google-reviews place:is="location-a" }}
    ...
{{ /collection:google-reviews }}
```

🎛️ Control Panel Utility
------------------------

[](#️-control-panel-utility)

Under `Utilities > Google Reviews`, you can see the current status of the review crawlers. With the "Update Reviews" button, you can also manually trigger a fetch of all reviews.

Additionally, you can see a list of all registered places. If a place ID is incorrect or if the reviews could not be fetched for some other reason, an error message will be displayed for the place. You can also see how many reviews are locally stored for each place and how many reviews are actually available on Google (see [Known Issues](#-known-issues)).

[![](resources/img/cp-screenshot.png)](resources/img/cp-screenshot.png)

⚠️ Known Issues
---------------

[](#️-known-issues)

- Due to a limitation in the Google Places API, only the last 5 reviews can be fetched. This is not a problem for new reviews, because all reviews are fetched and stored in the collection. However, if you already have more than 5 reviews on a place and you add it to the addon, only the last 5 reviews will be fetched. If you also want to display older reviews, you can manually add them to the `Google Reviews` collection.
- When using the "Places API (New)", it can also no longer be guaranteed that all new reviews will be fetched. This is due to the fact that the new Places API does not return the latest reviews, but only a selection of reviews that are considered relevant by Google.

###  Health Score

43

—

FairBetter than 91% of packages

Maintenance93

Actively maintained with recent releases

Popularity22

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 Bus Factor1

Top contributor holds 50% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~88 days

Total

4

Last Release

34d ago

Major Versions

v1.0.1 → v2.0.02026-02-17

### Community

Maintainers

![](https://www.gravatar.com/avatar/53310480c19dec41a814b06e182cac7f30a72a13c08179b17bca61230d09db17?d=identicon)[emplify software GmbH](/maintainers/emplify%20software%20GmbH)

---

Top Contributors

[![benStre](https://avatars.githubusercontent.com/u/35869401?v=4)](https://github.com/benStre "benStre (1 commits)")[![doefom](https://avatars.githubusercontent.com/u/33541715?v=4)](https://github.com/doefom "doefom (1 commits)")

### Embed Badge

![Health badge](/badges/emplify-software-statamic-google-reviews/health.svg)

```
[![Health](https://phpackages.com/badges/emplify-software-statamic-google-reviews/health.svg)](https://phpackages.com/packages/emplify-software-statamic-google-reviews)
```

###  Alternatives

[statamic/statamic

Statamic

824167.6k](/packages/statamic-statamic)[statamic-rad-pack/runway

Eloquently manage your database models in Statamic.

135180.6k3](/packages/statamic-rad-pack-runway)[tdwesten/statamic-builder

A fluent blueprint and fieldset builder for Statamic.

369.6k1](/packages/tdwesten-statamic-builder)[edalzell/forma

Give control panel access to your addon's config

1070.9k9](/packages/edalzell-forma)[mitydigital/feedamic

A fully-featured RSS and Atom feed generator for Statamic.

1060.9k](/packages/mitydigital-feedamic)[nfragkos/eloquenty

Statamic addon that allows you to store specific collection entries into the database via Eloquent.

109.0k](/packages/nfragkos-eloquenty)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
