Vu ! : la documentation

Tout ce qu’il faut savoir en détail pour mettre en œuvre le plugin Vu !. Sur les boucles, les balises, les critères, des indications diverses et variées...

Principe général

D’un point de vue technique, aux trois nouveaux objets éditoriaux correspondent trois tables supplémentaires, et donc trois nouvelles boucles avec leurs balises et critères. Chacune de ces tables possède en outre une table auxiliaire dite de jointure, afin d’intégrer un peu mieux tout ceci au reste. Ces dernières ne sont pour l’instant utilisées que pour la gestion des mots-clés associés aux annonces, publications ou événements.

Depuis la version 0.4 (25 mai 2010), il est possible de configurer finement les nouveaux objets sur son site, via CFG.

Les boucles

La boucle VU_ANNONCES

balisedescription
#ID_ANNONCE Identifiant unique de l’annonce
#TITRE Titre de l’annonce
#LIEN Lien à consulter associé à l’annonce
#ANNONCEUR Qui publie l’annonce ?
#PEREMPTION Date de fin de publication de l’annonce (parce qu’une annonce a toujours une durée de vie limitée)
#TYPE Type d’annonce (communication ? appel à projet ? information ? ...)
#DESCRIPTIF Quelques mots pour décrire l’information relayée
#SOURCE_NOM Source de l’information, si provenance externe
#SOURCE_LIEN Lien vers la source de l’information (tout à fait différent du lien associé à l’annonce)
#DATE Date de publication de l’information sur votre site
#STATUT Statut de publication de l’information sur votre site

La boucle VU_EVENEMENTS

balisedescription
#ID_EVENEMENT Identifiant unique de l’évènement
#TITRE Titre de l’évènement
#LIEN Lien à consulter associé à l’évènement
#DATE_EVENEMENT Date de l’évènement
#LIEU_EVENEMENT Lieu de l’évènement
#ORGANISATEUR Qui organise l’évènement ?
#TYPE Type d’évènement (journée d’étude ? manifestation ? conférence ? ...)
#DESCRIPTIF Quelques mots pour décrire l’information relayée
#SOURCE_NOM Source de l’information, si provenance externe
#SOURCE_LIEN Lien vers la source de l’information (tout à fait différent du lien associé à l’annonce)
#DATE Date de publication de l’information sur votre site
#STATUT Statut de publication de l’information sur votre site

La boucle VU_PUBLICATIONS

balisedescription
#ID_PUBLICATION Identifiant unique de la publication
#TITRE Titre de la publication
#LIEN Lien direct vers la publication si accessible en ligne
#DATE_PUBLICATION Quand la publication est-elle parue ?
#AUTEUR Auteur de la publication (et émetteur de l’information)
#EDITEUR Éditeur de la publication (et support de l’information)
#TYPE Type de publication (journal ? essai ? article scientifique ?
#DESCRIPTIF Quelques mots pour décrire l’information relayée
#SOURCE_NOM Source de l’information, si provenance externe
#SOURCE_LIEN Lien vers la source de l’information (tout à fait différent du lien associé à l’annonce)
#DATE Date de publication de l’information sur votre site
#STATUT Statut de publication de l’information sur votre site

Les critères

