{"id":"6983e9f1fdf510c3b20be028","title":"2026 02 03 Issue 147 Manual","path":"how-to/committee/release-notes/2026-02-03-issue-147-manual","contentMarkdown":"# 03-Feb-2026 — add external album import from Flickr [ref: #147](https://github.com/nbarrett/ngx-ramblers/issues/147)\n\n## [build 459](https://github.com/nbarrett/ngx-ramblers/actions/runs/21641819798) — [commit 7333a44](https://github.com/nbarrett/ngx-ramblers/commit/7333a4400b0742a1bb3793c4b22219605ce53b0d)\n\n_____\n\n## Overview\n\nThis release introduces two major features: **Flickr Album Import** for bringing external photo albums into the platform, and significant **Environment Setup Enhancements** for database-driven configuration. It also includes numerous code quality improvements and developer experience enhancements.\n\n---\n\n# User Guide\n\n## New Features\n\n### 1. Import Flickr Albums\n\nYou can now import photo albums directly from Flickr without copying images to S3. Images remain hosted on Flickr while the album is managed within the platform.\n\n#### How to Access\nNavigate to **Admin > System Settings > Image Migration > Import from External Sources**\n\n#### Single Album Import\n1. Select **Single Album** mode\n2. Paste a Flickr album URL (e.g., `https://www.flickr.com/photos/username/albums/12345`)\n3. Enter a target path for the new page (e.g., `gallery/2024/summer-walk`)\n4. Optionally customise the album title and subtitle\n5. Click **Import Album**\n6. The system will:\n - Fetch all photos from the Flickr album\n - Extract photo titles and dates\n - Create a new album page at your specified path\n\n#### Bulk Import (Multiple Albums)\n1. Select **Bulk Import** mode\n2. Enter a Flickr user ID or username\n3. The system will fetch and display all albums for that user\n4. Select the albums you wish to import using checkboxes\n5. Set a base path (e.g., `gallery`) - albums will be created at `{base-path}/{album-name}`\n6. Review the generated paths (you can modify them before import)\n7. Click **Import Selected Albums**\n8. Monitor progress in real-time as each album is imported\n\n#### Album Splitting\nFor large albums with photos from different events, you can split them:\n1. Enable **Split by Photo Title**\n2. The system groups photos by their title patterns\n3. Preview how photos will be split into separate albums\n4. Choose which groups to include\n5. Each group becomes its own album page\n\n#### What Gets Imported\n- Album title and description from Flickr\n- All photo URLs (images remain on Flickr)\n- Photo titles (displayed when \"Show Titles\" is enabled in grid view)\n- Photo dates (for chronological ordering)\n- Cover photo for album previews\n\n#### Template Support\nYou can use an existing album page as a template:\n1. Enable **Use Template**\n2. Enter the path of an existing album page\n3. The new album(s) will inherit the layout and grid settings from the template\n\n---\n\n### 2. Index Row Auto Title\n\nIndex rows now support automatic title generation from the page URL.\n\n#### How It Works\n- **Auto Title enabled (default)**: The index row automatically displays a title derived from the page URL/subtitle\n- **Auto Title disabled**: You can enter custom markdown content for the title area\n\n#### How to Use\n1. Edit any page with an Index row\n2. Find the **Auto Title** checkbox in the Index row settings\n3. When enabled, the title updates automatically based on the page path\n4. When disabled, a markdown editor appears for custom title content\n\nThis is useful for:\n- Consistent titles across similar pages\n- Quick setup of new index pages\n- Override capability when you need a custom title\n\n---\n\n### 3. Improved CLI Tool\n\nThe command-line interface has been significantly enhanced for local development.\n\n#### Starting the Application Locally\n```bash\n# Development mode (with hot reload)\nngx-cli local dev staging\n\n# Production mode (build then run)\nngx-cli local prod staging\n```\n\n#### Available Environments\n```bash\n# List all configured environments\nngx-cli local list\n```\n\nThe CLI will:\n- Check port availability before starting\n- Load secrets from the appropriate environment file\n- Configure Chrome/Chromedriver for scraping features\n- Show real-time logs from both frontend and backend\n\n#### Log Files\nUse the `--log-dir` flag to save logs:\n```bash\nngx-cli local dev staging --log-dir ./logs --log-timestamp\n```\n\n---\n\n### 4. Environment Configuration from Database\n\nEnvironment configuration is now stored in the database rather than file-based configs. This provides:\n\n- **Centralised Configuration**: All environment settings in one place\n- **Real-time Updates**: Changes take effect without redeployment\n- **Better Security**: Sensitive configuration stored in database, not files\n\nThe system will automatically use database configuration, with file-based fallback only as a last resort (you'll be prompted before this happens).\n\n---\n\n## Changes to Existing Features\n\n### Album Grid View\n- Photo titles now display correctly when \"Show Titles\" is enabled\n- Photo dates are stored and can be used for sorting\n\n### Template Selector\n- New template selector component for reusing page layouts\n- Available when creating albums from external sources\n\n---\n\n# Technical Changes\n\n## GitHub Issue #147: Flickr Album Import - Completion Status\n\n### Completed Requirements\n\n| Requirement | Status |\n|------------|--------|\n| New \"Import from External Sources\" tab | ✅ Complete |\n| Single album import with URL input | ✅ Complete |\n| Bulk import from user albums | ✅ Complete |\n| Multi-select album interface | ✅ Complete |\n| Auto-generated paths from album names | ✅ Complete |\n| PageContent creation with correct structure | ✅ Complete |\n| ContentMetadata with Flickr URLs | ✅ Complete |\n| Photo title extraction (text field) | ✅ Complete |\n| Photo date extraction (date field) | ✅ Complete |\n| Real-time progress via WebSocket | ✅ Complete |\n| Error handling for invalid URLs | ✅ Complete |\n| Album splitting by photo title | ✅ Complete |\n| Template-based album creation | ✅ Complete |\n\n### Pending Testing\n- Albums display correctly in grid, gallery, and carousel views\n- Photo titles display when `showTitles` is enabled\n\n---\n\n## GitHub Issue #146: Environment Setup - Changes in This Release\n\n### Completed in This Release\n\n| Enhancement | Status |\n|------------|--------|\n| Database-driven environment configuration | ✅ Complete |\n| CLI database connection with explicit connect | ✅ Complete |\n| Fallback prompt before using file-based config | ✅ Complete |\n| Environment variable logging on CLI startup | ✅ Complete |\n| Standardised debug logging with `envConfig.logNamespace()` | ✅ Complete |\n\n---\n\n## Bonus Features (Outside Original Scope)\n\n### 1. External Album Import Framework\n- Extensible provider architecture (`ExternalAlbumProvider` interface)\n- Support for multiple sources (Flickr implemented, Google Photos/Instagram ready)\n- Album summary and metadata interfaces for any external source\n\n### 2. Album Splitting Feature\n- Split large albums by photo title patterns\n- Preview split results before importing\n- Include/exclude specific groups\n\n### 3. Template-Based Album Creation\n- Use existing album pages as templates\n- Inherit layout, grid options, and styling\n- Template selector component for easy selection\n\n### 4. Index Row Auto Title\n- Automatic title generation from page URL\n- Toggle between auto and manual markdown entry\n- Defaults to enabled for new index rows\n\n### 5. Enhanced CLI Local Development\n- Port availability checking before starting servers\n- Chrome/Chromedriver validation and configuration\n- Log file output with timestamps\n- Clean process shutdown handling\n\n### 6. Real-Time Import Progress\n- WebSocket-based progress updates\n- Stage-by-stage progress reporting\n- Activity logging during bulk imports\n\n### 7. Code Quality Improvements\n- Replaced all `Array` with `T[]` syntax\n- Standardised debug logger creation with `envConfig.logNamespace()`\n- Cached environment variable validation (log once, not repeatedly)\n- Explicit database connection in CLI commands\n\n---\n\n## Migration Notes\n\n### For Administrators\n- Environment configuration is now read from database by default\n- File-based `configs.json` is only used as fallback (you'll be prompted)\n- Ensure database connectivity before running CLI commands\n\n### For Developers\n- Use `envConfig.logNamespace(\"your-module\")` for debug logging\n- Use `T[]` instead of `Array` for type definitions\n- Database connection is now explicit in CLI context\n\n---\n\n## Testing Checklist\n\n- [ ] Import single Flickr album and verify page creation\n- [ ] Import multiple albums via bulk import\n- [ ] Verify album splitting works correctly\n- [ ] Verify template-based import inherits settings\n- [ ] Test Index row auto title toggle\n- [ ] Test CLI `local dev` and `local prod` commands\n- [ ] Verify database configuration is loaded (not file-based)\n- [ ] Check environment variable logging appears once only\n","contentHtml":"

03-Feb-2026 — add external album import from Flickr ref: #147

\n

build 459 — commit 7333a44

\n
\n

Overview

\n

This release introduces two major features: Flickr Album Import for bringing external photo albums into the platform, and significant Environment Setup Enhancements for database-driven configuration. It also includes numerous code quality improvements and developer experience enhancements.

\n
\n

User Guide

\n

New Features

\n

1. Import Flickr Albums

\n

You can now import photo albums directly from Flickr without copying images to S3. Images remain hosted on Flickr while the album is managed within the platform.

\n

How to Access

\n

Navigate to Admin > System Settings > Image Migration > Import from External Sources

\n

Single Album Import

\n
    \n
  1. Select Single Album mode
    2. \n
  2. Paste a Flickr album URL (e.g., https://www.flickr.com/photos/username/albums/12345)
    3. \n
  3. Enter a target path for the new page (e.g., gallery/2024/summer-walk)
    4. \n
  4. Optionally customise the album title and subtitle
    5. \n
  5. Click Import Album
    6. \n
  6. The system will:
      \n
    • Fetch all photos from the Flickr album
      • \n
    • Extract photo titles and dates
      • \n
    • Create a new album page at your specified path
      • \n
    \n
    7. \n
\n

Bulk Import (Multiple Albums)

\n
    \n
  1. Select Bulk Import mode
    2. \n
  2. Enter a Flickr user ID or username
    3. \n
  3. The system will fetch and display all albums for that user
    4. \n
  4. Select the albums you wish to import using checkboxes
    5. \n
  5. Set a base path (e.g., gallery) - albums will be created at {base-path}/{album-name}
    6. \n
  6. Review the generated paths (you can modify them before import)
    7. \n
  7. Click Import Selected Albums
    8. \n
  8. Monitor progress in real-time as each album is imported
    9. \n
\n

Album Splitting

\n

For large albums with photos from different events, you can split them:

\n
    \n
  1. Enable Split by Photo Title
    2. \n
  2. The system groups photos by their title patterns
    3. \n
  3. Preview how photos will be split into separate albums
    4. \n
  4. Choose which groups to include
    5. \n
  5. Each group becomes its own album page
    6. \n
\n

What Gets Imported

\n\n

Template Support

\n

You can use an existing album page as a template:

\n
    \n
  1. Enable Use Template
    2. \n
  2. Enter the path of an existing album page
    3. \n
  3. The new album(s) will inherit the layout and grid settings from the template
    4. \n
\n
\n

2. Index Row Auto Title

\n

Index rows now support automatic title generation from the page URL.

\n

How It Works

\n\n

How to Use

\n
    \n
  1. Edit any page with an Index row
    2. \n
  2. Find the Auto Title checkbox in the Index row settings
    3. \n
  3. When enabled, the title updates automatically based on the page path
    4. \n
  4. When disabled, a markdown editor appears for custom title content
    5. \n
\n

This is useful for:

\n\n
\n

3. Improved CLI Tool

\n

The command-line interface has been significantly enhanced for local development.

\n

Starting the Application Locally

\n
# Development mode (with hot reload)\nngx-cli local dev staging\n\n# Production mode (build then run)\nngx-cli local prod staging\n
\n

Available Environments

\n
# List all configured environments\nngx-cli local list\n
\n

The CLI will:

\n\n

Log Files

\n

Use the --log-dir flag to save logs:

\n
ngx-cli local dev staging --log-dir ./logs --log-timestamp\n
\n
\n

4. Environment Configuration from Database

\n

Environment configuration is now stored in the database rather than file-based configs. This provides:

\n\n

The system will automatically use database configuration, with file-based fallback only as a last resort (you'll be prompted before this happens).

\n
\n

Changes to Existing Features

\n

Album Grid View

\n\n

Template Selector

\n\n
\n

Technical Changes

\n

GitHub Issue #147: Flickr Album Import - Completion Status

\n

Completed Requirements

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
RequirementStatus
New "Import from External Sources" tab✅ Complete
Single album import with URL input✅ Complete
Bulk import from user albums✅ Complete
Multi-select album interface✅ Complete
Auto-generated paths from album names✅ Complete
PageContent creation with correct structure✅ Complete
ContentMetadata with Flickr URLs✅ Complete
Photo title extraction (text field)✅ Complete
Photo date extraction (date field)✅ Complete
Real-time progress via WebSocket✅ Complete
Error handling for invalid URLs✅ Complete
Album splitting by photo title✅ Complete
Template-based album creation✅ Complete
\n

Pending Testing

\n\n
\n

GitHub Issue #146: Environment Setup - Changes in This Release

\n

Completed in This Release

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
EnhancementStatus
Database-driven environment configuration✅ Complete
CLI database connection with explicit connect✅ Complete
Fallback prompt before using file-based config✅ Complete
Environment variable logging on CLI startup✅ Complete
Standardised debug logging with envConfig.logNamespace()✅ Complete
\n
\n

Bonus Features (Outside Original Scope)

\n

1. External Album Import Framework

\n\n

2. Album Splitting Feature

\n\n

3. Template-Based Album Creation

\n\n

4. Index Row Auto Title

\n\n

5. Enhanced CLI Local Development

\n\n

6. Real-Time Import Progress

\n\n

7. Code Quality Improvements

\n\n
\n

Migration Notes

\n

For Administrators

\n\n

For Developers

\n\n
\n

Testing Checklist

\n\n"}