Introduction

Le plugin est intégré complètement à SPIP. Si vous avez opté pour laisser le choix aux auteurs (c’est l’option par défaut). Il suffit de cliquer sur le lien adapté pour passer de l’éditeur spip à CKeditor.

Description

Il permet une configuration plus fine :

• choix du mode d’édition par défaut (éventuellement exclusif),
• taille de l’éditeur,
• démarrage de la correction orthographique dans une langue particulière,
• configuration assez poussée des barres d’outils.

Mais aussi :

• quelles balises SPIP on souhaite autoriser,
• forcer la langue de CKeditor (pour éviter les problèmes d’autodétection)
• autoriser ou non l’insertion d’image provenant de tous les articles

L’insertion d’une image se passe normalement :

• on télécharge l’image avec SPIP,
• on clique sur insérer une image, puis « explorer le serveur » qui nous propose les images de l’article ou toutes celles du site

On peut aussi insérer un lien vers un article/une rubrique/une brêve du site SPIP.

Installation

Dans tous les cas, il faut qu’un répertoire lib existe à la racine de votre installation Spip pour que Spip puisse y copier la librairie CKeditor. Et il faut que Spip puisse écrire dans ce répertoire : c’est un pré-requis obligatoire.

Ensuite, vous pouvez installer le plugin de deux manières différentes :

Par FTP

Téléchargez le plugin :

Plugin CKeditor

Vous pouvez préférez la version de développement qui se trouve là

Décompresser l’archive où vous voulez, copier le répertoire entier dans le sous répertoire plugins de votre installation spip.

En mode auto

Créez un répertoire auto dans le sous répertoire plugins de votre installation spip. Taper/Copier l’url du plugins Validez. Spip télécharge l’archive et vous montre ce qu’il y a dedans. Validez.

Activation du plugin

Utilissez le gestionnaire de plugins Spip pour activer le plugin.

Ouvrez le répertoire plugins/auto et activez CKeditor pour Spip Validez. Spip n’est pas content : Normal, il faut encore télécharger CKeditor lui-même. Cliquer sur le bouton Télécharger. Après le téléchargement qui prend un certain temps (près de 5Mo ...), Spip vous montre le contenu de l’archive qu’il vient de télécharger : Procéder à l’installation : Normalement à ce stade, le plugin est installé. Il arrive, je ne sais pas pourquoi que spip ne copie pas le contenu de CKeditor au bon endroit, dans lib/ckeditor. Chez moi, il laisse l’archive décompressée dans tmp/cache/chargeur/ckeditor. En l’effaçant complètement et en recommençant, ça a marché. Je pense que le bug vient de spip. Mais je n’en suis pas sûr.

Configuration

Puis on utilise l’interface CFG pour configurer le plugin. Ce n’est pas obligatoire mais les choix par défaut risquent de ne pas vous plaire. En particulier, si vous ne faites rien, vous aurez l’éditeur CKeditor avec un seul bouton : A propos. Pensez à activez les boutons que vous voulez voir apparaître dans les barres d’outils.

Voilà, ce devrait être tout.

ChangeLog

• version 0.2
  • utilisation de jQuery à la place d’une regex pour remplacer l’editeur spip
  • utilisation de jQuery pour insérer le choix d’éditeur
  • mécanisme permettant de copier lorsque c’est nécessaire le plugin pour l’éditeur CKeditor
  • image réduite effectivement (utilisation de image_reduire) dans le dialogue de sélection d’image
  • (j’espère) suppression d’un avertissement lié à l’absence de tidy
  • le combo ’’styles’’ propose maintenant les styles spip et les couleurs html (pas hardcodées avec rgb(rr, gg, bb) )
  • nettoyage divers
• version 0.7 (disponible sur le svn uniquement)
  • traduction anglaise et arabe
  • insertion de document spip (les reférences sont stockées dans la db spip comme <imgXX|center>, ou <docXX|player|center> par exemple
  • les liens sont sauvegardé au format spip [text->lien] (enfin souvent, la reconnaissance présente encore quelques bugs)
  • le changement de mode d’édition se fait maintenant à la volé (merci ajax) et sans nécessité de sauvegarder le document avant le changement de mode
  • configuration sur trois onglets
  • utilisation de ckeditor 3.0.1 (si vous avez déjà installé le plugin, veillez à effacer lib/ckeditor, pour que le plugin procède à la mise à jour de ckeditor
  • divers fix et amélioration

SVN

N’hésitez pas pas à essayer la dernière version disponible sur le SVN du projet :

• version packagée
• pour la dernière version utiliser svn : svn checkout http://ckeditor-spip-plugin.googlecode.com/svn/trunk/ ckeditor