Navigation (apps & modules)
Organise entities into a structured sidebar navigation with Applications and Modules. This is the primary way users navigate between entities.
Applications
Applications are top-level sidebar groups:
- Slug — unique identifier
- Name — display label (with locale support)
- Icon — Dashicon class
- Sort order — position in the sidebar
- Active — on/off toggle
The "Administration" application is auto-seeded on activation and contains system modules (Schema Manager, Event Log, Roles, etc.). It is hidden from non-admin users.
Modules
Modules are items within an application:
- Slug — unique within the application
- Module type —
link(SPA hash route) orurl(external link) - Target — the SPA route hash (e.g.,
#/entity/ticket) or full URL - Filter (optional) — EQL filter for list modules
- Icon — Dashicon class
- Sort order — position within the application
Reordering
Both applications and modules support drag-and-drop reordering:
POST /pfm/v1/meta/applications/reorder— reorder applicationsPOST /pfm/v1/meta/applications/{slug}/modules/reorder— reorder modules within an app
Navigation tree
GET /pfm/v1/meta/navigation returns the full tree. The SPA uses this to build the sidebar. Non-admin users see a filtered tree without admin-only modules.