Développeurs

Dépannage

Les problèmes les plus courants et leur solution.

L’installation ou la mise à jour échoue (HTTP 403, plugin introuvable)

• Invalid credentials (HTTP 403) : le fichier auth.json manque sur le serveur, ou la licence du projet n’est plus active. Vérifiez le projet dans votre compte octobercms.com, puis reliez à nouveau le site avec php artisan project:set <clé de licence>.
• PageTree n’est pas installé par project:sync : il n’est pas dans le projet relié au site. Vérifiez que l’achat a été fait sur ce projet, ou reliez le site au bon projet.

Une page renvoie une erreur 404

Vérifiez, dans l’ordre :

1. la page est Actif (en-tête de la page) ;
2. elle est Publié (fenêtre Planification) ;
3. sa Date de Publication est vide ou passée ;
4. l’adresse demandée correspond exactement à l’URL de la page (avec RainLab.Translate, à l’URL de la langue affichée).

Voir la règle de visibilité.

Les CSS ou JS d’un composant manquent

Le layout de la page doit contenir {% styles %} et {% scripts %}. Voir Intégration au thème.

L’aperçu est vide

1. Vérifiez que le layout sélectionné s’affiche correctement seul, sur une page CMS classique.
2. Consultez le journal : Réglages → Journal des évènements dans le back-office, ou le fichier storage/logs/system.log.

La fenêtre d’aperçu ne s’ouvre pas

Le navigateur a bloqué la fenêtre pop-up. Autorisez les fenêtres pop-up pour le site du back-office, puis cliquez à nouveau sur Ouvrir l’aperçu dans une fenêtre.

L’enregistrement d’une grande page échoue (erreur 413)

La requête dépasse la taille acceptée par le serveur web. Augmentez client_max_body_size dans la configuration de Nginx, par exemple dans le bloc server de votre site :

client_max_body_size 150M;

Vérifiez la configuration avec sudo nginx -t, puis rechargez Nginx. Le fichier NGINX_413_SOLUTION.md du plugin détaille aussi les réglages PHP associés.

Le collage de blocs ne fonctionne pas

Le copier-coller passe par le presse-papiers du navigateur. Si le message « Impossible de lire le presse-papiers » apparaît, autorisez l’accès au presse-papiers pour le site du back-office.

Un bloc personnalisé n’apparaît pas dans la bibliothèque

• Vérifiez qu’il est Actif (onglet Réglages du bloc).
• Fermez et rouvrez les onglets de pages déjà ouverts : la liste des blocs est chargée à l’ouverture de l’onglet.

Un bloc personnalisé n’affiche rien

Le template a probablement une erreur à l’exécution. Un court message apparaît dans l’aperçu et l’erreur est consignée dans le journal système avec le code du bloc. Une source de données illisible donne, elle, une liste vide et une ligne dans le journal.