{"id":"69c1d780f6c2aac2b6953b00","title":"2026 03 23","path":"how-to/committee/release-notes/2026-03-23","contentMarkdown":"# 23-Mar-2026 — add committee documents row type, index-based navigation, and draggable swiper [ref #162](https://github.com/nbarrett/ngx-ramblers/issues/162)\n\n## [build 547](https://github.com/nbarrett/ngx-ramblers/actions/runs/23466309751) — [commit d793171](https://github.com/nbarrett/ngx-ramblers/commit/d7931711549df6174c5cc95c6414f46e01f28d96)\n\n_____\n\n## End-User Changes\n### Committee Documents as CMS Content\n- Committee file listings can now be placed on any CMS page as a row type\n- Each year's committee files (AGM minutes, financial returns, etc.) appear\non their own CMS-managed page at `committee/{year}`\n- The root `/committee` page auto-populates with the most recent year's files\n- Images are configurable per year page via the Image Actions editor\n(edit/replace/remove) — the same editor available on text rows\n- The Index automatically picks up each year page's image for its cards\n### Committee Years Navigation\n- Year navigation cards are now generated by an Index row instead of\nhand-maintained action buttons — new years appear automatically\n- The shared fragment `fragments/committee-years` holds the index\nconfiguration so all pages share the same navigation\n- Edit fragment button opens the fragment in a new tab to avoid losing\nsite edit context\n- Fragment inline preview hides markdown edit buttons to reduce clutter\n### Draggable Swiper for Action Buttons\n- Action button carousels can now be dragged/swiped on both desktop (mouse)\nand mobile (touch) to browse cards\n- Cards track the cursor/finger position in real-time during drag\n- Releasing the drag snaps to the nearest grid position with smooth animation\n- Multi-card drag: dragging across multiple card widths advances that many\npositions instead of just one\n- Native browser image drag is suppressed within the swiper\n- Click events are blocked during drag — only a clean tap/click navigates\n- Arrow buttons continue to work alongside drag\n### Fragment Margin Support\n- Margin Top/Bottom settings on shared fragment rows now apply correctly\nin the page view\n## Technical Changes\n### Migration (`20260319000000-convert-committee-page-to-cms`)\n- Fragment path changed from `committee-committee-years` to\n`fragments/committee-years` (required prefix for FragmentService)\n- Fragment content converted from action-button rows to an Index row\n(`ALBUM_INDEX`) with `STARTS_WITH` match on `committee/`, sorted DESC\n- Index configured with `maxColumns: 3`, `showSwiper: true`,\n`indexMarkdown: \"## Committee Years\"`, `autoTitle: false`\n- Hardcoded \"EKWG\" intro text replaced with dynamic lookup from\nsystem config `area.shortName`\n- `new Date()` replaced with `dateTimeFromMillis()` from `dates.ts`\n- Each year page's `committeeDocuments.imageSource` populated from the\nexisting fragment action-button column images\n### Image Discovery for Index\n- `findFirstImageInPage()` in both `IndexService` and\n`LocationExtractionService` now checks `row.committeeDocuments?.imageSource`\nbefore scanning columns — enables Index cards to display committee doc images\n### Committee Documents Site Edit\n- Image Actions dropdown (edit/replace/remove) with image cropper added\nto committee documents row editing\n- Image controls hidden when \"Auto Populate\" is checked (image comes\nfrom child page)\n### Auto-Populate Improvements\n- Replaced fragile `siteLinks`-based child page lookup with direct\n`$regex` database query for reliability\n- Page title derived from child page path instead of URL fragments\n### View Component Changes\n- `hideEditToggle` input threaded through `DynamicContentView` →\n`DynamicContentViewTextRow` → `MarkdownEditorComponent` to suppress\ninline edit buttons in fragment previews\n- `contentDescription` fallback to fragment path prevents\n\"Edit content for undefined\" tooltip\n### Swiper Implementation (action-buttons.ts)\n- Continuous flex strip with `overflow: hidden` viewport replaces\nslice-based `viewableColumns()` for swiper mode\n- `gap: 24px` on flex container with `calc()`-based flex-basis matches\nBootstrap grid spacing\n- Pixel-based `translateX` for both slide position and drag offset\n- Capture-phase click listener blocks navigation during drag\n- `pointer-events: none` and `-webkit-user-drag: none` on images\nprevents native drag interference\n### Route changes\n- Removed hardcoded `/committee` route — committee pages now served\nas CMS dynamic content via `hasDynamicPath` matcher\n- Added `hasSendNotificationPath` URL matcher for `/send-notification/`\n- Added `PathSegment` and `RouteParam` enums replacing hardcoded strings\n- Consolidated `CommitteeEditFileModal` into single-file component\n### Removed\n- `CommitteeHomeComponent`, `CommitteeYearComponent` and templates\n- `CommitteeDocumentsYearFilter` enum, `BuiltInAnchor.COMMITTEE_YEARS`,\n`BuiltInPath.COMMITTEE`, `PageContentPath.COMMITTEE_ACTION_BUTTONS_YEARS`\n- `CommitteeRoutingModule`\n### Bug fixes\n- Fixed `.reverse()` mutation bug in `RouterHistoryService`\n### Backup/restore resilience\n- Added timeout and retry logic for mongorestore operations","contentHtml":"

23-Mar-2026 — add committee documents row type, index-based navigation, and draggable swiper ref #162

\n

build 547 — commit d793171

\n
\n

End-User Changes

\n

Committee Documents as CMS Content

\n\n

Committee Years Navigation

\n\n

Draggable Swiper for Action Buttons

\n\n

Fragment Margin Support

\n\n

Technical Changes

\n

Migration (20260319000000-convert-committee-page-to-cms)

\n\n

Image Discovery for Index

\n\n

Committee Documents Site Edit

\n\n

Auto-Populate Improvements

\n\n

View Component Changes

\n\n

Swiper Implementation (action-buttons.ts)

\n\n

Route changes

\n\n

Removed

\n\n

Bug fixes

\n\n

Backup/restore resilience

\n\n"}