Migrate Node to Drupal CRM

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 (alias cmnsr) to generate Simpsons sample node recipe content from CSV.
• Optional recipe crm_migrate_node_simpsons for demo or sample data.

Post-Installation

1. Install CRM and Migrate Plus if not already installed.
2. Grant the permission Administer Node to CRM migration to the appropriate roles.
3. Go to Configuration → CRM → Node to CRM Migration.
4. Click Add migration to choose a node type and a CRM contact type, then save to create the migration.
5. Open the new migration’s tab to edit and configure field mappings (node fields to CRM contact fields).
6. 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