techniques de dépannage ckeditor (ou autre module récalcitrant)

En résumé, techniques de dépannage d'un module récalcitrant...

  1. après update.php, vider le cache drupal
  2. vider les caches du navigateur : CTRL F5 est insuffisant. Tester (firefox) CTRL+MAJ+SUPP. Et/ou tester avec un autre navigateur (IE, opéra...)
  3. désactiver les caches de drupal, désactiver la compression des .JS (voir des .css) ; tester, retourner au point 1
  4. documenter: consulter le README.TXT et site web du/des modules impliqués, vérifier l'installation des modules (versions, prérequis, notes des dev, droits des fichiers et dossiers chez l'hébergeur...) car c'est toujours utile smiley
  5. si toujours ko, pas d'erreurs dans les logs ni aucune piste:
    Tenter une modif mineure, sauver le user (ou la conf du module) et retester ; retourner au point 1.
  6. Utiliser Firebug: vérifier les droits des users (tester avec un nouvel user créé),
    ainsi que la conf (via URL admin de drupal) des modules suspectés (que l'on vient de modifier ou de mettre à jour).
  7. Penser à relancer son instance la nuit, regarder les incidents chez l'hébergeur, et retourner au point 1 (faire un backup bien sur)
  8. revenir à un thème de base, désactiver d'autres modules... c'est à dire sur une machine de dev si le dit bug touche la prod :)

J'ai eu divers bugs liés à ckeditor (depuis un an, sur ce site dont je paie l'hébergement), Views, sans parler des diverses versions de omega...
Pour info, les "mise à jour des modules", je les ai fait en général VIA l'interface admin de drupal (pas par FTP) ; il est rare que mes sites ne soient pas à jour (un cron hebdomadaire m'envoyant un email) - ils ne contiennent pas d'informations sensibles (qui serait interressé par les notes de notre petit conseil syndical ? laugh), je n'y fait donc pas de recette, suite aux (nombreuses) mises à jour, mais de simples backups.
Tout admin de drupal, Joomla ou toute autre application informatique (système, tableur...), connait le phénomène des "bugs qui se déplacent"... J'écris cela en réalisant que c'est vrai pour tout utilisateur d'un outil informatique smiley Bref... en cas d'erreur, on regarde les logs - et quand on n'y trouve RIEN d'inhabituel, on vit avec si c'est mineur - car l'on sait que cela peut "retomber en marche".
Là, en recherchant comment résoudre un bug mineur (pourquoi en mode édition je ne vois pas le contenu des seules balises code, alors qu'après avoir cliqué sur "Sauver", tout apparait correctement, et qu'en mode édition, via le bouton "source" tout est bon aussi !), je tombe par hasard sur la cause qu'un bug majeur, que j'avais eu précédemment smiley.

Un bug majeur: le module "qui disparait" ?!?

L'an dernier, (en fait, suite à une mise à jour de ckeditor), il a totalement disparu lors de la création des pages (autant dire que son utilité a été réduite à 0), et c'est "retombé en marche", suite à diverses manip' de ma part: vider les caches de drupal (la base!), vérification de la configuration des modules, des droits des users... recherche sur le web...
Je n'avais jamais compris laquelle de mes manips (de simples vérifications, sans réelle modification de paramètre) avait pu débloquer la situation.

En lisant cette page (en anglais) je découvre, amusée, les diverses manip' que d'autres ont tentés (comme moi l'an dernier)...

  • Au post 8 (3 dec 2012), cmhoward dit qu'il a le bug que pour les users existants, que s'il crée un user, ce user peut utiliser ckeditor, alors qu'un user existant (avec les meme droits) ne voit "que du vide"!
  • Puis aiquandol trouve que le bug est lié aux paramètres de la skin de ckeditor, données qui sont enregistrées dans l'objet user: pour mettre à jour ces informations, il faut re-sauver les comptes users (via l'interface de drupal, super pour un gros site comme France Television ou Rue89!).
  • Un autre indique que cela n'est pas vrai pour lui, par contre, il a résolu son bug en re-sélectionnant la skin (il s'agit d'une liste déroulante dans la page d'admin de ckeditor).
  • Post 16, "modifier la skin ou changer les couleurs" a résolu son bug.
  • Post 17: re-sauver (sans modif) les profils de ckeditor (avec version dev dans son cas).
  • Post 19: un dev, manifestement, demande s'ils utilisent Firebug (c'est un module de Firefox) et s'ils y voient des erreurs au chargement des pages de configuration des profils cool car il n'arrive pas à avoir l'erreur sur mon serveur de dev.
  • Au post 25 (17 dec 2012): dans la version DEV, si ckeditor ne trouve pas la skin choisie, alors il charge la skin par défaut ou la première trouvée. Ceci a été corrigé et sera plublié dans la prochaine release de la version DEV du module. cool Qui de la version prod? (ou des bugs qu'on aurait avec la dernière version de dev) broken heart
  • Post 26: on nous rappelle qu'il faut aussi complètement vider le cache du navigateur, et non par CTRL+F5 (mais comment alors?). Et que nulle part dans leur doc il n'est dit qu'il faut prendre maintenant le "full package" et non seulement le basic.
  • Post 30 (en réponse à un autre utilisateur): "probablement un soucis drupal ou avec votre thème... Avez-vous:
    1. désactivé les caches de drupal (nottons que cela est différent de "vider les caches" - et là on n'a toujours pas parlé de plateforme de test/prod ou conf Varnish par ex...)
    2. ainsi que désactivé l'agregation des fichiers JS?
    3. sinon, avez-vous "<?php print $scripts; ?>code in your head section of your theme?"?", on lit la réponse suivante devil
    • lorsque j'ai activé "agrégation des fichiers js", hop... l'éditeur est revenu.
      Résolution: vider cache du navigateur puis celui de drupal, et enfin, activer l'agregation JS
    • Post 35, on note que cet utilisateur-là avait oublié de lancer le update.php (surprise b.aba de drupal pourtant !)
  • Post 36 (7 janv 2013): dans la dernière version publiée de ckeditor, une option désactive l'agrégation du fichier ckeditor.js par défaut.
  • Long post 46 d'un gars très embetté... on est le 17 janvier 2013. Ce qu'il raconte ressemble assez à ce que j'ai vécu alors wink (mais j'évite HTML purifier)
  • Post 61: les versions 4.1 & 4.0.3 n'ont pas le fichier de thème. La version 3.6.6.1 a ce fichier.
  • Post 64, ressemble au 61: avec Chrome, il a vu que le dossier kama manquait, pas le moono

J'ai du resauver les profils, je pense...
 

 

les caches des browsers (firefox, IE, opera, safari...)

Pour Mozilla, la combinaison de touches Ctrl + Maj + Suppr ouvre une boite de dialogue qui offre différentes options de purge, dont celle du cache le cache. Je teste, et ca marche!

Je découvre cette merveilleuse page wikipédia: http://fr.wikipedia.org/wiki/Aide:Purge_du_cache_du_navigateur