Derniers messages
Derniers sujets
FAQ — Installer, mettre à jour et retirer un addon
Les questions qui reviennent sur les modules, les widgets et les thèmes qu'on ajoute à son site. Tout se passe dans Administration → Thèmes & Addons.
Où trouver des addons ?
- Marketplace, en haut de Thèmes & Addons : le catalogue des addons officiels, installés en un clic.
- Les sujets du forum Créer pour NeoFrag : les tutoriels et les addons partagés par la communauté, chacun avec
son archive
.zipjointe.
Comment installer une archive .zip ?
Thèmes & Addons → Ajouter, choisis l'archive, puis Ajouter. Le site répond par exemple « Le module Astuces a été installé ». Ensuite :
- un module a ses pages, et son entrée dans l'administration s'il en a une ;
- un widget se pose avec l'éditeur en direct, dans la zone de ton choix ;
- un thème s'active depuis le menu de sa carte : Activer.
Une archive peut porter plusieurs addons, par exemple un module et son widget : le site installe les modules d'abord.
« Le composant ne peut pas être installé, veuillez vérifier son contenu »
Le site n'a pas trouvé d'addon dans l'archive. Elle doit contenir, à sa racine :
- soit le dossier de l'addon lui-même (
bienvenue/, avecbienvenue/bienvenue.phpdedans) ; - soit des dossiers
modules/,widgets/,themes/, qui contiennent chacun leurs addons.
L'erreur la plus courante : compresser le dossier qui contient l'addon. Sous Windows, sélectionne le dossier de
l'addon lui-même (ou les dossiers modules et widgets ensemble), puis clic droit → Compresser.
« … veuillez vérifier la présence des numéros de version »
L'addon a été trouvé, mais sa carte d'identité (__info()) ne dit pas sa version ('version') ou la version de
NeoFrag qu'il demande ('depends' => ['neofrag' => '…']). C'est à son auteur de les ajouter.
« Le module … nécessite la version … de NeoFrag »
L'addon a été écrit pour une version plus récente que celle de ton site. Mets d'abord le site à jour : Administration → Monitoring.
« … a besoin de : … Installe-les d'abord. »
L'addon dépend d'un module qui n'est pas installé : c'est le cas d'un widget qui montre ce que fait un module. Installe le module d'abord, ou l'archive qui porte les deux.
« … est déjà installé en version … » ou « … avec une version supérieure »
La même version est déjà là : il n'y a rien à faire. Une version plus ancienne que celle installée est refusée : le site ne revient pas en arrière.
Comment mettre à jour un addon ?
- Un addon du marketplace : Thèmes & Addons → Mises à jour. Les archives sont téléchargées et vérifiées avant d'être appliquées.
- Un autre addon : envoie l'archive de la nouvelle version par Ajouter. Le site répond « … a été mis à jour ».
Une mise à jour garde tout ce qui existe : les données d'un module (ses tables ne sont créées que si elles manquent, et ses évolutions passent par ses migrations), les réglages d'un widget, la mise en page d'un thème.
Puis-je installer un addon par FTP ?
Oui : dépose son dossier dans modules/, widgets/ ou themes/ à la racine du site, puis Thèmes & Addons →
Scanner le disque. Le site liste les addons qu'il a trouvés ; coche ceux à installer.
Comment retirer un addon ?
- Un module ou un widget se désactive, dans le menu de sa carte : Désactiver. Ses pages et ses widgets disparaissent du site ; ses données restent, et reviennent si tu le réactives.
- Pour le retirer pour de bon : Désinstaller, dans le même menu. Ses tables, ses données et ses fichiers
partent, après une sauvegarde prise juste avant (dossier
backups/addonsdu serveur). Un module dont un autre addon a besoin est refusé : la fenêtre dit lesquels, à désinstaller d'abord. - Pour vider un module sans le retirer : Remettre à zéro. Ses données sont effacées (sauvegardées avant) et il repart comme au jour de son installation ; ses réglages et ses permissions restent.
- Un thème que tu as ajouté, et qui n'est pas le thème actif, se supprime : Supprimer, dans le menu de sa carte. Sa mise en page, sa configuration et ses fichiers sont retirés, et ce n'est pas réversible. Réinstaller par défaut remet sa mise en page d'origine : celle que tu as faite est perdue.
L'addon s'est installé, mais une page affiche une erreur
Administration → Monitoring → Journal des erreurs dit ce qui s'est passé, avec le fichier et la ligne. Si l'addon vient d'un sujet du forum, réponds-y en citant cette ligne : son auteur saura quoi corriger.