Les critères et balises de chaque boucle ne sont autres que les noms des champs figurant dans la table. Chaque champ est donc potentiellement utilisable comme critère ou comme balise, même si ce n’est pas toujours pertinent. En effet, à quoi bon un critère {titre} ? Par contre un critère comme {peremption > #ENV{date}} semble beaucoup utilisable.

Ainsi, le critère commun {par ...} - pour indiquer l’ordre de présentation des résultats - est tout à fait fonctionnel ici.

De plus, le critère id_mot a été ajouté, il permet de sélectionner les objets selon leurs mot-clés.

Autres fonctionnalités et compatibilités

Certaines fonctionnalités spécifiques sont en cours d’implémentation. Actuellement :

  • Syndication RSS pour les nouveaux objets (backend-vu.html).
  • Possibilité de récupérer ou d’effacer définitivement des éléments supprimés (compatibilité avec le plugin Corbeille) ;
  • Ajouter des champs de formulaires aux nouveaux objets (compatibilité avec le plugin Champs Extras 2) ;
  • Compatibilité avec le plugin Bandeau.

Discussion

10 discussions

  • 1
    norbert

    il serait bien de rendre ce plugin fort utile compatible avec le nouveau bandeau en ajoutant ces lignes au plugin.xml :

    <bouton id="vu_tous21" parent="bando_edition">
    	<icone>prive/themes/spip/images/vu_logo_16.png</icone> 
    	<titre>Veille</titre>	
    	<url>veille_tous</url>	
    </bouton>

    et en plaçant une version du logo du plugin de 16 pix dans le répertoire prive/themes/spip/images.

    ce serait vraiment super ! merci.

    • Merci (avec un peu de retard, certes) pour cette évolution clé en main. Testée et adoptée, incluse dans la version 0.4.1.

    Répondre à ce message

  • 1

    Bonjour,
    J’ai hélas une erreur « Filtre barre_typo non défini » (../plugins/auto/vu/formulaires/editer_annonce.html ) lorsque j’’essaie d’ajouter une nouvelle annonce...
    SPIP 2.1.10
    Merci par avance de pistes et de votre aide.

    • Merci pour le retour de bug. Je n’ai par contre pas réussi à le reproduire sur ma version locale...
      Cependant, ayant déjà eu ce problème ailleurs, j’ai tenté un petit quelque chose qui devrait vous aider.
      Testez la version 0.4.1 du plugin (en bonus : la compatibilité avec le plugin Bandeau) et faites moi savoir comment ça évolue, merci !

    Répondre à ce message

  • 5
    slievain

    Bonjour,
    Comment peut on supprimer une « Publications » (ou un « Événements »/« Annonces ») ?

    Merci d’avance !

    • À l’instar de tout autre objet SPIP natif, il n’est pas possible de supprimer un élément sans installer le plugin Corbeille. Sans lui, seul l’item « à la poubelle » est disponible, qui dépublie l’élément sans pour autant le supprimer de la base de donnée. Avec, en se rendant dans Configuration > Corbeille, on voit apparaître tous les éléments marqués « à la poubelle » confondus, avec la possibilité de les effacer définitivement.

      Voilà !

    • slievain

      Bonjour,
      Je dois peut-être regarder au mauvais endroit car je n’arrive pas à voir l’item « à la poubelle ». Les seules options que je peux voir sont :
      -  Publication proposée
      -  OUI - Publication validée
      -  NON - Publication refusée

      Merci d’avance

    • Avez-vous installé le plugin Corbeille ? Si non... la solution est là. Si oui, c’est un problème en effet vu que ça fonctionne ici. Répondez moi avant que je m’y plonge, et s’il y a effectivement un problème indiquez moi la version de SPIP utilisée ainsi que des plugins Vu ! et Corbeille.

    • Bonjour,
      J’ai bien installé le plugin Corbeille.
      Concernant les versions :
      SPIP : 2.0.8
      Vu ! : 0.2 [31585] — stable —
      Corbeille : 0.7 [37287] — stable

      Merci d’avance

    • Votre version du plugin Vu ! n’est pas à jour ! En effet, comme indiqué ici, la possibilité de supprimer des éléments n’est possible qu’à partir de la version 0.3. :) Nous sommes maintenant en version 0.4, essayez donc, vous verrez pas mal de petites améliorations...

    Répondre à ce message

  • Je ne connaissais effectivement pas ce plugin... merci pour le lien !

    Une belle rencontre ? Sûrement. Les objectifs poursuivis ne sont pas tout à fait les mêmes, mais il y a en effet des idées très intéressantes. Notamment celle d’un bouton intégrée au navigateur... quel gain d’efficacité ce serait ! Je verrai cela un peu plus tard, pour l’instant finissons d’intégrer CFG...

    Répondre à ce message

  • Très bonne idée ce plugin.

    Avez-vous connaissance de ceci ?
    http://www.spip-contrib.net/Le-bouton-memo

    Peut-être une belle rencontre en perspective !

    Répondre à ce message

  • 9

    @François : Oui, c’est une coquille dans la doc (que je corrige de suite). La balise #LIEN_PRESENTATION date en fait de la version 0.1 du plugin. La balise #LIEN l’a remplacée depuis... c’est d’ailleurs le cas aussi des annonces et événements. Merci pour le retour !

    • François

      Oui, ça fonctionne bien avec la balise #LIEN ! Merci.
      Il y a éventuellement autre chose que je trouverais pratique : ce serait de pouvoir mettre à la poubelle les annonces (événements, publications) devenues obsolètes.

    • @François : hum... peux-tu préciser ta pensée ? est-ce que tu veux dire qu’il faudrait un champ similaire à #PEREMPTION des annonces pour lés événements et les publications ? Ou tu veux dire qu’il faudrait rendre possible la suppression des annonces, événements, et publication ?

    • Rendre possible la suppression des annonces, événements et publication me semblerait en effet une appréciable souplesse de fonctionnement. En tout cas merci pour ce travail que j’utilise ici (pour le moment) www.passereve.com/spip/spip.php?page=plan

    • @François : Il n’y a pas de quoi vraiment, je suis heureux de mon coté de savoir que ce plugin est utilisé par d’autres que moi. C’est donc un plaisir partagé !

      Concernant la suppressions des objets éditoriaux, cela ne corresponds pas au fonctionnement standard de SPIP. Mais on peut en effet imaginer une compatibilité avec le plugin Corbeille (inutile de réinventer la roue)... l’idée me paraît bonne, je mets ça sur ma to-do liste. Voila !

    • En fait, c’était bien plus simple que prévu d’ajouter la possibilité de supprimer... c’est donc chose faite ! :)

      Par contre, pour en profiter il faut récupérer la version SVN du plugin (ici), ce n’est pas encore reporté sur le zip, on attendra la prochaine version stable pour ça.

      Et concernant, la compatibilité avec le plugin Corbeille, je suis en train de voir ce qui est possible...

    • François

      Super ! Et bravo pour la réactivité !

    • Parce que supprimer un élément est finalement dangereux si aucun retour en arrière n’est possible, ce plugin est maintenant compatible avec le plugin Corbeille !

      (Toujours en SVN pour l’instant...)

    • François

      Voilà une souplesse qui ajoute une incontestable plus-value à ce plugin ! J’ai testé, chez moi ça fonctionne très bien sous spip 2.0.10

    • Super ! Merci François pour ce retour !

    Répondre à ce message

  • François

    Bonjour,

    et merci pour cette contribution que je trouve bien utile.
    Néanmoins je ne parviens pas à utiliser la balise “#LIEN_PUBLICATION” qui me renvoie un champ vide sous spip 2.0.10
    et que je ne parviens donc pas non plus à faire fonctionner avec
    href="#LIEN_PUBLICATION"#TITRE sur le site public, bien que le lien fonctionne correctement sur le site privé.

    Cordialement,

    François

    Répondre à ce message

  • @Vincent : Concernant les conventions de nommage de spip, (qui sont bien difficiles à trouver de façon claires, si tu as une URL à me donner peut-être ?), il me semble pourtant pas être très loin du but... en gardant l’exemple de spip_vu_publications nous avons bien un préfixe « vu » suivit de l’objet au pluriel « publications ». Pour le champ id_publication, nous avons bien la chaine « id_ » suivit de l’objet au singulier « publication ». Rien d’anormal... Ceci dit il me semble en effet avoir remarqué un soucis (avec champs extras notamment), le nom réel de cet objet éditorial ne serait pas « publication » mais « vu_publication » : ce qui donnerait un id_vu_publication (mais aussi alors spip_vu_vu_publications ?). Je suis conscient du problème, il faut que j’étudie ça... les idées sont bienvenues !

    @ju3873 : Eh bien y’a pas de quoi ! Je suis bien content que ça serve à quelqu’un... ;)

    Répondre à ce message

  • Bonsoir,

    Je viens juste d’installer et de regarder rapidement le plugin, et bien que je n’en ai pas l’usage, ça fait très plaisir de trouver un plugin bien structuré pour apprendre à créer de nouveaux objets. Merci de nous faire profiter de votre travail. Et un grand bravo pour l’effort de documentation.

    Répondre à ce message

  • Bonjour,

    Je viens de remarquer que tes champs primaires, id_publication de la table spip_vu_publications par exemple, ne respectent pas la convention de nommage de spip qui est :

    table = préfixe_objets
    id primaire = id_objet

    C’est dommage et cela peut poser des soucis de compatibilité avec d’autres plugins.

    ++

    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