Avant la montée de version

Compatibilité des versions du "Thème Paris.fr" avec les versions de LUTECE

Le thème Paris.fr utilise des ressources qui dépendent de la version de LUTECE, particulièrement de la version du coeur LUTECE - core- . Il faut donc s'assurer que la version du thème déclarée dans votre POM est bien compatible avec la version de LUTECE

  • Utiliser la version 1.1.3 du thème pour les sites qui inclut le CORE LUTECE en version 6.0.0
  • Utiliser les versions entre la 1.1.3 et la 1.5.6 du thème pour les sites qui inclut les versions de 7.0.0 à 7.0.9 du CORE LUTECE
  • Utiliser les versions 2.0.0 du thème pour les sites qui inclut les version 7.0.10 ou supérieures du CORE LUTECE

Evaluer une montée de version

Il est important de comprendre que la montée de version sera plus ou moins ardue en fonction de la version de départ et de la façon dont les différents éléments composants la charte graphique ont été codés.

Comment estimer le temps que prendra cette montée de version ?

Plusieurs scénari sont en présence

  1. Mon application n'utilise pas le Thème Paris.fr

    On peut considérer qu'il s'agit d'une réécriture complète.

    Entre 15 et 25 jours en fonction de la taille du projet

  2. Mon application utilise le Thème Paris.fr dans une version antérieure à la version 1.4

    En fonction du nombre de surcharges et d'ajout de code JS complexe et si les développeurs ont été utilisés au mieux les macros,il faudra modifier de 20% à 40% du code -css / macro ou html [templates]/js- sera à modifier

    Entre 10 et 15 jours en fonction de la taille du projet

  3. Mon application utilise le Thème Paris.fr dans une version supérieure à la version 1.4

    En fonction du nombre de surcharges et d'ajout de code JS complexe et si les développeurs ont été utilisés au mieux les macros, il faudra modifier de 5% à15% du code -css / macro ou html [templates]/js- de l'application

    Entre 5 et 10 jours en fonction de la taille du projet

Acccéder au pas à pas

Les points d'attention

Le code a changé...

Attention

Votre site aura un rendu différent !

Potentiellement, vous pouvez avoir un écart graphique entre vos maquettes originelles et la version mise à jour... Cela peut tout à fait se justifier auprès de votre MOA, par une amélioration de l'accessibilité, une mise à jour vers des composants plus récents -impératif de sécurité- et une meilleure cohérence graphique avec Paris.fr.

Vous avez utilisé du HTML, fourni par la version précédente, il est possible que vous deviez faire des modifications. Pour cela reportez-vous à la documentation du composant

  • Le code HTML généré peut avoir changé. Cela peut impliquer des régressions mineures si vous avez utiliser le code HTML, notamment dans du contenu et non pas la macro
  • Les feuilles de styles XSL peuvent aussi nécessiter une maintenance pour les "portlets" -rubriques en administration du site- notamment.

Mettre à jour la base de données

Il est probable que pour faire votre montée de version il faille passer des scripts de mise à jour. Il faut vérifier cela en vérifiant les versions

  • Script de mise à jour du thème Paris.fr : ils sont disponibles dans le dossier "monsite\WEB-INF\sql\upgrade" numéroté de la version antérieur à la version en cours, par exemple : update_db_themeparisfr-1.5.5-2.0.0.sql
  • Script de mise à jour de Lutece : ils sont disponibles dans le dossier "monsite\WEB-INF\sql\upgrade" numéroté de la version antérieur à la version en cours, par exemple : update_db_lutece_core-7.0.16-7.0.17.sql
  • Script de mise à jour des plugins : ils sont disponibles dans le dossier "monsite\WEB-INF\sql\plugins\nomduplugin\upgrade" numéroté de la version antérieur à la version en cours, par exemple : update_db_blog_3.0.0-3.0.1.sql

Des librairies mises à jour

Il est possible que certaines librairies javascript ou css lors des montées de version ne soient plus disponibles. Il est conseillé dans ce cas de les intégrer dans votre site en tant que surcharge si vous avez besoins de conserver la version.

Les étapes à suivre ...

  1. Modifier son POM

    Il vous faut modifier la version du pom pour le composant "Thème Paris.fr -artifact :site-theme-parisfr-, en modifiant la version vers 2.0.0, consulter la version de la dernière version sur gitlab

  2. Mettre à jour la base de données

    Passer le script de mise à jour disponible sur gitlab ou dans votre webapp.

  3. Construire l'application en local

    Utiliser Maven et le goal lutece:site-assembly pour construire votre site, et vérfifier que votre site génère bien le war sans erreur.

  4. Mettre à jour les templates, XSL ou contenus

    Faire ue montée de version va necessité de retoucher vos templates. Si votre site utilise déjà les macros d'une version antérieure du Thème cela se fera rapidement. Si votre site contient du contenu de type éditorial, il faudra potentielement revoir les feuilles de styles XSl, voire modifier certain contenus HTML.
    Par exemple le composant "Alert" a vu son code évolué entre les version 1.4 et 1.5 ce qui occasionne une maintenance du code HTML qui est embarque dans une rubrique HTML - voir le détail d'une montée de version vers 2.0.0-

  5. Vider vos caches !

    Il est important de bien vider les caches du navigateur après un déploiement.

  6. Une fois déployé...

    Il est important, que vos propriétés du site sont à jour -voir configuration du site-. Bien vérifier les propriétes telles que : nom du site, urls (Fo / Bo), email du webmestre, email no-reply,..

Acccéder au pas à pas