CKeditor 3.x et 4.x

CKeditor est l’évolution de l’éditeur WYSIWYG : FCKeditor, avec ce plugin vous pourrez utiliser cet éditeur à la place de l’éditeur de spip tout en laissant le choix à vos auteurs de l’éditeur qu’ils préfèrent utiliser.

Attention : cet éditeur WYSIWYG risque de détruire la belle charte graphique de votre site, ainsi qu’empêcher la mise à jour simplifiée de celle-ci. Avec ce plugin, le déplacement de votre site nécessitera l’édition manuelle de chaque article contenant des liens internes si vous déplacez votre site dans un autre répertoire.

Ceci devient totalement faux si vous préservez la typographie spip

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

Que fait le plugin ?

Ce plugin remplace l’éditeur par défaut de spip (en particulier le porte-plume disparaît) dans les articles, les brêves et les rubriques par CKEditor un éditeur WYSIWYG.

Avec cet éditeur, vous pouvez :

  • continuer d’utiliser le mécanisme de spip pour insérer des images, des documents à/dans un article, une rubrique ...
  • insérer simplement des liens vers les objets standards de spip (mais aussi ceux non encore prévu en modifiant assez simplement le code du plugin : ajout d’un fichier, ajout d’un lien dans un autre) via un dialogue de CKEditor.
  • utiliser les balises spip non gérée par CKEditor comme vous le feriez depuis l’éditeur de spip.
  • utiliser des polices en utilisant le mécanisme CSS3 (@font-face), soit en utilisant le webfonts directory de google, ou en téléchargeant la police ainsi que la feuille de style CSS3 tel que générée par Font Squirrel par exemple dans le répertoire : IMG/FontKits/<répertoire de la police>/.
  • le plugin essaie, dans la mesure du possible de sauvegarder vos mises en page en utilisant les raccourcis typographiques de spip (le gras, l’italique, les liens, les ancres, les insertion d’images, de documents, les listes, ... ) mais beaucoup de choses sont sauvegardées au format html (les tableaux, les enrichissement sophistiqué : couleurs, polices etc ...).
  • (nouveau) utilisez CKEditor avec n’importe quel champ (pour peu que vous connaissiez un sélecteur jQuery permettant d’y accéder)
  • (nouveau) utiliser CKEditor aussi bien en partie privée que publique
  • (nouveau) utilisez les modèles SPIP de manière ’visuelle’
  • (nouveau) utilisez des modèles d’articles que vous définirez
  • (nouveau) préservez la typographie spip
  • plein d’autres choses ...

La dernière version est :

  • sur la zone !
  • compatible spip 3.0 (expérimental)

Mise à jour de la lib

Le plugin Ckeditor utilise le dossier lib/ de SPIP.

