SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

286 Plugins, 197 contribs sur SPIP-Zone, 287 visiteurs en ce moment

Accueil > Rédaction > Assistants de rédaction > Plugin Encarts > Plugin Encarts

Plugin Encarts

3 février 2011 – par Cyril Marion – 30 commentaires

19 votes

Ce plugin permet d’ajouter des « encarts » [1] à vos articles SPIP. Les encarts sont de petits textes qui viennent compléter un article, et qui peuvent apparaitre, soit au cœur du texte, soit dans la marge [2].

Le plugin encarts coté rédacteur

Une fois le plugin installé, vous pouvez ajouter un ou plusieurs encarts à vos articles SPIP.

Vous disposez de 2 types d’encarts :
-  les encarts simples écrits directement à l’intérieur du texte (et qui ne pourront s’afficher qu’à l’intérieur du texte)
-  les encarts de type "objet SPIP" saisis depuis l’interface privée (qui pourront s’afficher, soit à l’intérieur du texte, soit dans la marge ou ailleurs, tel que défini par le graphiste dans le squelette)

Pour ajouter un nouvel encart simple, dans le corps du texte :
-  éditez le corps du texte de l’article
-  choisissez, au sein du texte, l’endroit où votre encart doit apparaître
-  rédigez y votre encart, puis entourez-le d’une balise <encart> et </encart>
-  ça doit donner quelque-chose semblable à ceci :


-  cliquez sur "enregistrer"
-  votre nouvel encart apparait au sein du texte de votre article !
-  vous pouvez ajouter autant d’encarts de ce type dans votre article
Attention ! cette balise <encart> sera remplacée par SPIP par une balise de type <span> afin de pouvoir être insérée dans les paragraphes de texte (balises <p>) ; ainsi, la mise en forme que vous mettrez dans ce type d’encart doit uniquement comporter des balises de type « en ligne » ; vous devez donc éviter les balises de type titres <hx>, les doubles sauts de ligne, les notes de bas de page, les éléments <docxx>, <videoxx>...
Nota 1 : cette méthode diffère très peu de celle employée par d’autres plugins ajoutant des mises en forme au sein des textes d’article.
Nota 2 : les encarts de type "simple" insérés dans votre article par cette méthode ne pourront pas apparaitre dans d’autres articles.

Pour ajouter un nouvel encart de type « objet SPIP »
Dans la partie privée de SPIP, en bas de chaque article, vous disposez d’un bouton nommé "Ajouter un encart" qui vous permet d’ajouter un nouvel encarts dans la base de donnée SPIP.

JPEG - 13.2 ko

Chaque encart porte un identifiant unique (un numéro) permettant de le manipuler comme tout objet SPIP : on peut ainsi l’afficher et le placer dans les squelettes grâce aux boucles SPIP.
Mode opératoire pour ajouter un encart en base de données :
-  se déplacer à la fin de l’article
-  cliquer sur le bouton "ajouter un encart"

JPEG - 22.7 ko


-  remplissez le titre (éventuellement) et le texte de l’encart
-  vous pouvez utiliser tous les raccourcis de SPIP pour la mise en forme du texte, y compris ajouter des liens ou des images
-  cliquez sur le bouton "enregistrer"
-  votre nouvel encart apparait au dessous de l’article, dans le bloc des encarts

JPEG - 38.5 ko


-  vous pouvez ajouter autant d’encarts de ce type à un article
Nota : l’affichage de l’encadré sur le site public se gère dans le squelette ! Si le squelette ne prévoit pas explicitement l’affichage de l’encadré, celui-ci ne s’affichera pas !

Pour faire afficher un encart de type « objet SPIP » dans le corps du texte
Il est possible de faire afficher un encart provenant de la base de données SPIP, à l’intérieur du texte d’un article, grâce au modèle <encartXXX>, XXX étant l’identifiant de l’encart ; voici la marche à suivre :
-  vous avez déjà saisi un encart, et connaissez son numéro (imaginons que vous souhaitiez placer l’encart N°159)
-  éditez le corps du texte de l’article
-  choisissez l’endroit où devra apparaître votre encart
-  insérez l’encart avec le code <encart159>

JPEG - 51.4 ko


