cibloc : mettre en forme le texte d’articles avec des blocs

La VERSION 2 du plugin CIBLOC est configurable depuis l’espace privé de SPIP. Le plugin CIBLOC permet de mettre en forme le texte d’articles avec des blocs, des colonnes, des icônes et des boutons.

IMPORTANT

Si la version 1 de CIBLOC est déjà installée, il est indispensable de lire le paragraphe ‘Migration de la version 1 à la version 2’.
Si le site est sous SPIP 3.0 ou SPIP 3.1, il convient de lire le paragraphe ‘Utilisation sous SPIP 3.0 ou SPIP 3.1’

Les objectifs de ce plugin

Le plugin CIBLOC offre des blocs, des colonnes, des icônes et des boutons :

  • 17 blocs
  • 8 multi colonnes
  • 12 ensembles de blocs et/ou colonnes prêts à l’emploi
  • 186 icônes
  • 14 boutons

Les listes des blocs, colonnes, ensembles, icônes et boutons sont configurables depuis l’espace privé de SPIP.

Les blocs et les colonnes sont "responsives".

Les fonctionnalités sont détaillées dans le document de description du plugin CIBLOC ci-joint au format PDF.

Exemples de blocs et/colonnes proposés par le plugin CIBLOC

Vidéo de démonstration

Cliquer sur le logo ci-dessous pour afficher cette vidéo :

Vidéo de démonstration du plugin CIBLOC version 2

Installation

Il nécessite d’installer le plugin CISTYLE, qui est livré avec le plugin CIBLOC version 2.

Remarque : Si le site utilise le plugin CISF, il est nécessaire d’utiliser au moins la version 4 de CISF.

Migration de la version 1 à la version 2

La version 1 de CIBLOC utilisait des fichiers XML de configuration. La version 2 du plugin CIBLOC ne les utilise pas. En effet, la version 2 est configurable depuis l’espace privé de SPIP.
Par ailleurs la version 2 de CIBLOC nécessite d’installer immédiatement le plugin CISTYLE, qui est livré avec.
Remarques :

  • Dans le cas où le site utilise déjà CIBLOC version 1 dans le dossier /plugins/ , après avoir copié CIBLOC version 2 et CISTYLE dans le dossier /plugins/, il est nécessaire d’activer immédiatement le plugin CISTYLE.
    A noter que la page [Configuration] / [Gestion des plugins] affichera le message suivant : "Impossible d’activer le plugin ../plugins/cibloc Nécessite le plugin CISTYLE en version ≥ 1.0.0.". Il suffit d’activer CISTYLE et SPIP activera alors CIBLOC version 2.
  • Dans le cas où le site utilise déjà CIBLOC version 1 dans le dossier /plugins-dist/ , après avoir copié CIBLOC version 2 et CISTYLE dans le dossier /plugins-dist/, il est nécessaire de déclencher l’activation de ces plugins, par exemple en affichant la page [Configuration] / [Gestion des plugins].

Utilisation sous SPIP 3.0 ou SPIP 3.1

L’utilisation de CIBLOC sous SPIP 3.0 et sous SPIP 3.1 présente plusieurs problèmes qui sont détaillés en annexe de la documentation. Ces problèmes ne se produisent pas sous SPIP 3.2.

Comment insérer un bloc et/ou des colonnes ?

a) Aller dans la page qui permet de modifier le texte de l’article.
b) Cliquer à l’endroit du texte où l’on veut insérer le bloc.
c) Cliquer sur le nouveau bouton « Choisir un bloc ».

d) Une liste s’affiche. Faire défiler verticalement la liste pour voir les blocs proposés.
e) Cliquer sur le bloc souhaité.

f) Afficher l’article sur le site public (en prévisualisation s’il n’est pas publié).

g) Modifier le texte de l’article afin de remplacer le texte fictif du bloc par votre texte.

Liste des blocs





Liste des multi colonnes


Liste des ensembles de blocs et/ou multi colonnes

