Migrate CRM Core to Drupal CRM
This project migrates contacts and relationships from Drupal 7's CRM Core module to Drupal 11's CRM module. It uses the Drupal Migrate API to transform your existing Drupal 7 data into the new CRM entities.
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_contactentities (individual, household, organization bundles). - Relationship migration — Migrates D7 Relation rows (CRM relationships) into
crm_relationshipentities; 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
- Configure the Drupal 7 database connection under the
migratekey insettings.php(see README or documentation). - Enable the module:
drush en crm_migrate_crm_core -y. - 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. - Run
drush migrate:import crm_core_contact, thendrush 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_contactandcrm_relationshipentities. - 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).