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

TypePublic route behavior
mapLoads map CSS, widget JSON, Radar/Google Maps bridge script, and map markers.
project-galleryInjects server-rendered gallery HTML into the host page.
review-feedInjects server-rendered review-feed HTML into the host page.

Creating A Widget

  1. Open /admin/widgets.
  2. Create a widget and give it a clear internal name.
  3. Choose the type.
  4. Assign a location.
  5. Set the minimum rating.
  6. Save the widget.
  7. 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

WidgetRequired source data
MapLocation coordinates and project geolocation.
Project galleryProjects with media and qualifying linked reviews.
Review feedReviews 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.