Download the PHP package tributemedia/google_reviews_testimonials without Composer

On this page you can find all versions of the php package tributemedia/google_reviews_testimonials. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package google_reviews_testimonials

Google Reviews Testimonials

Summary

This Drupal 9 module provides the ability for the system to download reviews from Google My Business (GMB) and convert them to Tribute Media's testimonial entities.

Features

Installation & Configuration

This is a Drupal 9 module, and contains code that may not exist in Drupal 8. Use in Drupal 9 only!

Make sure Tribute Media Testimonial module is installed before attempting to install this. Afterwards, simply install this module the same you would any other composer managed module in Drupal:

composer require tributemedia/google_reviews_testimonials

After installation, go to Configuration -> Web services -> GMB Service Connection Settings. Provide the service key (obtained from the Google admin console), and subject (email of a user within the organization authorized to use the service account). Then, click the save button and the disabled field for 'Account' should now be filled in with a value.

Next, navigate to Configuration -> Web services -> GMB Location Settings. Provide the name of the business as shown in Google My Business for 'Location Name' field. Also, change the 'Star Minimum' if you do not like the default value of 3. Any review that has the amount of stars specified in this field, or greater, will be downloaded and published as a testimonial. Once this has been completed, click the save button, and now the 'Location ID' field should have a value.

Once all the above steps have been completed, you'll need to configure the field_testimonials_num_stars field as desired on any and all displays, including the testimonial node form display.

Usage

Make sure the steps outlined in the configuration section above have been completed! Once that is done, then all you have to do is simply wait until the next Cron run for the first automatic download of reviews. If you do not want to wait, you may manually start a Cron run by going to Configuration -> System -> Cron. If your business has a lot of reviews, they may not all get downloaded and created on the first run. Feel free to run Cron again until all reviews that meet the minimum star threshold are downloaded and created into testmonials.

If you want to manually start a download, you can go to Configuration -> Web services -> Google Reviews Testimonials Status. From this page you'll be able to see the status of current queues, and manually queue work. To run the work, simply run Cron.

Cron Workflow

This is a high-level, but technically detailed breakdown of the entire Cron workflow pipeline, from review download to testimonial creation. If you're seeking information on how, in particular, the Cron workflow of the module is working, then read on.

Trigger Review Check

No queue, cron job defined in module file

Run Interval: 12 hours

The first step in the workflow. This cron job is different from the others in that it is not done by QueueWorker. The one purpose of this cron job is simple: Queue a job to the worker for the next step, checking for new reviews. No value is provided for pageToken when a job is queued by this worker, which will result in the review checker getting the first page of reviews on its first run. Naturally, this is what we always want on our first run.

New Review Check

Queue ID: google_reviews_testimonials_rcq (rcq = Review Check Queue)

Run Time: 30 seconds

Parameters:

pageToken (string) - Pagination value that must be provided to the API to retrieve the next set of reviews, if applicable. OPTIONAL.

Next, a list of 20 GMB reviews for the configured location is queried from the API. If there is no TestimonialGMBReviewEntity with a reference to the ID of the review, then a new job is created for the worker of the next step, to create new testimonials.

This step is repeated for each review ID retrieved from the API. If there are more reviews than the 20 retrieved in the first query, a new job is created for the worker of this queue, using the pageToken provided by the API as the parameter. Since this is a separate job, it will not be processed until the next run of Cron. This step, naturally, repeats until every review has been checked from the API, no matter how many paginations are required.

Testimonial Creation & Review Link

Queue ID: google_reviews_testimonials_rlq (rlq = Review Link Queue)

Run Time: 30 seconds

Parameters:

reviewID (string) - ID of the review. REQUIRED.

displayName (string) - Google display name of the reviewer. REQUIRED.

starRating (int) - Star rating. REQUIRED.

comment (string) - The review (comment, as its called in GMB). REQUIRED.

The last step in this workflow. It starts by creating a new testimonial with the details specified above (note that there is no location of the reviewer, that is not provided by the API). The comment is trimmed to less than 150 characters for the summary of the testimonial, if necessary. Otherwise, the comment is used for both the summary and review fields of the testimonial.

Once the testimonial is created, a TestimonialGMBReviewEntity is also created, to link the association of the testimonial and GMB review.

Finally, based on the star count of the review and the minimum star threshold in the module settings, the testimonial may or may not be published. If the star rating is equal to or greater than the module setting, the testimonial is published. Otherwise, it is unpublished.

Contribution Guidelines

When contributing to the module, create a branch from dev that contains the issue number related to the bug or feature you're working on. Do not create the branch off of master! From there, make your changes in your branch and integrate into the dev branch when you feel it's ready for testing. Testing can then be done and a code review, if desired. Your change will then be ready for the next release, once approved.

All versions of google_reviews_testimonials with dependencies

PHP Build Version
Package Version
Requires google/apiclient Version ~2.12
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package tributemedia/google_reviews_testimonials contains the following files

Loading the files please wait ....