Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pixel-open/sulu-reviewbundle
A bundle to display customer reviews for the Sulu CMS. Reviews can be retrieved automatically from Google My Business.
https://github.com/pixel-open/sulu-reviewbundle
google-my-business reviews-customers sulu sulu-bundle
Last synced: 29 days ago
JSON representation
A bundle to display customer reviews for the Sulu CMS. Reviews can be retrieved automatically from Google My Business.
- Host: GitHub
- URL: https://github.com/pixel-open/sulu-reviewbundle
- Owner: Pixel-Open
- Created: 2023-12-07T09:29:26.000Z (about 1 year ago)
- Default Branch: develop
- Last Pushed: 2024-05-21T15:59:24.000Z (7 months ago)
- Last Synced: 2024-11-02T04:53:45.505Z (about 2 months ago)
- Topics: google-my-business, reviews-customers, sulu, sulu-bundle
- Language: PHP
- Homepage:
- Size: 155 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- Changelog: changelog.md
Awesome Lists containing this project
README
# Sulu Review bundle
[](https://sulu.io/)
## Presentation
A bundle to display customer reviews for the Sulu CMS.
Reviews can be retrieved automatically from Google My Business.
## Requirements
* PHP >= 8.0
* Composer
* Sulu >= 2.5.*
* Symfony >= 5.4
## Features
* Display reviews on the website
* Settings management
* Possibility to retrieve reviews from Google My Business
## Installation
### Install the bundle
Execute the following [composer](https://getcomposer.org/) command to add the bundle to the dependencies of your
project:
```bash
composer require pixelopen/sulu-reviewbundle
```
### Enable the bundle
Enable the bundle by adding it to the list of registered bundles in the `config/bundles.php` file of your project:
```php
return [
/* ... */
Pixel\ReviewBundle\ReviewBundle::class => ['all' => true],
];
```
### Update schema
Use a doctrine migration for this.
## Bundle Config
Define the Admin Api Route in `routes_admin.yaml`
```yaml
review.reviews_api:
type: rest
prefix: /admin/api
resource: pixel_review.reviews_route_controller
name_prefix: review.
review.setting_api:
type: rest
prefix: /admin/api
resource: pixel_review.settings_route_controller
name_prefix: review.
```
## Use
### Add/Edit a review
Go to the "Reviews" section in the administration interface. Then, click on "Add".
Fill the fields that are needed for your use.
Here is the list of the fields:
* Customer name (mandatory)
* Review date (mandatory)
* Rating (mandatory)
* Message (Mandatory)
* Retrieve from Google My Business? (Read only. Allows you to know if the review was automatically picked up from Google)
* Customer image
Once you finished, click on "Save"
To edit a review, simply click on the pencil at the left of the review you wish to edit.
## Remove/Restore a gallery
There are two ways to remove a review:
* Check every review you want to remove and then click on "Delete"
* Go to the detail of a review (see the above section) and click on "Delete".
In both cases, the review will be put in the trash.
To access the trash, go to the "Settings" and click on "Trash".
To restore a review, click on the clock at the left. Confirm the restore. You will be redirected to the detail of the review you restored.
To remove permanently a review, check all the reviews you want to remove and click on "Delete".
## Settings
This bundle comes with settings. Here the list of the different settings available:
* Total reviews (mandatory)
* Average rating (mandatory)
* Use Google rating?
* Retrieve Google review?
* Place ID
* API key
The total reviews and the average rating must be filled manually unless you use the Google rating.
The option "Use Google rating?" allows you to pick up the total rating and the average rating from Google.
If you want to retrieve the reviews as well, check the "Retrieve Google review?" checkbox.
If you decide to use the reviews information from Google, you will need to fill the place ID and the API key.
Once that is done, run the following command:
```bash
bin/console sync:google:rating
```
## Twig function
There are several twig function in order to help you use the reviews and the settings on your website:
**get_latest_reviews(limit)**: returns the latest reviews. It takes one parameter:
* limit: represents the number of the latest reviews to display. If no limit is provided, the default value is 3.
Example of use:
```twig
{% set reviews = get_latest_reviews(4) %}
{% for review in reviews %}
{{ review.message|raw }}
{{ review.name }} - {{ review.rating }}/5
{% endfor %}
```
**get_latest_reviews_html(limit)**: do the same thing as get_latest_reviews() but it renders a view instead. It takes one parameter:
* limit: represents the number of the latest reviews to display. If no limit is provided, the default value is 3.
Example of use:
```twig
{{ get_latest_reviews_html(4) }}
```
**reviews_settings()**: returns the settings of the bundle. No parameters are required.
Example of use:
```twig
{% set reviewsSettings = reviews_settings() %}
{% if reviewsSettings is not null %}
Note : {{ reviewsSettings.averageRating }}
%20}})
-
More than {{ reviewsSettings.totalRating }} reviews
{% endif %}
```
## Contributing
You can contribute to this bundle. The only thing you must do is respect the coding standard we implements.
You can find them in the `ecs.php` file.