<sondageXX> peut être inséré dans le texte des articles.
Le squelette spip-sondages/sondage.html, que vous afficherez via spip.php?page=sondage&id_sondage=XX, est un exemple de ce qu’il est possible de faire avec le plugin.
Une boucle de sondages se code en plaçant SONDAGES entre parenthèses :
<BOUCLEn(SONDAGES) {critères...}>
Les éléments contenus dans une telle boucle sont des sondages.
Les critères de sélection :
{id_rubrique} retourne la liste des sondages contenus dans la rubrique id_rubrique.{id_secteur} retourne les sondages dans ce secteur (un secteur est une rubrique qui ne dépend d’aucune autre rubrique, c’est-à-dire située à la racine du site).{branche}{id_auteur} retourne les sondages correspondant à cet identifiant d’auteur (utile pour indiquer la liste des sondages mis en ligne par un auteur).{id_mot} retourne les sondages correspondant à cet identifiant de mot-clé (utile pour indiquer la liste des sondages traitant d’un sujet donné).{titre_mot=xxxx}, ou {type_mot=yyyy} retourne les sondages liés au mot-clé dont le nom est « xxxx », ou liés à des mots-clés du groupe de mots-clés « yyyy ». Attention, on ne peut pas utiliser plusieurs critères {titre_mot=xxxx} ou {type_mot=yyyy} dans une même boucle.{id_groupe=zzzz} permet de sélectionner les sondages liés à un groupe de mots-clés ; principe identique au {type_mot} précédent, mais puisque l’on travaille avec un identifiant (numéro du groupe), la syntaxe sera plus « propre ».{lang} sélectionne les sondages de la langue demandée dans l’adresse de la page.{date=...} permet de sélectionner un sondage en fonction de sa date.{statut=prepa} sont les sondages en cours de rédaction ;{statut=publie} sont les sondages en ligne auxquels on peut donner son avis ;{statut=termine} sont les sondages en ligne, pour lesquels on ne peut plus donner son avis ;Par défaut, une boucle SONDAGES sélectionne implicitement les sondages ayant le {statut=publie/termine}.
Les balises :
#ID_SONDAGE affiche l’identifiant unique du sondage.#ID_RUBRIQUE est l’identifiant de la rubrique dont dépend le sondage.#TITRE retourne le titre du sondage.#TEXTE retourne le texte principal du sondage.#DATE retourne la date de publication du sondage.#LANG donne la langue du sondage.#MAJ retourne la date de dernière mise-à-jour.#URL_SONDAGE est l’URL de la page du sondage, le squelette concerné est sondage.html.#FORMULAIRE_SONDAGE, sans doute la balise la plus importante, c’est elle qui affiche soit le formulaire du sondage, soit les résultats du sondage.#LOGO_SONDAGE le logo du sondage, éventuellement avec la gestion du survol.Une boucle de choix se code en plaçant CHOIX entre parenthèses :
<BOUCLEn(CHOIX) {critères...}>
Les éléments contenus dans une telle boucle sont des choix de sondages. Par défaut, cette boucle trie les choix par ordre croissant.
Les critères de sélection :
{id_sondage} retourne la liste des choix pour le sondage id_sondageLes balises de cette boucle :
#ID_CHOIX est l’identifiant unique du choix.#ID_SONDAGE affiche l’identifiant du sondage dont dépend le choix.#TITRE retourne le titre du sondage.#ORDRE retourne la position du choix dans le sondage.#POURCENTAGE est le pourcentage (valeur entière) de réponse attribuées à ce choix.Une boucle d’avis se code en plaçant AVIS entre parenthèses :
<BOUCLEn(AVIS) {critères...}>
Les éléments contenus dans une telle boucle sont des avis ou votes de sondages.
Les critères de sélection :
{id_sondage} retourne la liste des avis pour le sondage id_sondage{id_choix} retourne la liste des avis pour le choix id_choixLa balise intéressante de cette boucle est #TOTAL_BOUCLE, elle permet de dénombrer le total d’avis pour un critère donné.
|sondages_calculer_pourcentage{#ID_CHOIX} à appliquer sur #ID_SONDAGE permet d’obtenir le pourcentage de vote pour un choix, voir aussi la balise #POURCENTAGE|sondages_largeur{#ID_SONDAGE, largeur_max} à appliquer sur le #TOTAL_BOUCLE d’une boucle AVIS retourne le pourcentage de vote pour un choix ramené à une largeur_max#FORMULAIRE_SONDAGE est un formulaire CVT, il est ajaxé par défaut.