Skip to content

refactor(manager): remove main_nav_parent and user_nav_parent system settings - #16908

Open
Ibochkarev wants to merge 3 commits into
modxcms:3.xfrom
Ibochkarev:fix/15972-remove-nav-parent-settings
Open

refactor(manager): remove main_nav_parent and user_nav_parent system settings#16908
Ibochkarev wants to merge 3 commits into
modxcms:3.xfrom
Ibochkarev:fix/15972-remove-nav-parent-settings

Conversation

@Ibochkarev

Copy link
Copy Markdown
Collaborator

What does it do?

Removes the main_nav_parent and user_nav_parent system settings. The manager header controller now uses fixed menu container names (topnav for main menu, usernav for user menu) instead of reading these options. The two settings are removed from the core transport and from all setting lexicons; an upgrade script (3.3.0-pl) deletes any existing records from the database on upgrade.

Why is it needed?

These settings confuse users and do not behave intuitively (e.g. setting user_nav_parent to topnav can break menu display). Menu structure is already managed in the Menu section with fixed Main/User menu areas, so the extra system settings are redundant and add support burden.

How to test

  1. New install: Run setup for a new install; confirm manager loads and main/user menus render. System Settings should no longer list "Main menu parent" or "User menu parent".
  2. Upgrade: On a site that has main_nav_parent or user_nav_parent in system_settings, run setup in upgrade mode to a version that runs 3.3.0-pl. Confirm the upgrade log shows removal of those settings and manager menus still work.
  3. UI: Open Manager → System Settings, search for "menu parent"; the two removed keys should not appear.

Related issue(s)/PR(s)

Resolves #15972

@Ibochkarev
Ibochkarev marked this pull request as ready for review February 26, 2026 16:26
…settings

Use fixed menu container names (topnav, usernav) in header controller.
Remove settings from transport and all setting lexicons; add 3.3.0-pl
upgrade script to delete existing DB records. Reduces confusion and
matches menu configuration in Menu section.

Resolves modxcms#15972
@Ibochkarev
Ibochkarev force-pushed the fix/15972-remove-nav-parent-settings branch from c42a9dd to 5c2b7ff Compare February 26, 2026 16:28
@smg6511

smg6511 commented Jun 29, 2026

Copy link
Copy Markdown
Collaborator

@Ibochkarev - Giving this a review, but one thing needs changing up front: Please remove changes to all Lexicon entries except those made to the en file. The removal of the legacy entries for non-English languages gets handled in the Crowdin process automatically.

Restore nav parent lexicon entries in all locales except en; Crowdin
handles removal of obsolete keys in translated files automatically.
@Ibochkarev

Copy link
Copy Markdown
Collaborator Author

@Ibochkarev - Giving this a review, but one thing needs changing up front: Please remove changes to all Lexicon entries except those made to the en file. The removal of the legacy entries for non-English languages gets handled in the Crowdin process automatically.

Done

@smg6511 smg6511 added this to the v3.3.0 milestone Jun 29, 2026

@smg6511 smg6511 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good to go; suggested 2 tiny formatting changes.

Comment thread manager/controllers/default/header.php Outdated
Comment thread manager/controllers/default/header.php Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Delete main_nav_parent and user_nav_parent system settings

3 participants