Skip to content

System Cards By Topic PR Review

Ed Mozley edited this page Nov 14, 2026 · 1 revision

The System cards by topic, or A-Z - PR review

PR #347 by vsc55 Β· Closes #346 Β· Verdict: merge, with fixes Β· 5.3.0

The System page's cards were always in an order chosen by topic - the portal screens together, the finance lists together, Feature Bingo first, Contributors last - but nothing on the page said so, and with 40 cards it read as no order at all. Each card now names its group, and By topic (the default) shows a heading over each group; A-Z, beside the search, sorts the cards by their translated title instead. User page: System. Internals: System page layout - Developer Guide Β§6.

What was checked

Question Result
Does anything but the layout change? No - the cards, their links and the search haystack are as they were; the order is applied in the browser
Within a group, what order? The registry's own (getSystemAreas()), so the order chosen by topic before is kept
A-Z in every language? Yes - by the translated title, localeCompare in the page's language, Help & guides first
The search with headings Works the same in both orders; a heading whose group the search empties is hidden
A card with no group? Goes under Other, last - and the merge's test fails the build first (below)
Remembered? In the browser (system_cards_order), like the other list choices

On the test install: the System search suite 358/358 and tests/system-maintenance.php 25/25 as vsc55 reported, and the new tests/system-card-groups.php - 5 checks, no database - passes.

What was changed on merge

  1. The search stays on the left of its row (.system-tools justify-content: flex-start); on a phone the search inside the row loses its own 18px bottom margin (mobile.css only, so the desktop is untouched).
  2. Two cards moved group, both out of Look, language and preferences: Search to Health and maintenance, Currencies to Organisation (beside Cost Centres and the Chart of Accounts).
  3. A guard: tests/system-card-groups.php fails when an area names no group, names other, or names a group with no English heading - so a new System card cannot quietly land under Other.
  4. Changelog id renumbered to #2937 (the PR's #2930 had been taken).
  5. Translations of the new strings into the eight maintained languages; this write-up, the user page, the developer guide and vsc55's entry on the Contributors page.

Decided

  • Currencies belongs under Organisation, with the other finance lists, not under Look, language and preferences (Ed, 2026-11-14).

Worth knowing

  • The groups, in order: Getting started, People and access, Sign-in and security, Self-service portal, Organisation, Look, language and preferences, Integrations, Health and maintenance, More - and Other, which should stay empty.
  • Every new System card needs a 'group' in system/includes/areas.php. The test says which card is missing one.
  • No Feature Bingo card: there is nothing to set up, and the choice lives only in the browser.

FreeITSM

Getting Started

Modules

Multi-tenancy (planned)

Responses to feedback

Blue sky thinking

Bugs resolved

Pull requests

Links

Clone this wiki locally