-  cliquez sur "enregistrer"
-  SPIP va remplacer ce code par un appel à l’encart qu’il ira chercher en base de données
Nota 1 : afin d’éviter qu’un encart soit présent par inadvertance, à la fois dans le corps du texte et ailleurs dans le squelette [3] les encarts déjà présents dans le corps du texte disposent d’un statut spécial ; ce statut s’appelle "vu" et sa valeur passe à "oui" lorsque l’encart est appelé depuis le corps du texte ; ainsi dans les squelettes on pourra choisir de n’afficher dans la marge que les encarts qui ne sont pas déjà présents dans le corps du texte, et dont le statut sera "vu=non"
Nota 2  : comme chaque encadré porte un numéro unique, il peut être inséré dans le corps d’un autre article que son article parent ; l’encadré <encart63> peut ainsi être placé dans tout article du site avec ce code.

Le plugin encart coté intégrateur

Le plugin crée un nouvel objet SPIP de type encart. Cet objet est composé des champs suivants, qui pourront être récupérés dans des boucles <BOUCLE_encart(ENCARTS)> :
-  id_encart
-  date
-  titre
-  texte

Les encarts sont liés aux articles, et pour récupérer les encarts d’un article on utilise le critère {id_article} dans les boucles. Ce qui donne par exemple pour récupérer tous les encarts liés à l’article 876 : <BOUCLE_encarts(ENCARTS){id_article=876}>.

Comme on l’a vu, pour éviter d’afficher 2 fois un encart sur une page, si l’auteur a souhaité insérer son encart au sein du texte, SPIP attribue à l’encart en question le statut "vu" à "oui". Il suffit donc d’ajouter ce critère dans la boucle, ce qui donne : <BOUCLE_encarts(ENCARTS){id_article=876}{vu=non}>.

Les encarts qui sont insérés par l’auteur dans son texte, possèdent la class interne, ce qui permet de styler ces encarts différemment des encarts placés dans un autre bloc par exemple.

Installation et dépendances

Le plugin Encarts s’installe depuis l’interface privée, de la manière classique :
-  configuration > Gestion des plugins
-  bouton "Ajouter des plugins" ; vérifiez que vos listes de plugins soient bien à jour
-  descendre sur "Encarts", cliquez sur la flèche pour télécharger
-  cliquez sur "suivant" pour installer et encore sur "suivant" pour activer
-  gogogo ! Les encarts sont disponibles pour votre site !

Nota : le plugin "Encarts" nécessite 2 plugins utilitaires pour fonctionner :
-  afficher objets, optimisant l’affichage des objets SPIP dans l’interface privée
-  saisies, facilitant l’écriture des formulaires SPIP

Limites & Évolutions

Le plugin insère un <span> s’il trouve le code <encart> dans le texte ; cela évite l’ajoute de balises block dans les paragraphes SPIP du texte. A terme il faut remplacer cet inclusion de span par une inclusion de div, tout en détectant si on est pas déjà dans un paragraphe.

A terme, gérer le placement d’un encart par l’emploi éventuel de "left", "center" ou "right en paramètre de la balise : <encart159| left>.

Voir en ligne : http://plugins.spip.net/encarts

Notes

