Boucles et Balises sur le plugin Jeux

La Boucle JEUX

Elle permet, comme son nom l’indique, d’obtenir des informations sur les jeux.

Par défaut, elle n’affiche que les jeux publiés.

Les critères de sélection de la boucle JEUX sont :
-  {id_jeu}, chaque jeu ayant un id unique. Cette id peut-être passé en variable d’environnement, ou être dépendant du contexte de Boucle (par exemple sur une boucle JEUX_RESULTATS).
-  Les critères {date} et{age}, selon les mêmes principes que les critères de dates généraux de SPIP.
-  {type_jeu=type} pour choisir le type de jeu.
-  le critère {statut=xxx} pour sélectionner le statut. La valeur xxx peut prendre les valeurs publie, refuse, poubelle.
-  le critère {type_resultat=valeur} pour sélectionner les jeux selon le type de résultats stockés. Ces valeurs peuvent être :

• « defaut » : recherche la configuration globale prévue par CFG avec les mêmes valeurs :
• « aucun » : n’enregistre aucun résultat
• « premier » : n’enregistre que le tout premier score, pour chacun des utilisateurs logués (score unique)
• « dernier » : enregistre systématiquement le dernier score, pour chacun des utilisateurs logués (score unique)
• « meilleur » : n’enregistre que le meilleur score, pour chacun des utilisateurs logués (score unique)
• « meilleurs » : n’enregistre que les meilleurs scores, pour chacun des utilisateurs logués (scores multiples)
• « tous » : enregistre tous les scores, pour chacun des utilisateurs logués

-  {titre_prive}, mais comme son nom l’indique, normalement c’est pour l’espace privé.
-  enfin, l’éventuel et un peu inutile {contenu}, correspondant au contenu « brut » (non transformé en formulaire) du jeu.

Il est bien sûr possible de faire aussi des tests d’expressions régulières sur ces critères, par exemple {statut==refuse|publie} sélectionnera les jeux dont le statut est refusé ou publié.

Les critères de classement de la boucle JEUX sont les mêmes que les critères de sélection, il suffit juste d’ajouter le mot par devant ; exemple : {par date}, éventuellement avec un ! pour inverser l’ordre.

Les balises propres à cette boucle et correspondant à des champs de données sont :
-  #ID_JEU
-  #STATUT
-  #CONTENU, correspondant au contenu « brut » ou « non interprété » du jeu stocké en base.
-  #TYPE_JEU
-  #DATE
-  #TITRE_PRIVE mais comme son nom l’indique, normalement c’est pour l’espace privé.
-  #TYPE_RESULTAT

Pour vous aider à rédiger clairement vos squelettes, quatre « fausses » balises (en fait ce sont un peu des raccourcis) vous sont aussi proposées par le plugin :
-  #TITRE_PUBLIC : extrait le titre public du contenu du jeu, équivalent à : [(#CONTENU*|titre_jeu)]
-  #CONTENU_PROPRE : correspond au contenu « interprété » du jeu. Cette balise remplace la syntaxe équivalente suivante : [(#CONTENU*|traite_contenu_jeu{#ID_JEU})]
-  #TYPE_RESULTAT_COURT : offre une description courte du type de résultat traduite dans la langue courante et remplace avantageusement une écriture du genre : #SET{type,:jeux:resultat_#TYPE_RESULTAT:} [(#GET{type}|_T)]
-  #TYPE_RESULTAT_LONG : offre une description longue du type de résultat traduite dans la langue courante et remplace avantageusement une écriture du genre : #SET{type,:jeux:resultat2_#TYPE_RESULTAT:} [(#GET{type}|_T)]

La boucle JEUX_RESULTATS

Elle permet d’afficher les résultats des jeux.

Ses critères de sélection sont :
-  {id_resultat}
-  {id_jeu}, éventuellement passé en contexte, global ou de boucle.
-  {id_auteur}, éventuellement passé en contexte, global ou de boucle.
-  {date}
-  {resultat_court}, correspondant au résultat court (nombre de faute ou de bonnes réponses, selon le type de jeu).
-  {resultat_long}, détaillant les résultats.
-  {total}, correspondant au total théorique de point.

