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

Aucune discussion

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