Liste des fonctions de boucle
La boucle $res
Cette boucle est utilisable dans les patrons de catégories. Elle permet d'obtenir les ressources contenues dans la catégorie en cours. Par exemple:
<?php while (!$res->EOF() ): ?>
<div class="resource">
<h2><a href="<?php pxResPath(); ?>"><?php pxResTitle(); ?></a></h2>
<?php pxResDescription(); ?>
</div>
<?php
$res->moveNext();
endwhile; ?>
pxResTitle
pxResTitle( $s )
Paramètres
- $s - Chaîne de substitution ('%s')
Affiche le titre de la ressource.
pxResPath
pxResPath( $type )
Paramètres
- $type - 'full' donne le chemin avec http://. Par défaut il est en relatif ('relative')
Affiche le chemin de la ressource.
pxResDescription
pxResDescription( $s, $limit )
Paramètres
- $s - Chaîne de substitution ('%s')
- $limit - Limite du nombre de mots (caractères pour le moment) afin de restreindre la description
Affiche la description d'une ressource.
Si une limite est donnée, la description est convertie en texte brut puis la limite est appliquée.
pxResCategories
pxResCategories( $s, $p1, $p2 )
Paramètres
- $s - Chaîne de substitution ('%s')
- $p1 - Premier délimiteur (', '); ',' est affiché par défaut .
- $p2 - Dernier délimiteur (' and '); 'and' est affiché par défaut.
Affiche une liste de liens vers les catégories dans lesquelles la ressource est disponible.
La liste générée n'est pas une liste HTML mais est construite comme une phrase ponctuée par les délimiteurs $p1 et $p2.
pxResAuthor
pxResAuthor( )
Affiche le nom de l'auteur.
pxResAuthorEmail
pxResAuthorEmail( $s, $encoding )
Paramètres
- $s - Chaîne de substitution ('%s')
- $encoding - Génère un lien
mailto:encodé ('link') ou un affichage textuel ('text').
Affiche l'adresse e-mail publique si l'auteur l'a définie dans ses préférences.
La possibilité d'encoder l'adresse permet de ne pas laisser celle-ci en clair dans le code source de la page.
pxResDateModification
pxResDateModification( $dateformat )
Paramètres
- $dateformat - Format de la date ('%Y-%d-%mT%T+00:00')
Affiche la date de modification de la ressource.
pxResSearchScore
pxResSearchScore( $s )
Paramètres
- $s - Chaîne de substitution ('%01.2f%%')
Affiche le score de pertinence d'une ressource dans le résultat d'une recherche.
Ne peut être utilisé que dans un gabarit de recherche.
La boucle $last
Cette boucle est utilisable dans tous les patrons, vous devez juste l'initialiser auparavant avec la fonction pxGetLastResources :
<?php pxGetLastResources(); ?>
<?php while (!$last->EOF() ): ?>
<p><a href="<?php pxLastResPath(); ?>"><?php pxLastResTitle(); ?></a></p>
<?php
$last->moveNext();
endwhile; ?>
pxGetLastResources
pxGetLastResources( $limit, $type, $category )
Paramètres
- $limit - Nombre de ressources (5); par défaut la limite est de 5.
- $type - Type de ressources ('') pour toutes, 'news' ou 'articles'.
- $category - Identifiant de catégorie ('')
Extrait la liste des dernières ressources et la place dans la variable $last pour une utilisation ultérieure par la boucle $last. Cette dernière ne peut donc être utilisée qu'après un appel à la fonction pxGetLastResources.
pxLastResTitle
pxLastResTitle( $s )
Paramètres
- $s - Chaîne de substitution ('%s')
Affiche le titre de la ressource.
pxLastResPath
pxLastResPath( $type )
Paramètres
- $type - Si 'full', donne le chemin avec http:// . Par défaut il est en relatif ('relative')
Affiche le chemin de la ressource.
pxLastResDescription
pxLastResDescription( )
Affiche la description de la ressource.
pxLastResAuthor
pxLastResAuthor( )
Affiche le nom de l'auteur.
pxLastResAuthorEmail
pxLastResAuthorEmail( $s, $encoding )
Paramètres
- $s - Chaîne de substitution ('%s')
- $encoding - Génère un lien
mailto:encodé ('link') ou un affichage textuel ('text').
Affiche l'adresse e-mail publique si l'auteur l'a définie dans ses préférences.
La possibilité d'encoder l'adresse permet de ne pas laisser celle-ci en clair dans le code source de la page..
pxLastResDateModification
pxLastResDateModification( $dateformat )
Paramètres
- $dateformat - Format de la date ('%Y-%d-%mT%T+00:00')
Affiche la date de modification de la ressource.
pxLastResAssociatedLink
pxLastResAssociatedLink( $s )
Paramètres
- $s - Chaîne de substitution ('link:%1$s title:%2$s')
Affiche le titre et le lien associés s'ils sont disponibles. Si une brève a été saisie avec ces informations, cette fonction permettra de les afficher.
pxLastResCategories
pxLastResCategories( $s, $p1, $p2 )
Paramètres
- $s - Chaîne de substitution ('%s')
- $p1 - Premier délimiteur (', '); ',' est affiché par défaut .
- $p2 - Dernier délimiteur (' and '); 'and' est affiché par défaut.
Affiche une liste de liens vers les catégories dans lesquelles la dernière ressource est disponible.
La liste générée n'est pas une liste HTML mais est construite comme une phrase ponctuée par les délimiteurs $p1 et $p2.
Partagez vos idées sur cet article.
