Prise en main

Installation

PageTree s’installe depuis le back-office d’October CMS, sans ligne de commande. Cette page décrit les prérequis, l’installation et la configuration de départ.

Prérequis

Optionnel :

• RainLab.Translate : pages et slugs traduits ;
• le multisite d’October CMS : balises hreflang générées par le composant pageTreeSeo.

Licence et projet October CMS

PageTree est un plugin payant. Comme tous les plugins de la marketplace, il s’installe au travers d’un projet de votre compte octobercms.com :

• un projet regroupe les licences d’un site : la licence d’October CMS et celles des plugins et thèmes que vous y avez ajoutés ;
• chaque projet a une clé de licence (format XXXXX-XXXXX-XXXXX-XXXXX), visible sur la page du projet, qui relie votre site à ce projet ;
• un plugin acheté est rattaché au projet choisi au moment de l’achat : pour l’utiliser sur un autre site (un autre projet), il faut une autre licence.

Installer depuis le back-office

Tout se fait dans le navigateur. Connectez-vous au back-office avec un compte autorisé à faire les mises à jour, par exemple le super utilisateur créé à l’installation d’October CMS.

1. Achetez PageTree. Sur octobercms.com, ouvrez la fiche de PageTree et achetez le plugin pour le projet de votre site.
2. Ouvrez l’écran des mises à jour. Dans le back-office, allez dans Réglages, catégorie Système, puis Mise à jour.
3. Rattachez le site au projet, si ce n’est pas déjà fait :
   • cliquez sur Enregistrer le logiciel ;
   • collez la clé de licence du projet dans le champ Clé de license ;
   • cliquez sur Attacher un projet.
   Si l’écran affiche déjà un encadré Projet avec le nom du propriétaire, le site est rattaché : passez à l’étape suivante.
4. Installez les plugins du projet. Cliquez sur Installer des packages, puis sur Synchroniser le projet. October CMS télécharge les plugins et thèmes du projet absents du site, dont PageTree, puis met à jour la base de données. Vous pouvez aussi cliquer sur Installer sur la ligne de PageTree, dans l’onglet Projet.
5. Ouvrez PageTree. À la fin de l’installation, la page se recharge et l’entrée Block Pages apparaît dans le menu du back-office.

Si l’installation échoue depuis le back-office (hébergement qui limite la mémoire de PHP ou l’écriture des fichiers, par exemple), passez par la ligne de commande ci-dessous ou consultez le Dépannage.

Pour les développeurs : la ligne de commande

Les mêmes étapes, depuis la racine du site :

1. Rattachez le site au projet avec sa clé de licence. C’est inutile si la clé a été saisie à l’installation d’October CMS.

   php artisan project:set XXXXX-XXXXX-XXXXX-XXXXX

2. Installez les plugins et thèmes du projet, dont PageTree. La commande lance aussi les migrations.

   php artisan project:sync

3. Pour relancer les migrations seules :

   php artisan october:migrate

Le plugin est téléchargé depuis la passerelle d’October CMS par Composer, sous le nom de paquet lucaspalomba/pagetree-plugin, et installé dans plugins/lucaspalomba/pagetree. Il n’est pas distribué en dehors de la marketplace.

Déployer sur plusieurs serveurs

L’installation ajoute PageTree au composer.json du site. Le fichier auth.json, à la racine, contient les identifiants du projet qui autorisent Composer à télécharger les plugins payants.

• Versionnez composer.json et composer.lock, mais gardez auth.json hors de tout dépôt public : copiez-le sur chaque serveur, ou recréez-le avec php artisan project:set.
• Sur un serveur, installez puis migrez :

  composer install
  php artisan october:migrate

• Une erreur Invalid credentials (HTTP 403) signifie que auth.json manque ou que la licence du projet n’est plus active. Voir Dépannage.

Donner les permissions

Le super utilisateur a accès à tout. Pour autoriser un autre rôle à utiliser PageTree :

1. Allez dans Réglages → Administrateurs, puis ouvrez le rôle ou l’administrateur concerné.
2. Dans l’onglet des permissions, section PageTree, cochez :
   • Gérer les pages de blocs pour créer, modifier et supprimer des pages ;
   • Gérer les réglages des pages de blocs pour modifier les réglages du plugin.
3. Enregistrez.

Les blocs personnalisés sont réservés aux super utilisateurs : aucune permission ne peut les ouvrir à un autre rôle. Voir Permissions et réglages.

Vérifier les réglages

Les réglages se trouvent dans Réglages → Réglages des pages de blocs (catégorie PageTree). Ils permettent notamment de :

• renommer l’entrée du menu (Libellé du menu, « Block Pages » par défaut) ;
• choisir les feuilles de style et scripts de l’aperçu quand aucun layout n’est sélectionné ;
• définir les valeurs SEO par défaut : nom du site, modèle de titre, robots, compte Twitter/X, image de partage.

Le détail de chaque réglage est sur la page Permissions et réglages.

Étapes suivantes

• Vérifier que votre thème a un layout
• Créer et publier votre première page