PluXml.org

Blog ou CMS à l'Xml

Classe plxShow

Fichier core/lib/class.plx.show.php

Fonction catList

Méthode qui affiche la liste des catégories actives. Si la variable $extra est renseignée, un lien vers la page d'accueil (nommé $extra) sera mis en place en première position.

Déclaration

public function catList($extra='', $format='<li id="#cat_id" class="#cat_status"><a href="#cat_url" title="#cat_name">#cat_name</a></li>', $include='', $exclude='')

Portée de la fonction : global

Paramètres

  • extra : nom du lien vers la page d'accueil
  • format : format du texte pour chaque catégorie (variable : #cat_id, #cat_status, #cat_url, #cat_name, #cat_description, #art_nb)
  • include : liste des catégories à afficher séparées par le caractère | (exemple: 001|003)
  • exclude : liste des catégories à ne pas afficher séparées par le caractère | (exemple: 002|003)

Usage(Edit)

<?php $plxShow->catList('$extra','$format','include','exclude') ?>

Détails des paramètres(Edit)

  • $extra (string) (requis) : nom du lien vers la page d'accueil ; si on ne veut pas de lien vers la page d'accueil, mettre des guillemets simples vides ('')
  • $format (string) (requis) : format du texte pour chaque catégorie ; valeurs possibles :
    • #cat_id : ID de la catégorie
    • #cat_status : statut de la catégorie (active, noactive)
    • #cat_url : url de la catégorie
    • #cat_name : nom de la catégorie
    • #art_nb : nombre d'articles dans cette catégorie
  • $include (integer) (optionnel) : liste des catégories à afficher séparées par le caractère '|'
  • $exclude (integer) (optionnel) : liste des catégories à ne pas afficher séparées par le caractère '|' ; si renseigné, $include doit contenir des guillements simples vides

Exemples(Edit)

<?php $plxShow->catList('Accueil','<li><a href="#cat_url" title="#cat_name">#cat_name</a></li>'); ?>

<?php $plxShow->catList('','<li id="#cat_id" class="#cat_status"><a href="#cat_url" title="#cat_name">#cat_name</a> (#art_nb)</li>'); ?>

Note : on notera les guillemets simples vides '' obligatoires quand on ne veut pas de lien vers la page d'accueil.

L'exemple suivant n'affichera que la catégorie numéro 1 :

<?php $plxShow->catList('','<li><a href="#cat_url" title="#cat_name">#cat_name</a></li>',1); ?>

L'exemple suivant affichera toutes les catégories sauf la catégorie numéro 2 :

<?php $plxShow->catList('','<li><a href="#cat_url" title="#cat_name">#cat_name</a></li>','',2); ?>

Exemple avancé(Edit)

Il est possible de passer une variable dans les paramètres :

<?php 
$catInclude = 3;
$plxShow->catList('','<li><a href="#cat_url" title="#cat_name">#cat_name</a></li>',$catInclude);
?>

<?php 
$homeTitle = 'Accueil';
$plxShow->catList($homeTitle,'<li><a href="#cat_url" title="#cat_name">#cat_name</a></li>');
?>

Voyons à présent un exemple avec la fonction mode :

<?php
$mode = $plxShow->mode();
if ($mode == 'home') {
$homeTitle = "Accueil";
}
else{
$homeTitle = "retour à l'Accueil";
}
$plxShow->catList($homeTitle,'<li><a href="#cat_url" title="#cat_name">#cat_name</a></li>');
?>



Accès rapide : Wiki Développeur - Wiki Général