Drupal migrations and module/theme upgrades. Presentation given at the DrupalCafe of 20 november 2015 at the One Shoe office.

1. Upgrades and Migrations
Yaron Tal
20-nov-2014

2. About me
● Yaron Tal
● Drupal backend developer
@oneshoe
● Multiple big migrations
● http://ytal.nl

3. What do you migrate and
upgrade?
● Tests
● Functionality
● Front­end
● Back­end
● Content
● Migrate module

4. Tests
● Test plans
● Unit tests, behat, …
● Documentation

5. Upgrade: Front­end
https://www.drupal.org/update/themes/6/7
● New jQuery
● SASS?
● Twig in D8

6. Upgrade: Back­end
https://www.drupal.org/update/modules/6/7
● Module upgrader
(https://www.drupal.org/project/drupalmoduleupgrader)
● Coder
● Field API, DB API,
hooks, views API, ...

7. Upgrade: Backend Example
Drupal 6
foreach ($properties as $property) {
$i++;
$joins[] = 'JOIN $property['table'] . 'p' . $i . ' ON n.nid=p' . $i . '.nid';
$select[] = 'p' . $i . $property['column'];
}
$query = 'SELECT ' . implode(', ', $select) . ' FROM {node} n ' . implode(' ', $joins);
Drupal 7
$query = db_select('node', 'n');
foreach ($properties as $property) {
$alias = $query­>
join($property['table'], 'p', 'n.nid=p.nid');
$query­>
addField($alias, $property['column']);
}

8. Content
● Migrate module
(https://www.drupal.org/project/migrate)
● D2D migrate
(https://www.drupal.org/project/migrate_d2d)
● Other modules for
other sources

9. Migrate module
● OOP
● Migration classes
● Source classes
● Destination classes
● Drush

10. Migrate module: Mapping
● Node
● File
● Taxonomy
● Users
● Custom entity

11. Migrate module: Inline media
libraries_load('simplehtmldom')
$html = str_get_html($text);
foreach ($html­>
find('img') as $image) {
}
● Media module
(https://www.drupal.org/project/media)
● Youtube/vimeo/...

12. Migrate module: Inline links
libraries_load('simplehtmldom')
$html = str_get_html($text);
foreach ($html­>
find('a') as $link) {
}
● Aliases, redirects, node table.
● New version of node might not
exist.

13. Migrate module: advanced
● Stubs
● Continuous migrations (Highwater)
● $this­>
systemOfRecord = Migration::DESTINATION;

14. Conclusion
● Upgrade tests and documentation
● Upgrade theme and modules using the module
upgrader
● Check code with coder module
● Migrate content using migrate module and helper
module for specific source
● Use an html parser to find images, links and other
html elements that need changing

15. Questions?