Avant de paniquer — la grande majorité des problèmes (contenu invisible, formulaire muet, IA qui ne génère pas) se règle en 30 secondes en vérifiant un seul réglage. Lis attentivement la section concernée avant d'ouvrir un ticket : tu y trouveras presque toujours la solution.

1. Comment réinitialiser mon mot de passe ?

Si tu as oublié ton mot de passe, pas de panique : la procédure est entièrement libre-service et ne nécessite aucune intervention de l'agence.

  1. Ouvre la page de connexion habituelle (l'URL d'accès admin que ton agence t'a communiquée).
  2. Sous le formulaire, clique sur le lien « Mot de passe oublié ».
  3. Saisis l'adresse e-mail associée à ton compte, puis valide.
  4. Tu reçois sous une minute un e-mail contenant un code à 6 chiffres valable 15 minutes.
  5. Reporte ce code dans le formulaire, choisis un nouveau mot de passe (8 caractères minimum), confirme.
Tu ne reçois pas l'e-mail ? Vérifie d'abord ton dossier spam. Si rien n'arrive après 5 minutes, c'est probablement que le SMTP du CMS n'est pas configuré (ou que l'adresse e-mail enregistrée n'est plus la bonne). Dans ce cas, demande à un autre Administrateur de mettre à jour ton adresse dans Réglages → Administrateurs.

2. J'ai perdu l'accès à mon unique compte Administrateur

C'est le scénario le plus inconfortable, mais il a une solution. Le CMS ne contient pas de « super-admin caché » accessible depuis l'interface web : si plus personne n'a le mot de passe Administrateur, il faut passer par le serveur.

  1. Connecte-toi en SSH (ou demande à ton hébergeur de le faire) sur le serveur où tourne le CMS.
  2. Va dans le dossier backend/scripts/ du projet.
  3. Exécute le script de réinitialisation Administrateur fourni (il recrée un compte owner et envoie un mot de passe temporaire).
La solution recommandée reste toujours de contacter ton agence ou le partenaire qui t'a livré l'instance : elle a accès au serveur Plesk et règle ce type d'incident en quelques minutes. Évite à tout prix d'exécuter des scripts de recovery toi-même si tu n'es pas à l'aise avec une ligne de commande.

Pour éviter ce drame : crée toujours au moins deux comptes Administrateur dès la mise en route du site (un pour toi, un pour ton chef de projet par exemple). Voir bonnes pratiques.

3. Pourquoi mon contenu n'apparaît pas sur le site public ?

C'est de très loin la question numéro un. La réponse est presque toujours la même : tu as oublié de lancer un build.

Le Labo du Yeti est un CMS dit « headless » : ce que tu vois dans l'interface admin et ce que voient tes visiteurs sur le site public sont deux choses différentes. Tant que tu n'as pas cliqué sur « Lancer le build » dans Build du site, tes modifications restent invisibles côté public.

  1. Modifie ta page, ton article ou ton groupe cocon, puis enregistre.
  2. Va dans Build du site (menu Configuration).
  3. Clique sur le bouton orange « Lancer le build » en haut à droite.
  4. Attends la fin (quelques secondes à quelques minutes selon la taille du site), puis rafraîchis le site public (Ctrl+F5 pour ignorer le cache navigateur).
Le contenu apparaît toujours pas ? Vérifie que l'article ou la page est bien en statut Publié (et pas Brouillon ou Planifié), que sa date de publication est dans le passé, et que ton navigateur n'affiche pas une version en cache. Voir aussi la question 8 sur les statuts.

4. L'IA ne génère pas mon article ou ma page

L'IA s'appuie sur un fournisseur externe (Anthropic Claude par défaut). Si la génération échoue ou ne se lance pas, c'est presque toujours l'une de ces trois causes.

SymptômeCause probableSolution
Message « clé API non configurée » Aucune clé Anthropic n'est enregistrée Réglages → IA → coller la clé et tester
Génération bloque à 0 % Quota mensuel dépassé chez le fournisseur Vérifier l'usage dans Réglages → IA → onglet Consommation
Erreur 429 ou 529 Trop de demandes simultanées Attendre 1 minute, relancer une seule génération à la fois

Dans tous les cas, ouvre Réglages → IA : tu y trouves le statut du provider, un bouton Tester la connexion, et la consommation détaillée (tokens entrants / sortants par jour). Si le test échoue, le problème est en amont — vérifie ta clé sur le site du fournisseur.

5. Pourquoi mon formulaire n'envoie pas d'e-mail ?

Quand un visiteur soumet un formulaire de contact, le CMS doit pouvoir envoyer un e-mail via un serveur SMTP. Si tu ne reçois rien :

  1. Va dans Réglages → Général → SMTP.
  2. Vérifie que les champs sont remplis (hôte, port, utilisateur, mot de passe).
  3. Clique sur le bouton « Envoyer un e-mail de test » — tu dois recevoir un message en quelques secondes.
  4. Si le test passe mais que les formulaires restent muets, va dans Formulaires, ouvre la fiche du formulaire concerné, et clique sur le bouton Tester en haut à droite.
Astuce. Les hébergeurs mutualisés (OVH, Infomaniak…) bloquent souvent le port 25 sortant. Utilise plutôt port 587 avec STARTTLS ou port 465 avec SSL/TLS. Si tu utilises Gmail, il faut générer un « mot de passe d'application » dédié — pas ton mot de passe Gmail habituel.

6. Comment supprimer un Administrateur ?

Seul un autre Administrateur peut supprimer un compte Administrateur — un Webmaster ou un Client n'a pas ce droit. Procédure :

  1. Connecte-toi avec un compte Administrateur.
  2. Va dans Réglages → Administrateurs.
  3. Sur la ligne du compte à supprimer, clique sur l'icône poubelle, puis confirme.
Règle de sécurité absolue — il est impossible de supprimer le dernier compte Administrateur. Le CMS te bloquera avec un message explicite. C'est volontaire : sans Administrateur, plus personne ne peut accéder aux Réglages critiques. Crée d'abord un second Administrateur si tu veux remplacer le dernier.

7. Mon extension échoue à l'installation (Plesk)

Sur un hébergement Plesk, Node fonctionne mais npm n'est pas toujours dans le PATH système. Quand une extension a un package.json qui doit s'installer, le CMS lance un npm install automatique et échoue si npm est introuvable.

La solution est de pointer manuellement vers le binaire npm :

  1. Connecte-toi en SSH au serveur, ou demande à ton hébergeur.
  2. Ouvre le fichier backend/.env.
  3. Ajoute la ligne NPM_BIN=/opt/plesk/node/22/bin/npm (adapte le chemin selon ta version Node).
  4. Redémarre l'application Node depuis le panneau Plesk.
  5. Réinstalle l'extension depuis l'interface.

Pour plus de détails, consulte la documentation technique des extensions.

8. Quelle est la différence entre Brouillon, Planifié et Publié ?

Chaque contenu (page, article, page cocon) a un statut qui détermine sa visibilité côté public.

StatutVisible sur le site ?Quand l'utiliser
Brouillon Non, jamais Travail en cours, contenu à valider avant publication
Planifié Pas encore, mais auto-publication à la date fixée Article rédigé à l'avance, à publier lundi matin par exemple
Publié Oui, après le prochain build Contenu validé et prêt à être visible des visiteurs
Rappel important — même un contenu Publié n'apparaît pas sur le site public tant qu'un build n'a pas été lancé après son passage en Publié. Voir question 3.

9. Comment sauvegarder ma base ?

Le Labo du Yeti propose un export complet en un clic, qui contient toute ta base de données, tes médias, tes templates et la config de tes extensions.

  1. Va dans Réglages → Sécurité.
  2. Clique sur « Exporter la base ».
  3. Un fichier .zip est généré et téléchargé sur ton ordinateur.
  4. Range-le dans un endroit sûr (Drive, Dropbox, disque externe…).
Bonne pratique. Programme un export mensuel dans ton agenda. C'est ton parachute en cas de fausse manipulation, de cyberattaque ou de panne serveur. Un export prend 10 secondes et peut te sauver des semaines de travail.

10. Comment restaurer une sauvegarde ?

Même panneau, fonction inverse :

  1. Va dans Réglages → Sécurité.
  2. Clique sur « Restaurer un .zip ».
  3. Sélectionne le fichier .zip précédemment exporté.
  4. Confirme l'écrasement.
Filet de sécurité automatique. Avant chaque restauration, le CMS crée d'abord un export complet de l'état actuel (« safety backup »). Si la restauration tourne mal, tu peux donc revenir en arrière. Ces safety backups sont visibles dans le même panneau.

11. Quelle différence entre Pages, Blog et Cocon ?

Les trois sections produisent du contenu HTML, mais répondent à des usages distincts.

SectionType de contenuCas d'usage typique
Pages Pages manuelles fixes Accueil, À propos, Contact, Mentions légales
Blog Articles datés générés par IA Actualités, conseils, contenus SEO réguliers
Cocon SEO Pages massives basées sur des variables Plombier Paris / Plombier Lyon / Plombier Marseille… (200 pages d'un coup)

Pour aller plus loin, lis le guide Cocon SEO qui explique en détail la mécanique parent/enfant et les variables cartésiennes.

12. Pourquoi je ne vois pas certaines rubriques du menu ?

Si une rubrique attendue (Blog, Extensions, Logs, Réglages…) n'apparaît pas dans la barre latérale, deux explications sont possibles.

  1. Ton rôle ne donne pas accès à cette rubrique. Par exemple, un Client (rôle editor) ne voit ni Build, ni Layout, ni la plupart des Réglages avancés. C'est normal.
  2. Un Administrateur a désactivé la capability pour ton rôle. Chaque rubrique peut être activée ou désactivée par rôle dans Réglages → Permissions. Si un Administrateur a décoché « Blog » pour ton rôle, le menu Blog disparaît pour toi.
Que faire ? Demande à un Administrateur de vérifier la matrice des permissions dans Réglages → Permissions. Si l'accès est légitime, il peut cocher la case correspondante à ton rôle. Le menu se met à jour automatiquement à ta prochaine reconnexion.

Aller plus loin

Si ta question n'est pas listée ici, plusieurs ressources peuvent t'aider :

  • Le guide Bonnes pratiques — comment éviter les pièges courants.
  • Le guide Premiers pas — la mise en route complète.
  • La documentation technique — pour les développeurs et intégrateurs.
  • Ton agence ou partenaire — pour tout ce qui touche au serveur, à l'hébergement ou à la configuration avancée.