Cum să migrezi Paragraphs de la Drupal 7 la Drupal 8

Knowledge Centre

Cum să migrezi Paragraphs de la Drupal 7 la Drupal 8

Cu câteva zile în urmă, ne-am confruntat cu o provocare interesantă: migrarea paragrafelor de pe o platformă Drupal 7 la Drupal 8. În timp ce căutam soluția potrivită, am căutat pe web, dar nu am găsit nimic care să se potrivească perfect nevoilor noastre. Ca rezultat, dezvoltatorii noștri backend au creat o soluție personalizată. Mulțumiri speciale către mtech-llc.com și Ada Hernández, a căror muncă privind migrarea colecțiilor de câmpuri a inspirat această soluție.

În timp ce articolul original al Adei descrie migrarea colecțiilor de câmpuri, noi am adaptat abordarea pentru migrarea paragrafelor. Perspectivele ei s-au dovedit inestimabile pentru procesul nostru.

Înainte de a continua, asigurați-vă că aveți:

1. O instalare funcțională Drupal 8

2. Următoarele module instalate:

migrate_drupal
migrate_plus
migrate_tools
migrate_drupal_ui

Alternativ, puteți adăuga acestea ca dependențe la modulul dvs. personalizat.

După instalarea modulelor necesare, creați un paragraf cu bundle-ul "contact" care conține aceste câmpuri:

Text simplu (nume mașină: field_name)
Email (nume mașină: field_email)
Număr (Integer) (nume mașină: field_phone)

Apoi creați un tip de conținut numit Organizație (nume mașină: organization) cu:

Câmpul body implicit
Câmp de tip paragraf (nume mașină: field_contact)

Această procedură este complexă și necesită atenție deosebită la detalii. Dacă apar erori în timpul oricărui pas, este posibil să fie nevoie să începeți de la zero. Vă rugăm să citiți fiecare pas cu atenție înainte de a continua.

1. Specificați conexiunea la baza de date în settings.php

Adăugați a doua conexiune la Drupal 7 în fișierul dvs. settings.php. În acest exemplu, numele bazei de date este "drupal_7_56":

$databases['migrate']['default'] = array(
   'database' => 'drupal_7_56',
   'username' => 'root',
   'password' => '',
   'prefix' => '',
   'host' => '127.0.0.1',
   'port' => '33067',
   'namespace' => 'Drupal\\Core\\Database\\Driver\\mysql',
   'driver' => 'mysql',
);

2. Creați un modul personalizat

Creați un modul personalizat cu numele mașină "custom".

3. Creați șabloane YML

Plasați următoarele șabloane YML în folderul config/install:

Mai întâi, creați șablonul de migrare pentru paragraf (numele fișierului: migrate_plus.migration.d7_paragraph_contact.yml):

langcode: en
status: true
dependencies: {}
id: d7_paragraph_contact
class: null
field_plugin_method: null
cck_plugin_method: null
migration_tags:
 - 'Drupal 7'
migration_group: migrate_drupal_7
label: Contacts
source:
 plugin: d7_paragraph_item
 key: migrate
 field_name: field_contact
process:
 field_name:
   plugin: iterator
   source: field_name
   process:
     value: value
   revision_id: revision_id
 field_email:
   plugin: iterator
   source: field_email
   process:
     value: email
   revision_id: revision_id
 field_phone:
   plugin: iterator
   source: field_phone
   process:
     value: value
   revision_id: revision_id
destination:
 plugin: 'entity_reference_revisions:paragraph'
 default_bundle: contact
migration_dependencies:
 required: {}
 optional: {}

Apoi creați șablonul de migrare pentru nod (numele fișierului: migrate_plus.migration.d7_node_organization.yml):

langcode: en
status: true
dependencies: {}
id: d7_node_organization
class: null
field_plugin_method: null
cck_plugin_method: null
migration_tags:
 - 'Drupal 7'
 - Content
migration_group: migrate_drupal_7
label: 'Nodes (Organization)'
source:
 plugin: d7_node
 node_type: organization
