Download the PHP package nicxonsolutions/google-reviews without Composer
On this page you can find all versions of the php package nicxonsolutions/google-reviews. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download nicxonsolutions/google-reviews
More information about nicxonsolutions/google-reviews
Files in nicxonsolutions/google-reviews
Package google-reviews
Short Description Laravel Google Reviews widget powered by Google Business Profile OAuth, with Blade, Livewire, Vue, React, and web component starters.
License GPL-2.0-or-later
Homepage https://github.com/robertnicjoo/google-reviews
Informations about the package google-reviews
Nicxon Google Reviews for Laravel
Production-ready Laravel package for displaying Google Reviews using multiple drivers, including Google Business Profile OAuth as the default integration method.
Unlike traditional Google Places integrations, the default driver does not require:
- Google Maps Platform billing
- A Google Maps API key
- A Google Place ID
- Credit card setup
The package is designed for:
- Laravel Blade
- Livewire
- Vue
- React
- Alpine.js
- Web Components
- Headless/API usage
Table of Contents
- Features
- Requirements
- Installation
- Configuration
- Drivers
- Business Profile Driver
- Places API Driver
- Nicxon Connector Driver
- Blade Usage
- Livewire Usage
- JSON API Endpoint
- Vue Integration
- React Integration
- Web Component Integration
- Styling
- Caching
- Error Handling
- Security Notes
- Production Recommendations
- Publishing Assets
- Troubleshooting
- License
Features
- Google Business Profile OAuth integration
- No Google Maps billing required by default
- Automatic caching and stale fallback support
- Blade component support
- Livewire component support
- Vue starter component
- React starter component
- Web Component support
- JSON API endpoint
- Scoped CSS styling
- Graceful error handling
- Multi-location support
- Laravel 10, 11, 12, and 13 compatibility
Requirements
- PHP 8.2+
- Laravel 10+
- A Google account with access to a Google Business Profile
- OAuth credentials for Google Business Profile APIs
Official Google documentation:
- https://developers.google.com/my-business/content/review-data
- https://developers.google.com/my-business/reference/rest/v4/accounts.locations.reviews/list
Installation
Install the package:
Publish configuration:
Optional asset publishing:
For local/path repository installation and OAuth walkthroughs, see:
Configuration
Add the following variables to your .env file.
Drivers
Business Profile Driver (Default)
Recommended for most websites.
Notes
GOOGLE_BUSINESS_PROFILE_LOCATION is optional.
If omitted, the package automatically uses the first accessible Business Profile location.
For multi-location accounts:
This value is a Google Business Profile location identifier, not a Google Maps Place ID.
Places API Driver
Optional official Google Places API integration.
Important
This driver requires:
- Google Cloud Platform
- Places API enabled
- Billing enabled on the Google Cloud account
Nicxon Connector Driver (Future)
Reserved for future hosted integrations.
Currently this driver returns a friendly setup message until the hosted service becomes available.
Blade Usage
Render the default widget:
Specify a Business Profile location:
Livewire Usage
If livewire/livewire is installed, the package automatically registers:
JSON API Endpoint
The package exposes a resilient frontend endpoint.
Endpoints:
Example response:
Failure response example:
The endpoint never exposes raw Google API exceptions directly to frontend users.
Vue Integration
Publish assets:
Published Vue component:
Usage example:
React Integration
Published React component:
Usage example:
Web Component Integration
Published web component:
Usage:
With a specific location:
Styling
The package automatically serves scoped widget CSS:
Benefits
- No Tailwind dependency required on host applications
- Styles are scoped under
.nxgr - Prevents style leakage into the host website
Source CSS entry:
Caching
The package caches successful review responses automatically.
Environment variables:
Cache Strategy
- Fresh cache reduces Google API requests
- Stale fallback improves uptime during outages
- Improves performance and page speed
Error Handling
The package gracefully handles:
- Missing OAuth credentials
- Invalid refresh tokens
- Unauthorized Google accounts
- Missing Business Profile locations
- Google API outages
- Timeouts
- Rate limits
- Empty review responses
By default, production pages fail quietly.
Enable visible diagnostics during development:
Security Notes
Never commit sensitive credentials into source control.
Recommended:
- Store OAuth credentials in
.env - Rotate refresh tokens periodically
- Restrict Google OAuth applications properly
- Use HTTPS in production environments
Production Recommendations
Recommended production setup:
- Enable Laravel cache
- Use Redis or Memcached
- Cache reviews aggressively
- Serve widgets via CDN if needed
- Enable stale fallback support
- Queue review refreshes for high-traffic websites
Recommended cache drivers:
Publishing Assets
Publish package assets:
Publish configuration:
Troubleshooting
Route Not Defined
If you encounter:
Ensure package routes are loaded before route generation.
Run:
Widget Not Showing Reviews
Verify:
- OAuth credentials are valid
- Refresh token is active
- Business Profile access exists
- Location identifier is correct
Livewire Component Missing
Install Livewire:
License
Licensed under GPL-2.0-or-later.
Copyright © PT. Nicxon International Solutions
All versions of google-reviews with dependencies
illuminate/cache Version ^10.0|^11.0|^12.0|^13.0
illuminate/contracts Version ^10.0|^11.0|^12.0|^13.0
illuminate/http Version ^10.0|^11.0|^12.0|^13.0
illuminate/routing Version ^10.0|^11.0|^12.0|^13.0
illuminate/support Version ^10.0|^11.0|^12.0|^13.0
illuminate/view Version ^10.0|^11.0|^12.0|^13.0