Widgets
Two widget definitions are registered, each with eight layout choices. Drop them onto any widget position from AdminCP > Appearance > Widgets.
Widget definitions
| Definition | Surfaces | Useful positions |
|---|---|---|
| [MC] Search Analytics: Top Searches | Most-searched queries over a configurable window. | Forum sidebar, member home sidebar, footer. |
| [MC] Search Analytics: Unanswered Demand | Recent zero-result searches, optionally with a "start a thread about this" call to action. | Forum sidebar, content above forum list. |
Layouts
Both definitions share the same layout option. Pick the one whose density and visual weight match the host position.
| Layout | Best for |
|---|---|
| List | A dense vertical list. The default. |
| Tag cloud | A weighted phrase cloud sized by frequency. |
| Sparkline | Each row carries a small per-day trend chart. |
| Heatmap | A ranked vertical list with a horizontal intensity bar on each row, sized by relative search volume. |
| Ticker | A rotating spotlight that cycles through up to five queries one at a time. |
| Searchbar | Stacked rows styled like autocomplete suggestions. |
| Editorial | A feature-driven hero with a lead query and call to action, plus up to five "also asked" rows. |
| Stat callout | A single large total number, a supporting lead phrase, and the top five queries beneath. |
Visibility controls
- The View Search Analytics widgets permission gates rendering for the visitor's user group. Revoke for groups that should not see the public surface.
- Queries below Widget frequency floor are hidden from public widgets even if they appear in admin dashboards. Prevents single-user queries from leaking into the public surface.
- When Allow members to opt out of public widgets is enabled, members may exclude their own searches from widget aggregates at Account preferences > Search analytics. The sub-option Members opt in by default controls the starting state for new and existing accounts. Disable the parent option to force all member searches to contribute regardless of preference.
Widget options
| Option | What it does |
|---|---|
| Layout | One of the eight layouts above. |
| Display style | Compact or detailed. Detailed adds per-row metadata such as variant counts. |
| Limit | Maximum rows surfaced. |
| Period (days) | Trailing window the widget aggregates over. |
| Minimum count | Floor applied on top of Widget frequency floor for this widget only. |
| Link to search | Each row links to re-run the search. |
| New thread call to action | Adds a "Start a thread about this" link on the Unanswered Demand widget. |
| New thread node | Which forum the call to action targets. Set to Visitor's choice to let the visitor pick at click time. |
Cache
Widget payloads are precomputed by the Widget cache cron entry every fifteen minutes and held in the data registry for Widget cache lifetime seconds. The widget render is a registry read, not a query against the aggregate table.