Skip to content

Issue 34210 task enable usage dashboard tool by default in#34543

Open
dsantos-dcms wants to merge 3 commits intomainfrom
issue-34210-task-enable-usage-dashboard-tool-by-default-in
Open

Issue 34210 task enable usage dashboard tool by default in#34543
dsantos-dcms wants to merge 3 commits intomainfrom
issue-34210-task-enable-usage-dashboard-tool-by-default-in

Conversation

@dsantos-dcms
Copy link
Contributor

@dsantos-dcms dsantos-dcms commented Feb 6, 2026

Proposed Change

Adds an upgrade task that adds the Usage portlet to the System menu on dotCMS, if it doesn't already exist in the system.

Changes

  • PortletID.java: Added USAGE enum constant to register the new portlet ID
  • Task260206AddUsagePortletToMenu.java: Created new startup task (runonce) that:
    • Checks if the Usage portlet already exists anywhere in the system
    • If not, adds it to the System menu (with fallback to Marketing menu or Sites menu location)
    • Only runs once per installation (tracked in db_version table)
  • TaskLocatorUtil.java: Registered the new task in the startup task system

The task uses forceRun() to check if the portlet already exists anywhere before executing, ensuring it only adds the portlet once and won't duplicate it across menus.

Test

Tested by running a local dotCMS instance - the Usage portlet appears in the System menu automatically on startup.

Screenshots

Original Updated
** original screenshot ** ** Screenshot 2026-02-06 at 3 10 02 PM **

This PR fixes: #34210

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

[SPIKE] Investigate ability to turn on Usage portlet for existing evergreen deployments

1 participant