bluefly/drupal_migration_plus

Advanced migration framework for Drupal with enhanced field mapping and multi-CMS support.

dev-development 2025-06-06 10:12 UTC

Requires

• php: >=8.1
• drupal/core: ^10.1 || ^11.0
• drupal/migrate_plus: ^6.0
• drupal/migrate_tools: ^6.0

Requires (Dev)

• drupal/core-dev: ^10.0 || ^11.0
• phpunit/phpunit: ^10.0

Suggests

• drupal/migrate_source_csv: For CSV migration sources
• drupal/migrate_source_json: For JSON migration sources
• drupal/migrate_upgrade: For upgrading from previous Drupal versions

GPL-2.0-or-later

• Drupal Migration Plus contributors

• cms
• migration
• drupal
• integration

README

Drupal Migration Plus is an advanced migration framework for Drupal, extending core migration capabilities with enhanced field mapping, multi-CMS support, and improved migration workflows.

Features

• Enhanced Field Mapping: Visual field mapping tools and intelligent field type detection
• Multi-CMS Support: Migration adapters for Drupal, WordPress, and other CMS platforms
• Migration Clustering: Smart grouping of related migration tasks
• Workflow Automation: Step-by-step migration processes with validation and preview
• Custom Process Plugins: Additional process plugins for complex transformations
• Recipe System: Recipe-based migration configurations for common scenarios
• Performance Optimization: Improved migration performance and monitoring

Requirements

• Drupal 10.1 or later
• PHP 8.1 or later
• Required modules:
  • Migrate (Drupal core)
  • Migrate Drupal (Drupal core)
  • Migrate Drupal UI (Drupal core)
  • Migrate Plus
  • Migrate Tools

Installation

Using Composer (recommended)

composer require drupal/drupal_migration_plus
drush en drupal_migration_plus

Manual Installation

1. Download the module from drupal.org/project/drupal_migration_plus
2. Extract to your modules directory (e.g., modules/contrib/)
3. Enable the module through the UI or using Drush: drush en drupal_migration_plus

Configuration

1. Navigate to Administration » Configuration » Development » Migration Plus Settings
2. Configure default migration settings
3. Set up source system connections
4. Configure field mapping preferences
5. Create migration recipes as needed

Usage

Recipe Onboarding Workflow

For guided migration:

1. Navigate to Administration » Migration » Recipe Onboarding
2. Follow the step-by-step process:
   • Source system discovery and analysis
   • Field mapping configuration
   • Content migration execution
   • Post-migration validation

Manual Migration

For custom migrations:

# List available migrations
drush migrate:status

# Run a specific migration
drush migrate:import my_migration

# Roll back a migration
drush migrate:rollback my_migration

Source Adapters

The module provides adapters for different source systems:

• Drupal to Drupal: Migration between Drupal versions
• WordPress to Drupal: Import WordPress content
• Joomla to Drupal: Import Joomla content
• Custom Sources: Framework for creating custom source adapters

Extending the Module

Creating Custom Adapters

namespace Drupal\my_module\SourceAdapter;

use Drupal\drupal_migration_plus\SourceAdapter\SourceAdapterBase;

/**
 * Source adapter for my custom system.
 */
class MySystemAdapter extends SourceAdapterBase {
  // Implementation here
}

Custom Process Plugins

namespace Drupal\my_module\Plugin\migrate\process;

use Drupal\migrate\ProcessPluginBase;

/**
 * @MigrateProcessPlugin(
 *   id = "my_custom_processor"
 * )
 */
class MyCustomProcessor extends ProcessPluginBase {
  // Implementation here
}

Documentation

For more detailed documentation:

• User Guide
• Developer Guide
• Source Adapters
• Process Plugins
• Recipe System

Support

• For bug reports and feature requests, visit the issue queue
• For general questions, use the Drupal Migration group

Contributing

• Read our contributing guidelines
• Submit patches via Drupal.org issues or pull requests

License

This project is licensed under the GNU General Public License v2.0 or later.