crm_migrate_node
Migrate Node to Drupal CRM migrates node content types to Drupal CRM contact entities. It provides a UI to define migrations and map node fields to CRM contacts using Migrate Plus.
Features
- Create migrations from a node (content) type to a CRM contact type.
- Web UI to add and edit migrations and map node fields to CRM contact fields, including name components, addresses, and contact methods (emails, telephones, addresses).
- Migrations appear in the standard Migrate UI; run them via Drush or the admin UI.
- Optional Drush command
crm-migrate-node:generate-simpsons-recipe(aliascmnsr) to generate Simpsons sample node recipe content from CSV. - Optional recipe
crm_migrate_node_simpsonsfor demo or sample data.
Post-Installation
- Install CRM and Migrate Plus if not already installed.
- Grant the permission Administer Node to CRM migration to the appropriate roles.
- Go to Configuration → CRM → Node to CRM Migration.
- Click Add migration to choose a node type and a CRM contact type, then save to create the migration.
- Open the new migration’s tab to edit and configure field mappings (node fields to CRM contact fields).
- Run the migration via Manage → Migrate or Drush (e.g.
drush migrate:status,drush migrate:import).
Additional Requirements
- Drupal 11
- CRM (drupal/crm)
- Migrate Plus (migrate_plus)
The optional Simpsons recipe (crm_migrate_node_simpsons) also depends on the Name, Telephone, and Address modules.
Recommended modules/libraries
The CRM ecosystem modules (Name, Telephone, Address) provide full name and contact-method support on nodes and CRM contacts. Migrate Tools is recommended if you want to run and manage migrations from the admin UI.
Similar projects
Other migration modules target different sources or destinations. Migrate Node to Drupal CRM is specifically for node → CRM contact migration, with a dedicated mapping UI and Migrate Plus integration.
Supporting this Module
Contributions and support are welcome via the issue queue.
Community Documentation
Links to walkthroughs, external documentation, or a demo site (e.g. DrupalPod) can be added here when available.
You may continue to put additional information below here, if there are other things people need to know about this module.
Develop using DDEV ⚙
If you haven't already, install Docker and DDEV
git clone [email protected]:project/crm_migrate_node.git cd crm_migrate_node ddev config --project-type=drupal --docroot=web --php-version=8.4 --corepack-enable --project-name=crm-migrate-node ddev add-on get ddev/ddev-drupal-contrib ddev start ddev poser ddev symlink-project ddev drush site:install -y ddev drush pm:install crm_migrate_node -y ddev drush config:export -y ddev drush user:login