Lyzerslab
← Back to MuRu Migration for J3 docs

Get Started

What's New in 2.4.0

Last updated: October 16, 2026

MuRu Migration 2.4.0

MuRu Migration 2.4.0 introduces a comprehensive Health Check system, improved migration reliability, safer cross-version imports, and a redesigned Full Migration workflow. This release focuses on identifying and fixing common frontend errors after migration while preserving content relationships, access permissions, and menu structures.

Health Check and Live URL Testing

  • Health Check: Scan articles, categories, menus, modules, users, access levels, languages, and workflow records for issues that can cause 404, 403, or 500 errors.
  • One-click fixes: Resolve supported issues such as broken category trees, incorrect menu component links, zero dates, missing languages, duplicate aliases, and duplicate administrator modules. No changes are made until a Fix button is pressed.
  • Live URL check: Test public article and menu URLs as a visitor would, reporting pages that do not return HTTP 200 and highlighting 403 responses.
  • Expanded diagnostics: Detect missing contacts, news feeds, tags, and contact references to deleted users.

Redesigned Full Migration

  • Selective migration: Choose which sections to export or import, including users and groups, articles, categories, images, menus, and site modules.
  • Four-step workflow: Follow Export, Preview, Import, and Check in the redesigned Full Migration interface.
  • Dry-run and overwrite options: Preview imports before applying changes and choose whether existing matched content should be overwritten.
  • Import reports: Retain warnings from the latest import, view source site and Joomla version details, download a plain-text report, and open a Health Check summary after importing.

Improved Cross-Version Compatibility

  • Publication dates: Convert zero dates according to the target Joomla version to prevent migrated articles and related pages from incorrectly returning 404 errors.
  • Menu component mapping: Resolve component IDs using the target site's configuration instead of reusing source-site IDs.
  • Category hierarchy: Export parent and empty categories alongside article categories, preserving the complete category tree.
  • Menu and module references: Remap article and category references in menu items and module parameters. Unresolved menu links are imported unpublished with a warning.
  • Access levels: Export custom access levels and recreate them using available target-site user groups. Unknown access levels default to Registered instead of Public.
  • Author mapping: Match authors through imported user mappings, email addresses, and usernames. Unmatched authors are assigned to the importing administrator.

Import Safety and Reliability

  • Safer overwrite matching: Match articles using previous import ID mappings and then alias plus category. Match users by username or email, and never overwrite the account performing the import.
  • Accurate category matching: Match categories by their full hierarchy before falling back to aliases under the resolved parent.
  • Module handling: Export site modules only, remap positive and negative menu assignments correctly, and detect duplicate administrator modules from older imports.
  • Cache clearing: Clear menu, content, category, module, and system caches after each import.
  • Persistent ID mappings: Merge mappings from partial re-imports instead of replacing earlier records.
  • Improved error handling: Handle PHP errors and exceptions, report failures per item, and continue safely where possible.
  • Export encoding: Handle invalid UTF-8 bytes and report a clear error when encoding cannot be completed.

Dashboard and Interface Improvements

  • Added Dashboard and Settings entries to the administrator sidebar in both editions.
  • Added section-count indicators to the Full Migration interface.
  • Improved the Preview Import button behavior when dry-run mode is enabled.
  • Fixed a PHP 8 notice in menu alias remapping.
  • Improved the readability of the Open Health Check button.
  • Added access-level and author migration support to both editions.

License Requirements

Both MuRu Migration editions require an active license to unlock the migration tools. Select the edition that matches your Joomla and PHP environment.

Previous Releases

2.3.0 – Full Migration: Introduced the all-in-one ZIP export and import workflow, dependency-ordered imports, dry-run previews, and the Advanced tabs for selective migration.

2.2.0 – Migration-safe importing: Added dry-run previews, cross-version ID mapping, nested-set rebuilding, and automatic database migration from Easy Import/Export.

2.1.0 – ZIP article media: Changed article image exports to raw files inside ZIP archives, reducing export size, processing time, and memory usage.