gmb-widget

v1.0.1

Published

2 months ago

Embeddable Google My Business (GMB) review widget. Display live reviews on any website with smooth scrolling.

0High
0Medium
0Low

janamahadev14

gmb google reviews review widget slider embeddable widget

🚀 GMB Widget (Google My Business Review Widget)

Display your Google My Business (GMB) reviews on your website easily using a lightweight JavaScript widget.

Just add one div + one script, and your reviews will appear automatically with smooth scrolling.

👨‍💻 About the Developer

✨ Features

✅ Show real GMB reviews on any website
✅ Smooth horizontal auto-scrolling
✅ Show limited number of reviews at a time
✅ Filter by star rating (min / max)
✅ Sort by latest or oldest
✅ Fully responsive layout
✅ No external CSS required
✅ Lightweight & fast
✅ Easy integration

📦 Installation

🔹 Using CDN (Recommended)

<script src="https://cdn.jsdelivr.net/npm/[email protected]/gmb-widget.js"></script>

⚙️ Usage

1️⃣ Add Container

<div id="campaigningtool"></div>

2️⃣ Add Configuration

<script>
  window.CampaigningToolConfig = {
    url: "https://api.campaigningtool.com/api/gmb/get-review/NA==/MjM=",
    limit: 4
  };
</script>

3️⃣ Load Script

<script src="https://cdn.jsdelivr.net/npm/[email protected]/gmb-widget.js"></script>

🧩 Full Example

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>GMB Review Widget</title>
</head>
<body>

  <div id="campaigningtool"></div>

  <script>
    window.CampaigningToolConfig = {
      url: "https://api.campaigningtool.com/api/gmb/get-review/NA==/MjM=",
      limit: 4
    };
  </script>

  <script src="https://cdn.jsdelivr.net/npm/[email protected]/gmb-widget.js"></script>

</body>
</html>

📊 API Response Format

{
  "status": true,
  "data": [
    {
      "reviewer_name": "John Doe",
      "profile_picture": "https://example.com/image.jpg",
      "rating_number": 5,
      "message": "Great service!",
      "created_at": "2024-01-01"
    }
  ]
}

⚡ Configuration Options

| Option | Type | Default | Description | | ------ | ------ | -------- | ----------------------- | | url | string | required | API endpoint | | limit | number | 3 | Number of visible cards | | speed | number | 60 | Scroll speed |

🚨 Common Issues

❌ Widget not showing → Check container ID (campaigningtool)
❌ Empty reviews → API must return status: true
❌ Broken images → Ensure valid profile_picture URL
❌ No scrolling → Data array empty

🔥 Future Improvements

Pause on hover
Dark mode support
Custom themes
Vertical slider option
Pagination support

📄 License

⭐ Support

If you like this project, please ⭐ star the repository and share it!