process:
 nid: nid
 vid: vid
 langcode:
   plugin: default_value
   source: language
   default_value: und
 title: title
 uid: node_uid
 status: status
 created: created
 changed: changed
 promote: promote
 sticky: sticky
 revision_uid: revision_uid
 revision_log: log
 revision_timestamp: timestamp
 body:
   plugin: iterator
   source: body
   process:
     value: value
     format:
       - plugin: static_map
         bypass: true
         source: format
         map:
           - null
       - plugin: skip_on_empty
         method: process
       - plugin: migration
         migration:
           - d6_filter_format
           - d7_filter_format
         source: format
 field_contact:
   - plugin: skip_on_empty
     method: process
     source: field_contact
   - plugin: migration_lookup
     migration: d7_paragraph_contact
     no_stub: true
   - plugin: iterator
     process:
       target_id: '0'
       target_revision_id: '1'
destination:
 plugin: 'entity:node'
 default_bundle: organization
migration_dependencies:
 required: {}
 optional: {}

4. Creați clasa plugin-ului sursă

Creați un fișier numit ContactParagraph.php în directorul /src/Plugin/migrate/source:

<?php
namespace Drupal\mparagraf\Plugin\migrate\source;
use Drupal\migrate\Row;
use Drupal\migrate_drupal\Plugin\migrate\source\d7\FieldableEntity;
/**
* D7_paragraph_item source.
*
* @MigrateSource(
*   id = "d7_paragraph_item"
* )
*/
class ContactParagraph extends FieldableEntity {
 /**
  * {@inheritdoc}
  */
 public function query() {
   // Select node in its last revision.
   $query = $this->select('paragraphs_item', 'fci')
     ->fields('fci', [
       'item_id',
       'field_name',
       'revision_id',
     ]);
   if (isset($this->configuration['field_name'])) {
     $query->innerJoin('field_data_' . $this->configuration['field_name'], 'fd', 'fd.' . $this->configuration['field_name'] . '_value = fci.item_id');
     $query->fields('fd', [
       'entity_type',
       'bundle',
       'entity_id',
       $this->configuration['field_name'] . '_revision_id',
     ]);
     $query->condition('fci.field_name', $this->configuration['field_name']);
   }
   return $query;
 }
 /**
  * {@inheritdoc}
  */
 public function prepareRow(Row $row) {
   // If field specified, get field revision ID so there aren't issues mapping.
   if (isset($this->configuration['field_name'])) {
     $row->setSourceProperty('revision_id', $row->getSourceProperty($this->configuration['field_name'] . '_revision_id'));
   }
   // Get field API field values.
   foreach (array_keys($this->getFields('paragraphs_item', 'contact')) as $field) {
     $item_id = $row->getSourceProperty('item_id');
     $revision_id = $row->getSourceProperty('revision_id');
     $row->setSourceProperty($field, $this->getFieldValues('paragraphs_item', $field, $item_id, $revision_id));
   }
   return parent::prepareRow($row);
 }
 /**
  * {@inheritdoc}
  */
 public function fields() {
   $fields = [
     'item_id' => $this->t('Item ID'),
     'revision_id' => $this->t('Revision ID'),
     'field_name' => $this->t('Name of field'),
   ];
   return $fields;
 }
 /**
  * {@inheritdoc}
  */
 public function getIds() {
   $ids['item_id']['type'] = 'integer';
   $ids['item_id']['alias'] = 'fci';
   return $ids;
 }
}

5. Implementați Hook-ul de Migrare

Adăugați următorul cod în fișierul .module al modulului dvs.:

<?php
use Drupal\migrate\Plugin\MigrationInterface;
use Drupal\migrate\Plugin\MigrateSourceInterface;
use Drupal\migrate\Row;
/**
* Implements hook_migrate_MIGRATION_ID_prepare_row().
*/
function custom_migrate_d7_node_organization_prepare_row(Row $row, MigrateSourceInterface $source, MigrationInterface $migration) {
 $values = $row->getSourceProperty('field_contact');
 $value_new = [];
 if ($values) {
   foreach ($values as $value) {
     $value_new[] = ['item_id' => $value['value']];
   }
   $row->setSourceProperty('field_contact', $value_new);
 }
}

6. Pași finali

Odată ce ați finalizat cu succes toți pașii de mai sus, puteți rula migrarea și urmări cum paragrafele dvs. sunt transferate de la Drupal 7 la Drupal 8. Luați-vă un moment pentru a verifica rezultatele înainte de a continua cu orice sarcini suplimentare legate de paragrafe.

Nu uitați să testați temeinic într-un mediu de dezvoltare înainte de a încerca această migrare pe un site de producție.

Top