Améliorations de Droopler 1.4 vers la Version 2.0

La version 2.0 de Droopler a récemment été publiée, apportant de nombreuses nouvelles fonctionnalités. Nous avons décidé d'introduire des changements majeurs pour améliorer le travail éditorial, c'est pourquoi la mise à niveau depuis la version précédente 1.4 est un processus complexe qui nécessite l'attention d'un programmeur.

Je vais ici décrire toutes les étapes nécessaires pour migrer vers Droopler 2.0. Je diviserai ce guide en deux parties, selon la méthode d'installation. Il sera utile pour les personnes utilisant Composer, et pour celles qui préfèrent les paquets de distribution de drupal.org.

Le résumé des informations fournies ici se trouve dans la documentation. N'oubliez pas de faire une sauvegarde avant de procéder à toute action.

Droopler installé via Composer

Depuis le tout début de l'existence de Droopler, la méthode d'installation préférée était l'utilisation de Composer. Les pages installées selon nos recommandations ont la structure suivante dans le répertoire principal :

Téléchargement de la version 2.0 avec les modules dépendants

La première étape, la plus importante, est de télécharger la nouvelle version de Droopler (avec les modules associés) en utilisant la commande :

composer update droptica/droopler --with-all-dependencies

1) Mise à jour du skin droopler_subtheme

La deuxième étape consistera à adapter le skin droopler_subtheme existant pour fonctionner avec la nouvelle version. Assurez-vous d'abord que la liste des régions dans le fichier droopler_subtheme.info.yml est identique à la suivante :
régions :

regions:
  header: En-tête
  secondary_menu: 'Menu secondaire'
  primary_menu: 'Menu principal'
  lang_menu: 'Menu des langues'
  page_top_content: 'Haut de page'
  page_top: 'Haut de page'
  page_bottom: 'Bas de page'
  page_bottom_content: 'Bas de page'
  highlighted: En surbrillance
  featured_top: 'En vedette en haut'
  breadcrumb: Fil d'Ariane
  admin_tabs: 'Onglets administrateur'
  content: Contenu
  facets_top: 'Facettes en haut'
  facets_left_top: 'Facettes gauche en haut'
  facets_left: 'Facettes gauche'
  sidebar_left: 'Barre latérale gauche'
  sidebar_right: 'Barre latérale droite'
  featured_bottom_first: 'En vedette en bas premier'
  featured_bottom_second: 'En vedette en bas second'
  featured_bottom_third: 'En vedette en bas troisième'
  footer_first: 'Pied de page premier'
  footer_second: 'Pied de page second'
  footer_third: 'Pied de page troisième'
  footer_fourth: 'Pied de page quatrième'
  footer_fifth: 'Pied de page cinquième'
  footer_sixth: 'Pied de page sixième'
  footer_main: 'Pied de page principal'

Ensuite, allez sur la page du dépôt droopler_project et remplacez les fichiers suivants dans votre skin par des versions plus récentes – en veillant à ne pas supprimer vos propres modifications :

• gulpfiles.js
• package.json

Supprimez le fichier package-json.lock et exécutez les commandes suivantes :

• npm install dans le répertoire profiles/contrib/droopler/themes/custom/droopler_theme,
• gulp compile dans le répertoire profiles/contrib/droopler/themes/custom/droopler_theme.
• npm install dans le répertoire themes/custom/droopler_subtheme,
• gulp compile dans le répertoire themes/custom/droopler_subtheme.

2) Restauration de l'ancien schéma de couleur

La version 2.0 a un nouveau schéma de couleur – le bleu a été changé en rouge foncé. Si vous souhaitez restaurer l'ancien schéma de couleur, localisez le fichier suivant :
themes/custom/droopler_theme/scss/config/_old_color_scheme.scss
Copiez son contenu dans le fichier _colors.scss de votre skin droopler_subtheme.

3) Réalisation de la migration du modèle Composer

Avec la sortie de Drupal 8.8, le modèle Composer officiel a été mis à disposition ; il est légèrement différent de celui précédemment utilisé, également dans Droopler 1.4. Si vous préférez les solutions les plus récentes, mettez à niveau votre fichier composer.json vers celui disponible dans le dépôt droopler_project. Si votre version ne diffère pas de l'originale, vous pouvez simplement remplacer ce fichier par la version plus récente. Après avoir effectué les modifications, supprimez les répertoires scripts/composer et drush.

4) Mise à jour de la base de données

Je présenterai le processus de mise à jour de la base de données à la fin de l'article, car il est le même pour tous les types d'installations.

Droopler installé depuis Drupal.org

Installer Droopler à partir du package sur le site drupal.org est très simple ; cependant, le processus de mise à niveau nécessite quelques étapes supplémentaires, plus difficiles. Le niveau de difficulté variera en fonction de si Drupal et les modules externes ont été mis à jour après l'installation de la version 1.4.

