Skip to main content

Post-Upgrade Verification Guide

Duplicate Dashboard Search Widget

SearchDashboardWidget was reworked and moved from project to platform code in Brightspot 4.5. Projects upgrading from Brightspot 4.2 will have a duplicate Search dashboard widget type in the CMS. While these widgets are named similarly, they provide slightly different functionality.

If you are not sure whether the existing search dashboard widget is being used, it is possible to keep both widgets but rename the existing widget.

How to check if your application has this issue

Navigate to the Dashboards page from the CMS hamburger menu. If there are no dashboards created, create one. Within this dashboard, add a dashboard column and add a widget. If you see two Search Widgets here, then you must execute the fix below.

Search widget duplicate issue.png

Solution

Navigate to brightspot.core.tool.SearchDashboardWidget (the existing class) and make the following changes:

Edit @Recordable.DisplayName("Search Widget") to the new title Search Widget - Legacy.

The beginning of your class should look like this now:

@Recordable.DisplayName("Search Widget - Legacy")
public class SearchDashboardWidget extends DashboardWidget {

Now both widgets are fully functioning, though we recommend projects to use the newer version of the widget for stability purposes. The old search widget will not receive updates.

New search widget version.png