Ces ensembles de blocs sont des combinaisons prêtes à l’emploi de blocs et/ou de colonnes. Il suffit de cliquer sur l’un des ensembles pour l’insérer dans le texte de l’article.




Liste des ensembles qui sont presque des pages

Les ensembles suivants constituent presque des pages prêtes à l’emploi.Il suffit de cliquer sur l’une des combinaisons pour l’insérer dans le texte de l’article.Une fois insérée, il est bien sûr possible de supprimer une partie de la combinaison, d’ajouter d’autres blocs, etc.

Comment insérer une icône ?

a) Aller dans la page qui permet de modifier le texte de l’article.
b) Cliquer à l’endroit du texte où l’on veut insérer l’icône.
c) Cliquer sur le nouveau bouton « Choisir une icône ».

d) Dans la liste qui s’affiche, cliquer sur une icône pour l’insérer dans le texte
Cette liste comprend une sélection de 186 icônes (FontAwesome) triées par signification ou forme.

Il est possible de choisir l’échelle de l’icône, son alignement et sa couleur.
Exemple d’icône ainsi générée :
<icone|nom=exclamation-triangle|echelle=5|couleur=couleur3|center>

Comment insérer un bouton ?

a) Aller dans la page qui permet de modifier le texte de l’article.
b) Cliquer à l’endroit du texte où l’on veut insérer le bouton.
c) Cliquer sur le nouveau bouton « Insérer un bouton ».

d) Renseigner le titre et l’adresse du lien puis sélectionner l’alignement et la couleur.

Un plugin configurable

La version 2 du plugin est configurable depuis l’espace privé de SPIP.

Depuis l’espace privé de SPIP, on peut :

  • Configurer les blocs, les multi colonnes, les ensembles de blocs
  • Configurer les boutons, les couleurs des icônes, la liste des icônes, les points divers
  • Créer un nouveau bloc
  • Créer un nouvel ensemble de blocs
  • Choisir une palette de couleurs
  • Configurer le style d’affichage de la liste des blocs
  • Exporter ou importer la configuration

La configuration est facultative. En effet, les blocs disposent d’une configuration par défaut, etc.
Seul un administrateur du site peut configurer le plugin.
Pour le configurer, il convient de se placer dans l’espace privé de SPIP et de cliquer sur le menu [Configuration] / [Configurer les blocs, etc.]

La page ci-dessous s’affiche :

Exemple de choix d’une palette de couleurs :

Exemple de configuration d’une palette personnalisée :

Exemple de configuration d’un bloc :

Pour en savoir plus, consulter le document de description du plugin CIBLOC ci-joint au format PDF.

Versions successives du plugin CIBLOC

  • Version 1.* : Version initiale.
  • Version 2 :
    -  Est nettement plus facile à configurer. En effet, elle est configurable depuis l’espace privé de SPIP et elle permet d’exporter, d’importer ou d’imposer une configuration.
    -  Facilite l’ajout d’un bouton.
    -  Ajoute des blocs en couleurs.
    -  Offre au rédacteur le choix entre plusieurs couleurs pour les icônes.
    -  Permet à l’administrateur du site de créer des ensembles de blocs (même si la configuration est imposée), ce qui peut également être utilisé pour des textes types d’article.
    -  Permet d’aligner le texte à gauche, au centre, à droite.
    -  Prend en compte le cas où la variable de SPIP ‘debut_intertitre’ a été personnalisée.
    -  Apporte la compatibilité avec le plugin "Crayons" (sous SPIP 3.1 et SPIP 3.2).

Dernière modification de cette page le 14 juillet 2019

Discussion