Mais rien dans SPIP ne gère la mise à jour des lib :(

En conséquence, pour mettre à jour la lib :

Remarque, vous pouvez personnaliser les greffons de CKEditor.

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 :

ckeditor-spip3-plugin
(0.17.1)

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

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.

Via SVP

Vu que le plugin est maintenant sur la zone : il peut être installé via SVP (à vérifier)

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.

Modules complémentaires

Pour profiter pleinement de toutes les fonctionnalités du plugin, il faut installer aussi :

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.

Les documentations suivantes sont, sur certains points obsolètes

Vous pouvez consulter les articles :

Incompatibilités

Ce plugin est incompatible avec le plugin Multilang.

Contribution avec Git

ckeditor-spip-plugin est sur le Git de SPIP !

Avertissement !

L’utilisation de ce type d’éditeur WYSIWYG permet difficilement de maintenir une charte graphique cohérente. Prévenez vos rédacteurs de limiter le recours aux enrichissements trop exotiques, ou mieux : limitez l’utilisation dans ce plugin l’accès aux seules fonctions de l’éditeur que vous souhaitez leur offrir.

Discussion

369 discussions

  • 1

    J’ai le plugin en version 0.16.15 avec un spip 3.0.14 et il m’est impossible de configurer la taille maximale d’affichage d’une image.

    Lorsque je modifie le paramètre dans Options pour les vignettes, celui ci est constamment réinitialisé à 200 et toutes valeurs données à l’image directement n’est pas prise en compte en visualisation, même si dans l’éditeur elle apparait normalement.

    Des idées ? C’est un soucis connu ?

    • j’ai le même problème et c’est pénible de pas trouver un truc simple pourtant et élémentaire

    Répondre à ce message

  • Monsieur Pixel

    Bonjour,
    est il prévu de rendre ckeditor compatible avec android (çà ne fonctionne pas, la barre d’outil ne se charge pas sous android) ? Peut-on aussi utiliser ckfinder ?
    merci pour ce plugin, en tout cas
    William

    Répondre à ce message

  • 1

    spip3.0.22
    ckeditor 0.13.23
    à l’activation du plugin message d’erreur :
    Le plugin ckeditor-spip3-plugin dépend de SAISIES [1.27. ;]
    de plus,
    le plugin kcfinder 3.12 n’apparaît pas dans la liste des plugins (tous), pourtant il est bien dans le rep plugins comme les autres

    Merci de votre aide

    • Je me réponds à moi-même
      il faut d’abord installer les plugins saisie et yaml
      c’est pas écrit dans la doc ?!
      je l’ai vu en dépliant dans la liste des plugins le lien sur ckeditor
      Revoir la doc et préciser ; merci

    Répondre à ce message

  • 5

    Bonjour

    J’utilise depuis plusieurs années des plugins pour ck que je range dans /squelettes/ckeditor/*

    Je viens de passer en Spip 3 et les icônes de ces plugins n’apparaissent plus dans les barres d’outils de CKéditor, même après déclaration dans l’onglet « Plugin » de la configuration.

    Quelqu’un aurait-il rencontré le même problème ?

    Auriez-vous une piste ou une solution ?

    Bonne soirée

    Cordialement

    Jean-Michel

    • Bonjour

      Résolu par

      • suppression du plugin ckéditor pour spip
      • effacement de l’entrée concernant la configuration de CK dans la table spip_meta
      • réinstallation du plugin

      merci pour ce super plugin !

    • Nouvelle curiosité :

      • Les boutons des plugins ne sont pas vu depuis l’interface publique (crayons)
      • Les boutons des plugins sont correctement vus et fonctionnels depuis l’interface privée

      Si quelqu’un à une idée...

    • Bonjour,
      J’ai rangé plusieurs plugins de CKEDITOR dans /squelettes/plugins/ckeditor. Ils apparaissent bien dans le menu de conf de ckeditor de la partie privée. J’ai beau les activer (plugin et bouton) je ne les voie pas dans la barre d’outils de ck quand j’édite un article. En revanche, les outils d’origine sont bien toujours présents. Faut-il activer une barre d’outils particulière dans la partie Avancée de la conf de ck ou y a-t-il une autre manip. La ré-installation de ck expliquée par jmfre ne fonctionne pas sur mon SPIP 3.1.1 [22913]
      Merci pour votre aide.

    • Bojour,

      Faut mettre dans plugins/ et pas dans squelettes/

    • Effectivement, je suis étourdi ... merci pour votre réponse.

    Répondre à ce message

  • KCFinder & CKeditor

    Bonjour,
    Comment activer CKFinder avec CKeditor sous le SPIP 3.1 ?
    Je mets les fichiers CKFinder à lib / dossier, mais il les mêmes fenêtres par défaut lorsque je tente de télécharger ou ajouter une photo dans l’article.


    How to activate KCfinder with CKeditor under the SPIP 3.1 ?
    I put KCfinder files to lib/ folder, but there the same default windows when I try to upload or add photo in the article.


    Merci d’avance

    Répondre à ce message

  • bonjour je voudrais mettre une classe expose qui laisse apparaitre le titre de l’image et le #DESCRIPTIF_SITE_SPIP mais je ne trouve pas où placer le code

    [ class=« (#EXPOSER) »][ title=« #TITRE - (#DESCRIPTIF_SITE_SPIP|attribut_html) »]
    j’ai tenté dans saisies/case_image.html
    mais visiblement ce n’est pas là
    SPIP 3 dernière version de CK editor

    c’est pour le site www.judoenlignes.com
    je veux insérer sur les images un copyright général qui est dans descriptif du site et qui est donc modifiable

    merci de votre aide

    Répondre à ce message

  • pour corriger un pb de dépréciation j’ai voulu mettre à jour le plugin mais j’ai le même message que mister normandie à savoir :
    CKEditor version 3.6.1 est installé, ce plugin préférerait la version 3.6.5. Veuillez d’abord désintaller la version actuelle.
    franchement je vois pas car j’ai bien pris la dernière archive, tout désinstaller et supprimer
    Une idée ?

    Répondre à ce message

  • Bonjour, je ne parvient pas activer le plugin dans la dernière version de spip (3.1.1) ni dans sa précédente (3.1.0).

    J’ai un message d’erreur provenant d’un squelette :

    Aucun squelette svp_presenter_actions n’est disponible...

    Alors que ce fichier est bien présent.

    Merci pour vos futures réponses

    Répondre à ce message

  • Le plugin est bien pris en compte sur un site en SPIP3.1,mais dans les options de conversion le message

    La librairie html2spip n’est pas installée. Vous ne pouvez bénéficier de la traduction automatique du HTML vers SPIP. Veuillez d’abord installer la librairie html2spip dans le répertoire lib/.

    Continue à s’afficher obtinément, malgré le fait de poser le repertoir de l’archive à l’endroit demandé. Incompatible spip3.1 ?

    Répondre à ce message

  • 4

    Est-ce qu’une mise à jour de ce plugin est prévue pour être compatible avec SPIP 3.1 ??

    • Jmtconseils

      Il suffit simplement de changer dans le fichier paquet.xml, la compatiblité.
      Mettre donc

      compatibilite="[3.0.2;3.1.*]"
    • OK mais cela pré-suppose donc que CKeditor est compatible avec 3.1 ... est-ce réellement le cas ?
      C’est le plugin « Lister les plugins compatibles SPIP 3.1 » qui m’indique que CKeditor n’est pas compatible.

    • Jmtconseils

      Oui ça marche exactement comme avec les versions 3.0
      Aucun souci, je suis sur un nouveau site et j’ai mis d’office mis SPIP 3.1 et Ckeditor pour tester.
      La source du texte de l’article (ou de la rubrique) est bien enregistrée telle quelle dans la BDD.

      On peut donc y aller.

    • merci à Jmtconseils pour ses tests. Je viens de modifier le plugin sur la zone http://zone.spip.org/trac/spip-zone/changeset/94752. Donc le plugin « lister les plugins compatibles » ne devrait pas tarder à dire que la nouvelle version est compatible.

    Répondre à ce message

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom