ZCU-PUB/feat(community): show "Články" collection 3rd, after "Kapitoly v knihách" (#953)

[Kasinhou]

Problem

In the ZCU publications community each department lists its sub-collections alphabetically by dc.title. Because "Články" (Č) sorts after the Latin A–Z, the articles collection always ends up last. The customer wants "Články" shown directly after "Kapitoly v knihách" (book parts):

• book parts 2nd → articles 3rd,
• book parts 1st → articles 2nd,

i.e. articles tracks book parts wherever it naturally sits.

Approach

• Ordering rule lives in one shared pure helper: src/app/shared/zcu-collection-order.ts.
• Rule: keep book parts and every other collection in their natural (alphabetical) position; move only "Články" to sit immediately after "Kapitoly v knihách". No-op when either collection is missing or they are already adjacent — book parts itself is never relocated.
• Matching is by Czech title prefix (trimmed, case-insensitive), so every naming variant used across departments is handled: Články, Články / Articles, Články / Articles (KAE), and likewise Kapitoly v knihách / Bookparts (KAE). Because collection titles are data (not UI translations), the match is independent of the interface language.
• Applied in both places that list a community's collections:
  • community detail page — the themed sub-collection-list override delegates to the helper; the base component keeps a no-op applyCustomCollectionOrder() seam so other themes/customers are unaffected;
  • community browse tree (/community-list) — CommunityListService reorders each fetched collection page.

Change set

File	Change
src/app/shared/zcu-collection-order.ts	Shared pure helper reorderZcuPublicationCollections() + prefix constants + prefix matcher.
src/app/shared/zcu-collection-order.spec.ts	Unit tests for the rule (incl. bilingual/suffixed names).
src/app/community-page/sub-collection-list/community-page-sub-collection-list.component.ts	No-op applyCustomCollectionOrder() seam, applied to the fetched page.
src/themes/custom/app/community-page/sub-collection-list/community-page-sub-collection-list.component.ts	Override the seam; delegate to the shared helper.
src/themes/custom/app/community-page/sub-collection-list/community-page-sub-collection-list.component.spec.ts	Tests for the themed override.
src/app/community-list-page/community-list-service.ts	Apply the shared helper to each collection page in the browse tree.

Verification

• Unit specs cover: book parts 2nd → articles 3rd; book parts 1st → articles 2nd; production bilingual/suffixed names (Kapitoly v knihách / Bookparts (KAE), Články / Articles (KAE)); mixed variants; already-adjacent (no-op); anchor missing (no-op); empty / single-element input.
• End-to-end, on a local zcu-pub stack (build:prod SSR) seeded with a Publikační činnost → faculty → department hierarchy containing both plain-Czech and bilingual/suffixed departments: in both the /community-list tree and the community detail page, "Články" renders directly after "Kapitoly v knihách" in every case.

Scope / notes

• Only the "articles directly after book parts" constraint is encoded; a general admin-orderable collection order is out of scope.
• zcu-data: not applicable — its active theme is dspace (not custom) and it holds research-data collections, not these publication types.

Risk / rollback

• Low. Pure array reshaping, SSR-safe; a guarded no-op whenever both anchor collections aren't present. The base-component change is a passthrough. Rollback: revert the commits — ordering returns to alphabetical.

Fixes dataquest-dev/dspace-customers#953

[Copilot]

🟢 Approval recommended

The base change is a no-op extension point, and the custom-theme ordering is narrowly scoped, guarded, and covered by unit tests.

Pull request overview

Adds a theme-extensible hook to customize the display order of community sub-collections and uses it in the custom theme to pin "Kapitoly v knihách" and "Články" into fixed 2nd/3rd positions for the ZCU publications community while keeping the remaining collections in their existing (alphabetical) order.

Changes:

• Introduce a protected extension seam applyCustomCollectionOrder(rd) in the base sub-collection list component and apply it before emitting results.
• Implement ZCU-specific ordering in the custom theme via applyCustomCollectionOrder() + a pure reorderCollections() helper using named constants for the pinned titles.
• Add unit tests in the custom theme for the reorder rule and its guard conditions.

File summaries

File	Description
src/app/community-page/sub-collection-list/community-page-sub-collection-list.component.ts	Adds a protected no-op ordering hook and invokes it when emitting fetched sub-collections.
src/themes/custom/app/community-page/sub-collection-list/community-page-sub-collection-list.component.ts	Overrides the hook to apply the ZCU-specific pinned 2nd/3rd ordering based on exact collection names.
src/themes/custom/app/community-page/sub-collection-list/community-page-sub-collection-list.component.spec.ts	Adds focused unit tests covering the pinning behavior and non-applicability cases.

Review details

• Files reviewed: 3/3 changed files
• Comments generated: 0
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.