31 discussions

  • 1

    Personnalisation/ajout de classe
    Bonjour, la version 2 apporte la possibilité de personnaliser (configurer) les éléments. C’est super.
    Est-ce qu’il pourrait y avoir également la possibilité d’attribuer une « classe » ? Soit via l’écran de configuration, soit via les balises permettant l’insertion des blocs, avec qqchose comme [multi_colonnes|ma_classe] ?
    Tout en restant facultatif (comme les modèles de SPIP), cela ouvrirait une possibilité de personnalisation générique complémentaire. Ce n’est qu’une suggestion. Pensez-vous qu’elle présenterait de l’intérêt ?
    Encore 1000 mercis pour ce merveilleux outil.

    • Il est possible d’insérer un bloc dans une colonne. Ceci permet des possibilités de personnalisation dans un multi colonne, vu que l’on peut configurer les blocs et même en créer.

      Par ailleurs, chaque bloc [bloc_...][/bloc_...] dispose automatiquement d’une classe cibloc_... (les points de suspension étant l’identifiant du bloc).

    Répondre à ce message

  • 1

    Bonjour,

    Depuis le passage de PHP 7.1 à 7.2, j’ai une tonne d’avertissements identiques :
    « PHP Warning : Use of undefined constant cibloc_verifier_install - assumed ’cibloc_verifier_install’ (this will throw an Error in a future version of PHP) in /home/clients/XXX/web/spip/plugins/auto/cibloc/cibloc_pipelines.php on line 64 »

    J’ai donc tenté de remplacer :

    if (cibloc_verifier_install)

    par

    if (cibloc_verifier_install())

    et a priori je n’ai plus d’avertissement.

    Pour info (ou correction),

    Merci !

    Christophe

    • J’ai élaboré une solution, pour que la version 2 du plugin CIBLOC prenne en compte le cas particulier des sites qui utilisent sjcycle ou Bootstrap ou FontAwesome ET évite un warning PHP.
      ATTENTION : cette solution s’applique uniquement à la version 2 de CIBLOC (et pas aux versions 1.*).
      Les fichiers modifiés sont téléchargeables :

    Répondre à ce message

  • 3

    Imbrication de blocs
    La doc précise qu’on ne peut pas insérer de colonnes dans une colonne et on a un message d’erreur si on s’y essaye. C’est déjà formidable comme cela mais, comme toujours, à utiliser un outil, on devient toujours plus gourmand !
    Est-ce qu’il y aurait un moyen d’arriver à intégrer des colonnes dans une colonne, genre

    [multicolonne]
    [colonne_50]
        [sub_multicolonne]
        [colonne_50] (....) [/colonne_50]
        [colonne_50] (....) [/colonne_50]
        [/sub_multicolonne]
    [/colonne_50]
    [colonne_50]
        [sub_multicolonne]
        [colonne_50] (....) [/colonne_50]
        [colonne_50] (....) [/colonne_50]
        [/sub_multicolonne]
    [/colonne_50]
    [/multicolonne]

    Ce serait vraiment chouette et ouvrirait de belles perspectives...
    Possible ? Pas possible ?

    Quoi qu’il en soit, encore 1000 mercis pour ce superbe outil

    • Le fait, qu’une colonne ne puisse pas être contenue dans une autre colonne, est un choix de conception.

    • Oui, j’imagine bien qu’il en est ainsi. Cela dit, ma question était de savoir si c’était envisageable ( ie : possible) d’avoir la possibilité d’intégrer une colonne dans une autre colonne.
      Comment faut-il comprendre la réponse : ce serait faisable mais trop compliqué parce que ça obligerait à tout reprendre ?

    • Mon rôle n’est pas d’offrir une assistance à la réalisation d’une fonctionnalité sur mesure pour un site particulier.

    Répondre à ce message

  • 4

    Bonjour,
    j’ai trouvé un conflit de css entre cibloc 1.1.0 et sjcycle 3.4.20
    dans le fichier de configuration « ../_config_cibloc/_css/cibloc.css »
    dans la toute dernière section, cette règle qui ne cible pas vraiment le container de cibloc

    /*==========  pour le test de cibloc ==============*/
    img {
       max-width: 100% !important;
       height: auto;
     }

    Le « !important » de la règle

    1. max-width: 100% !important;

    met le bazar en faisant partir en vrille ou annule certains effets de sjcycle.
    Si des fois l’auteur veut bien corriger.
    Merci d’avance
    cordialement
    PS Le « !important »t est massivement employé, dans mon cas, 57 fois dans le fichier de configuration pour 2 lignes de 3 colonnes, c’est pas un peu trop et vraiment nécessaire quand les règles ciblent aussi précisément le html ?

    • Bonjour,

      Même souci si on utilise Bootstrap ou FontAwesome par ailleurs.
      Il faut préfixer toutes les classes .col-sm-* par .cimulti_colonnes et le i.fa par .cibloc sinon les règles s’appliquent à des éléments qui ne sont pas concernés par ces définitions.

    • La prochaine version du plugin CIBLOC prendra en compte le cas particulier des sites qui utilisent sjcycle ou Bootstrap ou FontAwesome.

    • J’ai élaboré une solution, pour que la version 2 du plugin CIBLOC prenne en compte le cas particulier des sites qui utilisent sjcycle ou Bootstrap ou FontAwesome.
      ATTENTION : cette solution s’applique uniquement à la version 2 de CIBLOC (et pas aux versions 1.*).
      Le deux fichiers modifiés sont téléchargeables :

      Merci de m’indiquer si cela règle les incompatibilités en question.

    • Remarque : Avec les deux fichiers précités, si on ajoute la ligne suivante dans le fichier mes_options.php puis que l’on vide le cache (1), alors la feuille de style de CIBLOC ne contiendra plus l’attribut «  !important » :

      define('_CIBLOC_CSS_SANS_ATTRIBUT_IMPORTANT','oui');

      (1) En cliquant, dans l’espace privé, sur le menu Configuration / Configurer les blocs, etc., puis en cliquant sur le lien « Recalculer le cache des blocs ».

    Répondre à ce message

  • 1
    spipfactory

    Bonjour & Merci

    Aprés citrace, voilà que l’on intégre cibloc avec le squelette escal sur la plateforme.

    A ce jour que des retours positifs sur le duo escal-cibloc

    Répondre à ce message

  • 1

    Ajout bloc 20%
    Bonjour, à la fois pour un besoin précis et pour me familiariser à la personnalisation de ce merveilleux plugin, je cherche à ajouter un bloc 20|20|20|20|20 (5 colonnes 20%).
    Je pensais m’en sortir en rajoutant un type intrene dans cibloc_cache.php

    array(
                    'id' => '20',
                    'type' => 'colonne', 
                    'nom' => 'Colonne 20%',
                    'barre_outil' => 'non',
                    'code_html_ouvrant' => '<div class="col-sm-20">', 
                    'code_html_fermant' => '</div>',
                    ),

    mais visiblement, ce n’est pas suffisant (ou ce n’est pas la bonne approche).
    Pourriez-vous m’aiguiller et m’indiquer schématiquement comment procéder / quelles modifications apporter ?
    Merci infiniment d’avance

    • Résolu
      Problème de cache mal vidé... C’est OK et les blocs 5 colonnes fonctionnent très bien ;-))

    Répondre à ce message

  • La version 2 du plugin CIBLOC :
    -  Est nettement plus facile à configurer. En effet, elle est configurable depuis l’espace privé de SPIP et elle permet d’exporter, d’importer ou d’imposer une configuration.
    -  Facilite l’ajout d’un bouton.
    -  Ajoute des blocs en couleurs.
    -  Offre au rédacteur le choix entre plusieurs couleurs pour les icônes.
    -  Permet à l’administrateur du site de créer des ensembles de blocs (même si la configuration est imposée), ce qui peut également être utilisé pour des textes types d’article.
    -  Permet d’aligner le texte à gauche, au centre, à droite.
    -  Prend en compte le cas où la variable de SPIP ‘debut_intertitre’ a été personnalisée.
    -  Apporte la compatibilité avec le plugin « Crayons » (sous SPIP 3.1 et SPIP 3.2).

    Répondre à ce message

  • 1

    Bonjour,
    Tout d’abord, un grand grand merci pour ce superbe plugin qui fait désormais partie de mes indispensables.
    Je rencontre toutefois un souci avec les blocs « accordéon » dans les sites pour lesquels, dans un souci d’accessibilité, la variable de personnalisation debut_intertitre a été redéfinie de manière à ce que les intertitres deviennent des h2 au lieu des h3.

    • La prochaine version du plugin CIBLOC prendra en compte le cas où la variable de SPIP « debut_intertitre » a été personnalisée.

    Répondre à ce message

  • 2
    Jaseur Boréal

    Bonjour,
    un message d’erreur apparaît, alors qu’il n’y a aucun oubli constaté dans la page :

    Cette page contient une erreur :
    - Un multi multi_colonnes a une balise de fin [/multi_colonnes] mais il lui manque une balise de début [multi_colonnes]

    La soi-disante absence de la balise de début n’est pas : car elle est bien présente.
    Page concernée : https://www.lettonie-francija.fr/1906-film-letton-historique-gatis-smits-1705

    Quand on supprime le bloc, le message d’erreur se manifeste à propos d’autres blocs de la page ;
    Merci de toutes suggestions de solution.
    @+

    • L’article en question contient une balise de fin de script (pour twitter) sans le > de fin :

      <script async="" src="https://platform.twitter.com/widgets.js" charset="utf-8"></script</center>

      en le remplaçant par une balise correcte de fin de script, le problème ne se produit pas :

      <script async="" src="https://platform.twitter.com/widgets.js" charset="utf-8"></script></center>
    • Jaseur Boréal

      Merci pour la réponse et la performance du regard acéré !
      Bonne fin de journée

    Répondre à ce message

  • 7

    Bonjour, bien que vous indiquiez que votre plugin fonctionne avec un spip 3.0, j’ai le regret de vous informer qu’il ne fonctionne pas du tout sur un site en 3.0.17 [21515]. Je ne vois pas du tout d’icône carrée dans la barre d’outils des textes d’articles ... Dommage ! Il a l’air très bien.

    • Si l’icône n’apparaît pas dans la barre d’outils du texte de l’article, il convient de suivre la procédure suivante :

      a) S’assurer que la barre d’outil est bien celle de SPIP. En effet, le plugin CIBLOC fonctionne avec la barre d’outils de SPIP (et pas avec celle du plugin ckeditor par exemple).

      b) Vérifier que le plugin CIBLOC est bien activé.

      c) Vider le cache de SPIP. En effet, la barre d’outils de SPIP est mise en cache.

      d) Contourner le cache du navigateur en faisant CTRL + F5 dans la page de modification de l’article.

    • La version 1.2 du plugin CIBLOC (du 20/11/2018) évite de devoir vider le cache du site, après avoir activé le plugin, afin de voir les nouveaux boutons (ajoutés par le plugin) dans la barre d’outil du texte des articles.

    • Bonjour,

      J’ai également le problème,

      • je n’utilises pas ckeditor.
      • j’ai spip 3.0.19
      • mediabox de base en 0.8.11 default
      • cibloc 1.3.0

      Et toujours pas de boutons visible.
      Mais je n’ai pas vidé tout le cache… car ça risquerait de mettre le site un peu à plat…

      J’ai essayé d’activer/ désactiver… Je sèche un peu… je continue de voir…
      Si vous avez des idées ! merci !

    • La barre d’outils de SPIP est mise en cache. Pour éviter de vider tout le cache de SPIP, on peut supprimer manuellement le contenu du dossier /local/cache-js/

      Il convient ensuite de contourner le cache du navigateur en faisant CTRL + F5 dans la page de modification de l’article.

    • Merci pour l’info… le problème ne dois venir de là alors.

      J’ai même vidé le cache local/css… vider le cache du nav (que je n’ai jamais d’ailleurs avec un plugin pour celui-ci d’ailleurs).

      Toujours pas d’icône malheureusement.

    • OK, c’était une incompatibilité porte plume partout en 1.0.6…

      J’essaie de monter la version…

    • Il s’agit du dossier /local/cache-js/ c’est-à-dire celui qui contient des fichiers javascript (*.js).

    Répondre à ce message

Ajouter un commentaire

modération a priori

Attention, votre message n’apparaîtra qu’après avoir été relu et approuvé.

Qui êtes-vous ?

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