Tout d'abord, téléchargez la nouvelle version 2.0 de Droopler depuis https://www.drupal.org/project/droopler.

1) Mise à jour de Droopler vers la nouvelle version

Commençons par la mise à jour de Drupal lui-même. Remplacez les répertoires core et vendor par ceux du fichier que vous venez de télécharger. Téléchargez la version 1.6 du module Pathauto (depuis cette adresse) et remplacez la version existante de ce module dans le répertoire modules/contrib/pathauto (il y aura encore le temps de passer à la version la plus récente). Exécutez le script de mise à jour /update.php.

2) Mise à jour des modules vers la nouvelle version

Il est maintenant temps pour les modules. Supprimez tous les répertoires à l'exception de menu_link_attributes du répertoire modules/contrib et remplacez-les par les modules du package de drupal.org, du répertoire profiles/droopler/modules/contrib. Ensuite, exécutez le script /update.php.

Si vous rencontrez une erreur dans le module Paragraph, supprimez la fonction paragraphs_update_8017() du fichier modules/contrib/paragraphs/paragraphs.install et exécutez à nouveau le script /update.php.

3) Suppression des modules et profils obsolètes

La première étape pour mettre à jour Droopler sera de supprimer l'ancien code :

• Supprimez les répertoires suivants du répertoire principal : drupal_config, drush, libraries, profiles, scripts, ainsi que tous les fichiers. Laissez les répertoires modules, sites et themes. Assurez-vous de ne pas supprimer les fichiers et répertoires ajoutés par vous.
• Supprimez les modules suivants du répertoire modules/contrib : admin_toolbar, better_exposed_filters, checklistapi, colorbox, config_update, contact_formatter, ctools, entity_reference_revisions, facets, features, field_group, geysir, google_analytics, google_tag, link_attributes, linkit, metatag, paragraphs, pathauto, redirect, search_api, simple_sitemap, smtp, svg_image, token, tvi. Laissez le module menu_link_attributes (vous pouvez également profiter de cette occasion pour le mettre à jour avec la nouvelle version depuis la page https://www.drupal.org/project/menu_link_attributes).

4) Téléchargement des fichiers de la version 2.0

Téléchargez les fichiers restants du package Droopler 2.0 depuis drupal.org sur votre site. Faites attention à ne pas écraser les répertoires core, modules, sites, themes, et vendor.

5) Mise à jour de la base de données

Rendez-vous à la fin de l'article pour en savoir plus à ce sujet.

Si vous rencontrez une erreur en raison d'un skin droopler_theme manquant, exécutez dans la base de données une requête (par exemple via phpMyAdmin) pour reconstruire les chemins dans le système (la fonction drupal_flush_all_caches() fera la même chose) :

SELECT * FROM `key_value` WHERE `name` LIKE 'system.profile.files'

6) Personnalisation du skin

Si le skin droopler_subtheme que vous utilisez ne diffère pas de l'original, vous pouvez le changer en Droopler Theme 8.x-2.0 (cliquez sur Apparence dans le menu du haut).

Si votre skin droopler_subtheme a été modifié, mettez-le à niveau vers la version 2.0. Si vous utilisez SCSS, consultez le début de cet article pour une description de la procédure de migration du skin pour les installations avec Composer. Elle est presque identique pour les installations depuis drupal.org.

Si vos modifications sont mineures et que vous ne voulez pas perdre de temps à mettre à jour votre skin, construisez-le à partir de zéro. Dans le répertoire profiles/droopler/themes/custom/droopler_theme, vous trouverez les sous-répertoires STARTERKIT_SCSS et STARTERKIT_SCSS contenant des modèles de skins pour les utilisateurs qui utilisent et n'utilisent pas un compilateur SCSS, respectivement. Chaque modèle contient un fichier README.md avec des instructions.

Mise à jour de la base de données

Droopler 2.0 comprend le chemin de mise à jour complet depuis la version 1.4. Il comprend :

• Intégration de nouveaux paragraphes
• Organisation et enrichissement des paragraphes existants avec de nouveaux champs
• Remplacement de toutes les images par Media
• Configuration du MegaMenu
• Procédures d'optimisation

Vous pouvez exécuter la mise à jour via le script /update.php ou en exécutant la commande

drush updb

Après la mise à jour, vous verrez le message suivant :

Cela signifie que toutes les opérations n'ont pas pu être effectuées automatiquement. Consultez la liste de vérification pour les éléments non sélectionnés. Pour effectuer la mise à jour donnée vous-même, suivez les instructions de la liste.

Résumé

À en juger par le nombre d'étapes indiquées ci-dessus, la mise à niveau vers la version 2.0 est un processus assez complexe. Si vous rencontrez des problèmes, veuillez soumettre un ticket sur la page de Droopler sur drupal.org. L'équipe de développement et leur communauté associée sont très actives, donc aucune question ne restera sans réponse.