Monter son site en v2.0 du Thème Paris.fr

Une montée de version va nécessiter tout d'abord de verifier quels sont les mises à jour à faire sur la base de données.
Pour cela il faut vérifier si des scripts de montée de version existent dans les dossier "WEB-INF/sql/upgrade" pour le CORE et le "Thème Paris.fr" ou "WEB-INF/sql/plugins/nomduplugin/upgrade" pour les plugins.

N.B. : Vérifier que la table core_datastore contient bien tous les paramètres nécessaires au fonctionnement du thème. Si ce n'est pas le cas cela peut occasionner des erreurs bloquantes dès le démarrage du site.

Pas à pas pour faire la montée de version

Exemple d'une mise à jour d'un site en version 1.4 du Thème et d'une version 7.0 de Lutece.

Mise à jour de la base de données :

  1. Lutece Core : Mise à jour de la version du CORE : 7.0.x -> 7.1. Listes les fichier "update_db_lutece_core-X.X.X-Y.Y.Y.sql".
    Dans notre exemple il suffisait d'éexécuter le fichier "update_db_lutece_core-7.0.16-7.0.17.sql".
  2. Thème Paris.fr : Passage de la 1.45 -> 2.0.0 - > 4 Scripts dans l'ordre update_db_themeparisfr-1.4.2-1.4.6 .sql, update_db_themeparisfr-1.4.6-1.5.3.sql, update_db_themeparisfr-1.5.3-1.5.4.sql et update_db_themeparisfr-1.5.5-2.2.0.sql. N.B.: Cela nécessite peut être d'ajuster les valeur dans les "Propriétés du Site", onglet "Thème Paris.fr" en BO comme celle sur l'affichage des menus.
  3. Plugins : Montée de version du plugins FORMS : de la version 2.4.5 à la version 3.0.0. Aucun script à passer

Modifications à apporter :

  • Supprimer les surcharges pour tester le site avec le thème seulement et rajouter seulement les surcharges nécessaires.
  • Dans les templates surchargés, il faut supprimer un certain nombre de classes. Il faudra parfois les remplacer, mais pas systématiquement. Si l'on prend l'exemple des classes qui gères les marges "py-N" et "my-N" il faut surtout les supprimer des blocs principaux (div,p,articles,.portlet) car cela ajoute des marges aux marges définies par défaut. Parcontre il est possible que vous ne deviez simplement procéderà une substitution des anciennes classes BS4 par les classes du Thème. Par exemple, changer une classe "mt-4" en "mt-m"
    Attention aussi aux classes mb-X mais par défaut ce sont toujours les marges hautes (mt-X) qui sont utilisées pour l'espacement des contenus.
    Exemple de code à modifier : <@cRow class="white-bg-color py-5 my-5py-l my-l justify-content-center">...<@cRow>
  • Modification des rubriques de contenus contenant du code HTML généré. Il est possible que le code ne soit plus le même, comme c'est le cas pour le composant "Alert". Il faut alors bien consulter la documentation pour faire la correspondance du code HTML car souvent on ne pourra pas utiliser les macros dans les "Rubriques" gérées par l'administration du site.
  • Modification des feullles de styles -XSL- quand elles embarquent un composant impacté. Dans le cas présent, il a fallu modifier la XSL d'un portlet HTML - plugin HTML- qui contient le code du composant "Alert". N.B.: Il ne s'agit de modifier une feuille de style en BO. Pour cela il faut la télécharger et la reuploader dans la menu "Charte / Gestion des feuilles XSL"

Point d'attention :

Souvent dans les macros on été ajoutées des classes pour les marges il faut les supprimer car par défaut le thème gère la majorité des cas de figures pour l'espacement des contenus.