Migrate CRM Core to Drupal CRM

Migrates CRM Core (Drupal 7) contacts and relationships to Drupal CRM on Drupal 11. Uses the Migrate API and Migrate Plus; requires a D7 database connection.

Features

• Contact migration — Migrates D7 CRM Core contacts into crm_contact entities (individual, household, organization bundles).
• Relationship migration — Migrates D7 Relation rows (CRM relationships) into crm_relationship entities; depends on the contact migration.
• Fixture generation — Drush command to generate CRM Core–style test fixtures from the same CSV files used by the CRM project (e.g. Simpsons contact and relationship data).

Use this module when upgrading a Drupal 7 site that runs CRM Core to Drupal 11 with the CRM module. It provides the migration definitions and process plugins needed to move contacts and relationships in one or more batches.

Post-Installation

1. Configure the Drupal 7 database connection under the migrate key in settings.php (see README or documentation).
2. Enable the module: drush en crm_migrate_crm_core -y.
3. If migrations do not appear in drush migrate:status, import the migration config: drush config:import --partial --source=web/modules/contrib/crm_migrate_crm_core/config/install.
4. Run drush migrate:import crm_core_contact, then drush migrate:import crm_core_relationship.

There is no dedicated config page; configuration is the D7 database connection and optional overrides to the migration source key.

Additional Requirements

• Drupal 11 — Target site must run a supported Drupal version.
• CRM — Required; migrations create crm_contact and crm_relationship entities.
• Migrate Plus — Required for the migration definitions.
• Drupal 7 database — Read-only access to the D7 database that contains the CRM Core and Relation tables.

Recommended modules/libraries

Migrate Tools (and Drush) for running and managing migrations from the command line. The fixture generator is intended for use with the CRM project’s test CSV data.

Similar projects

CRM Core (D7) is the source system being migrated from. This project does not replace CRM Core; it provides the migration path from CRM Core to the CRM module on Drupal 11.

Community Documentation

Documentation for installation, running migrations, fixture generation, and CSV format is available in the project repository (e.g. MkDocs site or docs/ in the repo).