golem15/summercms
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(quick-261022-imo): settings section panel scoped to the current category

Browse Source 
- settingsSectionOf returns the current entry's category group (null for one-entry categories)
- SettingsPanel mirrors the plugin side menu, collapse included
- AppShell shows it on settings forms and settings-linked controllers without own navigation
- docs/backend/settings.md describes moving between settings pages
This commit is contained in:
Jakub Zych
2026-10-22 13:50:39 +02:00
parent a97743a39f
commit 834ef98572
5 changed files with 152 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
docs/backend/settings.md
View File

@@ -89,7 +89,13 @@ A link entry is not a singleton and needs no embedded admin tree. [cabana](../..
A link entry may also open a [singleton controller](admin-controllers.md#singleton-controllers), one whose `pact.AdminSingleton` record the admin opens directly in its form, the way WinterCMS plugins auto-created one definition and redirected to it. The entry stays a link to the controller's list route: since a singleton controller has no list, the admin asks its singleton route for the record and opens it, also when the link is opened in a new tab.
In the admin, the entry's card on the Settings page opens the controller's pages. When the controller has no main navigation item of its own, the admin treats it as part of Settings: the rail marks Settings as current and the breadcrumbs read Settings, then the entry's label.
In the admin, the entry's card on the Settings page opens the controller's pages. When the controller has no main navigation item of its own, the admin treats it as part of Settings: the rail marks Settings as current, the breadcrumbs read Settings, then the entry's label, and the section panel lists the settings pages of the entry's category.
## Moving between settings pages
On a settings form, and on a linked controller that belongs to Settings, a panel next to the rail lists the settings pages of the same category in the order of the Settings page, with the open page highlighted. An administrator on one page of a category reaches the others directly, the way a plugin's side menu switches between its controllers.
The panel does not appear when the category has a single page, on the Settings page itself, or on a linked controller that has its own main navigation item; that controller keeps its plugin's side menu. Pages of another category are reached through the Settings page. The panel collapses and expands like a plugin's side menu and hides on narrow windows.
## How values are stored