[1le terme employé dans le monde de l’édition papier serait plutôt « encadrés »

[2marge = colonne gauche ou droite ; l’encart peut apparaitre aussi au dessus, au dessous, etc. comme l’a défini le webdesigner

[3dans une colonne ou un bandeau... ou tout autre endroit de la page choisi par le webdesigner pour faire apparaitre les éléments d’une boucle encarts

Dernière modification de cette page le 17 avril 2015

Retour en haut de la page

Tout afficher

Vos commentaires

  • Le 25 octobre à 00:53, par Teddy Payet En réponse à : Plugin Encarts

    Bonjour,

    @Manu, @pw, @jpcrea :
    J’ai corrigé le plugin pour une compatibilité SPIP 3.x. Je l’ai fait selon la documentation et la lecture du code. Si vous voyez des erreurs, merci de me faire signe. Je ferai de mon mieux pour le remettre à niveau.

    En tout cas, retour de l’interprétation des <encart> et des <marge>. Association d’encarts à la méthode classique de SPIP (un peu comme les mots-clés). Je ne suis pas sûr que ce point là reprenne ce que vous attendiez. J’ai fait rentrer le plugin dans le « moule » de l’espace privé de SPIP.
    Il faut voir maintenant si cela est pertinent pour vous.

    cf. http://zone.spip.org/trac/spip-zone/changeset/100136
    http://zone.spip.org/trac/spip-zone/changeset/100137

    Répondre à ce message

  • Le 22 octobre à 15:46, par jpcrea En réponse à : Plugin Encarts

    Ne fonctionne pas avec SPIP 3.1.
    Et aucune réponse de l’auteur(depuis Octobre 2013) aux différentes demandes.
    Dommage !

    Répondre à ce message

  • Le 5 mai à 08:41, par Manu En réponse à : Plugin Encarts

    J’ai l’impression qu’il y a un souci avec la (les) dernières versions du plugin : les encarts insérés au fil du texte via les raccourcis <encart>bla bla bla </encart> ne sont pas transformés en « encart ».
    Je m’arrache les cheveux depuis des heures là-dessus, fait des svn up dans tous les sens, désactive les plugins etc... rien n’y fait
    En regardant de plus près, je remarque que

    • le fichier paquet.html ne déclare plus le pipeline post_type
    • le fichier encarts_pipeline.php ne comporte plus la fonction encarts_post_typo.

    Si je rétablis ça, ça fonctionne de nouveau...

    • Le 5 mai à 12:10, par Manu En réponse à : Plugin Encarts

      ... Alors, est-ce que le truc, c’est que j’installe tous mes plugins par svn. Pour SPIP 3.0, dans la très grande majorité des cas, c’est la version « trunk » qu’il faut installer.
      Dans le cas précis de « encarts », la « branche trunk » ayant apriori abandonné la gestion des encarts au fil du texte, il faut alors installer la branche « branches/v2.0 » dont le nom est un peu trompeur (pour faire vite, on se dit, trunk c’est pour SPIP 3, v2.0, à doit être pour SPIP 2.
      Autant pour moi, donc (et désolé du bruit)

    Répondre à ce message

  • Le 29 février à 13:14, par pw En réponse à : Plugin Encarts

    Bonjour

    je teste ce plugin sur un Spip 3.1 et il me rajoute bien un objet « encarts » dans le menu édition.

    Cependant pas de trace d’un bouton « ajouter un encart » dans l’édition des articles, ni de modèle pour les afficher (d’ailleurs pas de répertoire modèles dans le plugin).

    C’est-y que la 3.1 pose souci ? ou que je devrais avoir un bouton mais que peut-être un autre plugin est en conflit ? Ou qu’il y a une config à faire quelque part ?

    Merci de m’éclairer ;-)

    Répondre à ce message

  • Le 7 avril 2015 à 20:15, par Yohooo En réponse à : Plugin Encarts

    Bonjour,

    Ce plugin ne semble pas fonctionner avec la derniere version de Spip.
    Le formulaire d’edition ne fait pas apparaître les champs.

    Une idée pour réparer cela ?

    • Le 9 avril 2015 à 17:14, par cam.lafit En réponse à : Plugin Encarts

      Bonjour

      La version 2.0.1 devrait résoudre le problème pour spip3

    Répondre à ce message

  • Le 9 mars 2014 à 07:29, par benolaos En réponse à : Plugin Encarts

    Bonjour,

    Y a-t-il un moyen d’utiliser ce plugin sur des rubriques ?
    Je suis en SPIP v3, et cherche à intégrer un encart dans un squelette.
    Et ce plugin est EXACTEMENT ce qu’il me faudrait !

    En vous remerciant

    Répondre à ce message

  • Le 28 mars 2013 à 14:45, par Anne-Gaëlle TESTARD En réponse à : Plugin Encarts

    Bonjour,

    Existe-t-il une version du plugin Encarts pour Spip 3 ou quelque chose d’équivalent ?

    Merci

    • Le 5 octobre 2013 à 18:54, par Cyril Marion En réponse à : Plugin Encarts

      Bonjour,
      Une version beta de encarts pour SPIP3 est publiée ; je l’ai testée rapidement sur un site de développement et n’ai pas noté d’anomalies pour la création / suppression des encarts depuis un article ; en revanche il reste à traiter le pipeline qui remplace le code <encart> (fonction encarts_pre_propre()).

      http://zone.spip.org/trac/spip-zone/browser/_plugins_/encarts/trunk

    • Le 4 janvier 2014 à 19:01, par Manu En réponse à : Plugin Encarts

      Bonjour Cyril,
      Pour un site qui vient de migrer sous SPIP3, je souhaitais utiliser « encarts » pour insérer des encarts (!) au fil du texte via la paire de balises<encart>bla bla bla</encart> mais, en lisant la doc, qu’est-ce que je vois, aaarrrgggh ! damned, c’est le bout qui manque actuellement…

      Alors, je me suis fait une rustine de dépannage en installant la fonction encarts_pre_propre dans mes_fonctions.php et j’ai appliqué dans mes squelettes le filtre encarts_pre_propre sur les balises visées.

      OK, ça fonctionne mais c’est bien sûr beaucoup moins bien que si le plugin encart faisait le boulot…
      Que faudrait-il faire pour activer le « bout qui manque » était compliqué à faire… Ça m’intéresserait de me pencher sur le truc parce que j’ai l’impression que ça ne doit pas être trop compliqué et que ça m’aiderait à comprendre comment marche un plugin, un pipeline etc...

    • Le 6 janvier 2014 à 16:56, par Cyril Marion En réponse à : Plugin Encarts

      Bonjour Manu,
      Une piste à suivre serait d’ajouter au plugin en version V2 la fonction encarts_pre_propre qui se trouve ici : http://zone.spip.org/trac/spip-zone/browser/_plugins_/encarts/branches/v1.3/encarts_pipelines.php#L31. Sans oublier de déclarer le pipeline dans le paquet.xml ici : http://zone.spip.org/trac/spip-zone/browser/_plugins_/encarts/trunk/paquet.xml

      Bonne programmation !
      et tiens nous au courant des résultats ;-)

    • Le 6 janvier 2014 à 18:22, par Manu En réponse à : Plugin Encarts

      …OK…
      1 - j’ai rajouté dans plugin.xml
      <pipeline nom="post_propre" inclure="encarts_pipelines.php"/>
      2 - j’ai rajouté dans encarts_pipelines.php la fonction encarts_pre_propre

      mais rien ne se passe, enfin, je veux dire que le remplacement de <encart> et </encart> ne se fait pas…
      Comment peut-on « suivre » ce que fait SPIP ? La question que je me pose est de savoir si, arrivé dans le pipeline « post_propre » (ou celui qui est déclaré dans paquet.xml), la fonction encarts_pre_propre est bien exécutée ? Comment puis-je savoir ça ?

    • Le 6 janvier 2014 à 19:29, par Cyril Marion En réponse à : Plugin Encarts

      Hello Manu,
      Tu y es presque ;-)
      Il faut que le nom du pipeline déclaré dans paquet.xml (attention, en SPIP3 c’est « paquet.xml » et pas « plugin.xml ») soit le même que celui de ta fonction.
      En l’occurrence d’après ce que tu écris, tu appelles le pipeline « post_propre » au lieu de « pre_propre ».
      Ensuite, il ne faut pas oublier de repasser sur la page /ecrire/ ?exec=admin_plugin afin que le fichier paquet.xml modifié soit pris en compte.

      Enfin, pour mettre au point ton code, tu peux y insérer des var_dump() pour faire afficher le contenu de variables ; bien veiller à les supprimer ensuite ;-)
      Une page d’astuces toujours utiles : http://www.spip.net/fr_article4453.html

    • Le 6 janvier 2014 à 22:16, par Manu En réponse à : Plugin Encarts

      OK… tu as tapé juste : je n’avais pas capté qu’il fallait repasser par ?exec=admin_plugin pour que les motifs de paquet.xml soient prises en compte. Merci !

      Pour compléter, j’ai modifié la fonction pour que le remplacement produise un div plutôt qu’un spam : on peut ainsi mettre des sous titres, paragraphes etc… bref se servir de la barre typo dans la rédaction de l’encart qui, sinon, part en vrille…
      J’ai l’impression qu’avec SPIP3 qui revu sa gestion du « paragraphage » du texte, l’utilisation de div doit poser moins de problème, non ?

    Répondre à ce message

  • Le 13 août 2012 à 16:24, par Manu En réponse à : Plugin Encarts

    Tout d’abord, un grand merci pour ce plugin bien pratique ! Je voulais savoir si le plugin avait un peu évolué de telle sorte qu’il saurait désormais utiliser une balise de type block plutôt que d’utiliser la balise span ( ceci afin d’améliorer la mise enforme css) ?

    Répondre à ce message

  • Le 13 septembre 2011 à 14:45, par Nicoco En réponse à : Plugin Encarts

    Salut,

    Je viens d’installer le plugin Encart 1.3 (accompagné de saisie 1.14.0 et Afficher_object 1.2.0).

    J’ai un problème lors de l’affichage, le texte inclus entre mes balises d’encart n’apparait pas encadré ...

    Est-ce normale ?

    Les plugins dépendant ne sont peut-être pas à la bonne version ?

    D’avance merci de votre aide.

    Répondre à ce message

  • Le 3 février 2011 à 15:10, par Haqqtiviste En réponse à : Encarts

    Ne pas oublier d’indiquer dans le tuto les dépendances aux plugins « Saisies » et « Afficher Objet ». Merci en tout cas

    • Le 5 février 2011 à 13:02, par Cyril Marion En réponse à : Encarts

      C’est fait, merci pour la suggestion pertinente !

    • Le 15 juillet 2011 à 22:15, par ivandps En réponse à : Plugin Encarts

      bonjour
      ou est le plugin « afficher objets »

    • Le 1er septembre 2011 à 08:41, par Monja En réponse à : Plugin Encarts

      A cette adresse : http://svp.smellup.net/spip.php?plugin17

      Ce sera pour ceux qui viendront après moi et qui comme moi n’a pas pu faire fonctionner le plugins ENCARTS à cause des deux plugins dont il dépend !!

    • Le 1er septembre 2011 à 09:36, par Monja En réponse à : Plugin Encarts

      Mais finalement le fichier n’était pas là ou l’on m’a dirigé, alors il a fallu chercher encore et finalement je l’ai eu ici : http://www.codes-libres.org/zip-plugins/afficher_objets.zip

      à travers google qui m’a proposé ce site : http://www.findthatfile.com

      Franchement, pas évident les amis.

    • Le 1er septembre 2011 à 10:33, par Cyril Marion En réponse à : Encarts

      Pas évident ?

      Petit rappel :

      Les plugins SPIP sont, pour la plupart, développés sur « la Zone » SPIP, et documentés ici sur SPIP-contrib. Ils peuvent être récupérés par les développeurs avec Subversion, mais tout un chacun peut récupérer le zip qui est généré automatiquement toutes les heures dans le dossier des zips de la zone. Tu aurais donc pu facilement trouver AfficherObjets à cette adresse.

      D’autre part, les plugins s’installent facilement à partir de la page ecrire/ ?exec=admin_plugin de n’importe quel site SPIP ; il faut simplement vérifier que les listes de plugins à télécharger soient à jour.

      Et ils s’installent encore plus facilement avec le plugin STEP, qui gère aussi les dépendances, comme celles de Encarts.

      En conclusion, on trouve tout sur la zone ou dans la galaxie SPIP, nul besoin d’interroger google et de risquer de tomber sur une version de plugin pas à jour.

    • Le 1er septembre 2011 à 13:02, par Monja En réponse à : Encarts

      Cool !! Merci pour la précision. Je prend note pour les prochaines fois.

    Répondre à ce message

