Développeurs

Mises à jour

Ce qu’il faut faire à chaque mise à jour de PageTree, et un résumé des changements par version.

Procédure générale

Les mises à jour de PageTree arrivent par votre projet October CMS, comme celles du cœur et des autres plugins de la marketplace.

1. Sauvegardez la base de données et les fichiers du site.
2. Lisez ci-dessous les notes de la version que vous allez installer.
3. Mettez à jour depuis la racine du site :

   php artisan october:update

   Cette commande met à jour October CMS et les plugins (elle équivaut à composer update suivi de php artisan october:migrate). Pour ne mettre à jour que PageTree :

   composer update lucaspalomba/pagetree-plugin
   php artisan october:migrate

   Sans ligne de commande : Réglages → Mise à jour, bouton Vérifier les mises à jour, puis installez les mises à jour proposées.
4. Vérifiez la version installée :

   php artisan plugin:list

   Ou dans le back-office : Réglages → Mise à jour → Gérer les plugins.
5. Sur vos autres serveurs, déployez le composer.lock mis à jour, puis lancez composer install et php artisan october:migrate.

Désinstaller

Passer à la 2.0 (October CMS 4.2+)

La version 2.0 demande October CMS 4.2 ou supérieure. Les sites sous October CMS 3.x à 4.1 doivent rester sur PageTree 1.x (branche support/1.x, dernière version 1.0.7).

1. Mettez d’abord à jour October CMS en 4.2.
2. Mettez ensuite à jour PageTree et lancez php artisan october:migrate.

La 2.0 n’a pas de migration de base de données : les pages et les blocs existants sont conservés tels quels. Les blocs développés pour PageTree n’ont pas besoin de modification. En revanche, le JavaScript du back-office écrit pour l’éditeur Vue 2 doit être porté en Vue 3.

Passer à la 2.1

• Lancez php artisan october:migrate pour ajouter les nouveaux champs SEO.
• Les pages inactives, non publiées ou programmées dans le futur renvoient désormais une erreur 404. Vérifiez les valeurs Actif et Publié de vos pages après la mise à jour.
• Le code Twig tapé dans le contenu d’un bloc (par exemple {{ this.page.title }} dans un bloc Texte) est désormais affiché comme du texte au lieu d’être exécuté.

Passer à la 2.2

• Lancez php artisan october:migrate pour créer la table des blocs personnalisés.

Passer à la 2.3

• Lancez php artisan october:migrate : il crée la table lucaspalomba_pagetree_versions de l’historique des versions. Tant qu’il n’a pas tourné, les pages sont enregistrées comme avant, sans historique.
• L’entrée du menu demande désormais la permission Gérer les pages de blocs. Les utilisateurs qui n’ont que Gérer les réglages des pages de blocs ouvrent les réglages depuis la page Réglages.
• Les pages sont reconstruites quand un bloc personnalisé qu’elles utilisent change, sans avoir à les réenregistrer.

Passer à la 2.4

• Pas de migration de base de données.
• Les administrateurs qui ont la permission Gérer les pages de blocs voient désormais sur le site les pages inactives, non publiées ou programmées, au lieu d’une erreur 404. Pour vérifier ce que voient les visiteurs, utilisez une fenêtre de navigation privée.
• Vos blocs et vos blocs personnalisés continuent de fonctionner sans modification. Pour rendre leurs champs modifiables en place, utilisez le filtre pagetreeEditable.

Résumé des versions

2.4.0

• Édition sur le site : les éditeurs passent une page en mode édition depuis le site, modifient les textes en place, déplacent, masquent, dupliquent ou suppriment des blocs, ouvrent le formulaire d’un bloc dans un panneau latéral et enregistrent tout en une fois.
• Édition dans l’aperçu de l’éditeur : barre d’outils au survol des blocs (monter, descendre, bloc parent, modifier) et textes modifiables en place. Les liens sont désactivés dans l’aperçu.
• Filtre Twig pagetreeEditable pour rendre les champs des blocs modifiables en place.
• La page d’URL / est servie comme page d’accueil (elle renvoyait une erreur 404).
• Dans l’éditeur, l’URL d’une nouvelle page commence par / et suit le titre.

2.3.0

• Historique des blocs, par langue, dans l’éditeur : prévisualiser et restaurer une version précédente, nommer les versions avec un titre et une description. Voir Historique des versions.
• Sécurité : la route d’aperçu ne compile plus en Twig le HTML envoyé par le navigateur, et les erreurs ne renvoient plus de détails internes.
• Les pages sont reconstruites quand leurs blocs rendus changent : un bloc personnalisé modifié est à jour sans réenregistrer la page, et les URL absolues suivent l’hôte courant.
• L’entrée du menu n’apparaît qu’avec la permission qui ouvre l’éditeur ; l’écran de réglages est traduit.
• create:block : le dossier correspond au nom de la classe, les noms invalides sont refusés et le formulaire généré ne déclare plus id ni isActive.
• Le navigateur de l’éditeur signale les pages non publiées et celles dont la publication est programmée.

2.2.0

• Blocs personnalisés : les super utilisateurs créent des blocs depuis la section Blocs personnalisés de l’éditeur, avec un constructeur de formulaire, des sources de données (entrées Tailor ou modèles de plugins) et un template Twig.
• Les blocs personnalisés inactifs sont signalés dans le navigateur, comme les pages inactives.

2.1.0

• Gestion des pages dans l’Éditeur d’October CMS, groupées par niveau d’URL, avec le layout et le statut dans l’en-tête.
• Fenêtre d’aperçu détachable.
• SEO : titre et description méta avec aperçu, Open Graph, carte Twitter, URL canonique, robots, exclusion du sitemap, composant pageTreeSeo (hreflang, JSON-LD).
• Composants October CMS utilisables comme blocs.
• Nouveaux blocs : Bouton, Citation, Questions / réponses, Espace, Appel à l’action, Fichiers, Bannière, Image et texte, Cartes, Section. Styles basés sur :where() et les variables --ptb-*.
• Case Affiché ? ajoutée automatiquement à chaque bloc.
• Seules les pages actives, publiées et dont la date est passée sont servies.
• Le contenu des blocs n’est plus évalué comme du Twig.
• Titre H1 et Lien retirés de la bibliothèque (toujours affichés et modifiables). Bloc Logo supprimé.
• Correctifs : pages contenant un type de bloc disparu, valeurs par défaut des formulaires de blocs, entrées vides de styles et scripts de l’aperçu, contrôles de l’onglet SEO.

2.0.0

• Compatibilité avec October CMS 4.2 : composants Vue du back-office portés en Vue 3.
• Les routes pagetree/* du back-office exigent une session back-office et la permission lucaspalomba.pagetree.pages. Permissions des pages et des réglages enregistrées.
• Correctifs : composant ajouté deux fois dans une cellule de grille, « Retour aux composants » sur les blocs avec répéteur, débordement du panneau de formulaire, modèles de grille, sélecteur d’icônes, URL de feuille de style de l’aperçu.

1.0.7

• Dernière version pour October CMS 3.x et 4.1. Ajout d’un champ layout aux pages.