Widgets
How public embeds publish reviews, projects, and maps.
Widgets are public embed configurations. Each widget has a UUID, name, type, location, filters, and minimum rating.
Types
| Type | Public route behavior |
|---|---|
map | Loads map CSS, widget JSON, Radar/Google Maps bridge script, and map markers. |
project-gallery | Injects server-rendered gallery HTML into the host page. |
review-feed | Injects server-rendered review-feed HTML into the host page. |
Creating A Widget
- Open
/admin/widgets. - Create a widget and give it a clear internal name.
- Choose the type.
- Assign a location.
- Set the minimum rating.
- Save the widget.
- Copy the embed script for
/widget/{widget}/embed.js.
Embed Route
Use this script on a public website:
<script src="https://review-manager.test/widget/{widget}/embed.js" async></script>
Replace {widget} with the widget UUID.
Readiness Checklist
| Widget | Required source data |
|---|---|
| Map | Location coordinates and project geolocation. |
| Project gallery | Projects with media and qualifying linked reviews. |
| Review feed | Reviews with text and rating at or above the widget minimum. |
Map marker coordinates are intentionally skewed slightly before display so public maps do not expose exact customer addresses.