Encore une fois et grâce au préfixe par, on peut s’en servir comme critères de classement.

Mais pour aller plus loin :
-  On peut par exemple classer les résultats dans l’ordre de résultat relatif au score théorique total. Ainsi {par round(resultat_court / total, 3)} classera par l’arrondi, à trois chiffres après la virgule, du résultat court sur le score théorique total.
-  Grâce au système de jointures semi-automatiques de SPIP, il est possible de classer et de sur des critères de la boucle AUTEURS ou de la boucle JEUX.

• Pour faire sur des critères de la boucle JEUX, mettre dans les parenthèses de déclaration de la boucle JEUX_RESULTATS spip_jeux, comme ceci par exemple <BOUCLE_resultats(JEUX_RESULTATS spip_jeux){par statut} ... [1].
• Pour faire sur des critères de la boucle AUTEURS, mettre dans les parenthèses de déclaration de la boucle JEUX_RESULTATS spip_auteurs , comme ceci par exemple <BOUCLE_resultats(JEUX_RESULTATS spip_jeux){par nom} ....

Les balises propres à la boucle JEUX_RESULTATS sont :
-  #ID_AUTEUR
-  #ID_RESULTAT
-  #ID_JEU
-  #RESULTAT_COURT
-  #RESULTAT_LONG
-  #TOTAL

Quelques exemple

Ces exemples sont tirés des modèles proposés par le plugin, mais légèrement simplifiés pour éviter d’introduire des usages avancés de spip, comme par exemple les balises #GET et #SET, ainsi que le problème des modèles.

Afficher les résultat d’un jeu

Il s’agit du modèle « jeu_resultats » simplifié. L’original se trouve ici.

<B_resultats>
<table  class='spip'>
<thead><tr class="row_first" >
					<th><:jeux:auteur:></th>
					<th><:date:></th>
					<th style="text-align:center"><:jeux:resultat:></th>
			</tr></thead>
<BOUCLE_resultats(JEUX_RESULTATS spip_auteurs) {id_jeu}{par nom}>
<!-- {statut==refuse|publie} -->
<tr [class="(#COMPTEUR_BOUCLE|alterner{row_odd,row_even})"]>
	<td><a href="#URL_AUTEUR">#NOM</a></td>
	<td>[(#DATE|affdate)] [(#DATE|heures)]:[(#DATE|minutes)]</td>
	<td>#RESULTAT_COURT / #TOTAL</td>
</tr>
</BOUCLE_resultats>
</table>
</B_resultats>
<br/><:jeux:aucun_resultat:>
<//B_resultats>

Explication : cette boucle affiche sous forme de tableau les résultats du jeu dont l’id_jeu est passé en paramètre, classés par nom d’auteurs ayant joué.

Afficher les résultats d’un auteur

Il s’agit du modèle simplifié « auteur_resultats », l’original se trouve ici.

<B_resultats>
<table class='spip'>
<tr class="row_first">
	<th><:jeux:jeu_numero_court:></th>
	<th><:jeux:jeu_type:></th>
	<th><:date:></th>
	<th><:jeux:resultat:></th>
</tr></thead>
#PAGINATION
<BOUCLE_resultats(JEUX_RESULTATS spip_jeux) {id_auteur} {par id_jeu}{pagination 30}>
<tr [class="(#COMPTEUR_BOUCLE|alterner{row_odd,row_even})"]>
	<td>#ID_JEU</td>
	<td>#TYPE_JEU</td>
	<td>[(#DATE|affdate)] [(#DATE|heures)]:[(#DATE|minutes)]</td>
	<td>#RESULTAT_COURT / #TOTAL</td>
</tr>
</BOUCLE_resultats>
</table>
</B_resultats>
<br/><:jeux:aucun_resultat:>
<//B_resultats>

Commentaire : affiche les résultats de l’auteur dont l’id_auteur est passé en paramètre, classé par id_jeu et paginés par paquet de trente résultats.

Conclusion

Les balises et boucles de SPIP, c’est puissant !