Répondre à cet article

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 Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Ajouter un document

Retour en haut de la page

Ça discute par ici

  • Mailsubscribers

    16 janvier 2013 – 274 commentaires

    Ce plugin permet de gérer les inscriptions (ou abonnements) à la diffusion de contenu par email. Mailsubscribers permet de gérer les inscriptions par Opt-in simple ou double et la désinscription par URL. Ce plugin gère également plusieurs listes (...)

  • noiZetier v2

    9 novembre 2012 – 36 commentaires

    Le noiZetier offre une interface d’administration permettant d’insérer au choix des éléments modulaires de squelettes (noisettes) et de les ajouter ainsi à ses squelettes. Compatibilité La version 2 du noizetier fonctionne sous SPIP 3. Elle est (...)

  • cirr : plugin « rédacteur restreint »

    29 octobre 2010 – 60 commentaires

    Ce plugin « cirr : rédacteur restreint » permet d’affecter des rubriques aux rédacteurs et modifie les droits afin qu’un rédacteur restreint (ou un administrateur restreint) voit dans l’espace privé uniquement les rubriques qui lui sont affectées (et leur (...)

  • Un retour d’expérience d’utilisation de Formidable

    26 octobre – commentaires

    Il s’agissait de créer un formulaire d’inscription à un évènement modérer les inscriptions dans le privé publier les inscriptions dans le public Nous avons discuté de cette présentation lors de l’apéro SPIP du 15 février 2016 à la Cantine (...)

  • Métas +

    3 décembre – 14 commentaires

    Améliorez l’indexation de vos articles dans les moteurs et leur affichage sur les réseaux sociaux grâce aux métadonnées Dublin Core, Open Graph et Twitter Card. Installation Activer le plugin dans le menu dédié. Dans le panel de configuration, (...)

Ça spipe par là