Fonctions plxShow¶
Toutes les fonctions offertes par PluXml pour personnaliser votre thème.
La classe plxShow est responsable de l’affichage. Elle permet donc de modifier cet affichage, ce qui se fait grâce à des fonctions prédéfinies.
Vous trouverez dans le menu de droite ces différentes fonctions qui vous permettront de modifier l’affichage par défaut de PluXml.
Usage
Le principe général pour utiliser la classe plxShow est le suivant :
<?php $plxShow->nomFonction() ?>
Certaines fonctions possèdent des variables prédéfinies, l’usage général devient ainsi :
<?php $plxShow->nomFonction('$variable') ?>
archList¶
Usage
<?php $plxShow->archList('$format') ?>
Détails des paramètres
- $format (string) (optionnel)format du texte pour l’affichage ; valeurs possibles :
archives_id : affiche l’ID de l’archive
archives_status : affiche le status de l’archive (active / noactive)
archives_nbart : affiche le nombre d’articles
archives_url : affiche l’URL de l’archive
archives_name : affiche le nom de l’archive (mois + année)
archives_month : affiche le mois de l’archive
archives_year : affiche l’année de l’archive
valeur libre : caractère libre
Exemples
<?php $plxShow->archList() ?>
<?php $plxShow->archList('<li id="#archives_id">
<a class="#archives_status" href="#archives_url" title="#archives_name">
#archives_name (#archives_nbart)</a></li>') ?>
artCatId¶
Usage
<?php $plxShow->artCatId() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->artCatId() ?>
Exemple avancé
<?php
$var = $plxShow->artCatId();
echo $var;
?>
artCat¶
Usage
<?php $plxShow->artCat('$separator') ?>
Détails des paramètres
$separator (string) (optionnel) : caractère de séparation entre les catégories affichées ; valeur par défaut : “,”
Exemple
<?php $plxShow->artCat('|') ?>
artChapo¶
Usage
<?php $plxShow->artChapo('$format',$content) ?>
Détails des paramètres
- $format (string) (optionnel)format d’affichage du lien pour lire la suite de l’article ; valeur par défaut#art_title ; valeurs possibles :
art_title : affiche le titre de l’article dans le lien « pour lire la suite » de l’article
valeur libre : chaîne de caractère de son choix
$content (boolean) (optionnel) : affichage oui ou non le contenu de l’article si le chapô est vide ; valeur par défaut : true ; valeurs possibles : true / false ; Note : si la valeur est à false, alors $format ne sera pas affiché.
Exemples
<?php $plxShow->artChapo('#art_title',true) ?>
<?php $plxShow->artChapo('Continuer la lecture',true) ?>
artContent¶
Usage
<?php $plxShow->artContent($chapo) ?>
Détails des paramètres
$chapo (boolean) (requis) : affiche oui ou non le chapô ; valeurs possible : true / false ; valeur par défaut : true
Exemples
<?php $plxShow->artContent() ?>
<?php $plxShow->artContent(true) ?>
<?php $plxShow->artContent(false) ?>
artDate¶
Usage
<?php $plxShow->artDate('$format') ?>
Détails des paramètres
- $format (string) (optionnel)format de la date ; valeurs par défaut“#day #num_day #month #num_year(4)” ; valeurs possibles :
minute : affiche les minutes
hour : affiche l’heure de publication
day : affiche le jour (au format texte : lundi, mardi, etc…)
month : affiche le mois (au format texte : janvier, février, mars, etc…)
num_day : affiche le numéro du jour du mois (1, 15, …, 31,)
num_month : affiche le numéro du mois (1, 2, 5, …, 12)
num_year(4) : affiche l’année sur 4 chiffres (ex: 2012)
num_year(2) : affiche l’année sur 2 chiffres (ex: 12)
valeur libre : chaîne de caractère de son choix
Exemples
<?php $plxShow->artDate() ?>
<?php $plxShow->artDate('#num_day #month #num_year(4)') ?>
Exemples avancés
Formatage avancé avec des caractères libres :
<?php $plxShow->artDate('#hour:#minute') ?>
<?php $plxShow->artDate('#num_day/#num_month/#num_year(4)') ?>
artFeed¶
Usage
<?php $plxShow->artFeed('$type',$categorie,'$format') ?>
Détails des paramètres
$type (obsolete)
$categorie (integer) (optionnel) : identifiant (ID sans les 0) d’une catégorie
- $format (string) (optionnel)format du lien ; valeurs possibles :
feedUrl : url du flux RSS
feedName : nom du flux RSS
Exemples
Flux RSS des articles de tout le site :
<?php $plxShow->artFeed() ?>
Flux RSS des articles de la catégorie 1 :
<?php $plxShow->artFeed('',1, '<a href="#feedUrl" title="#feedTitle">#feedName</a>') ?>
Note : les guillemets simples vides (“”) sont obligatoires quand on précise une catégorie, à cause du paramètre obsolete $type
artId¶
Usage
<?php $plxShow->artId() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->artId() ?>
Exemple avancé
<?php
$var = $plxShow->artId();
echo $var;
?>
artNbCom¶
Usage
<?php $plxShow->artNbCom('$f1','$f2','$f3') ?>
Détails des paramètres
$f1 (string) (optionnel) : format d’affichage si nombre de commentaire = 0 ; variable possible : #nb pour afficher le nombre de commentaire ; valeur par défaut “aucun commentaire”
$f2 (string) (optionnel) : format d’affichage si nombre de commentaire = 1 ; variable possible : #nb pour afficher le nombre de commentaire ; valeur par défaut “#nb commentaire”
$f2 (string) (optionnel) : format d’affichage si nombre de commentaire > 1 ; variable possible : #nb pour afficher le nombre de commentaires ; valeur par défaut “#nb commentaires”
Exemples
<?php $plxShow->artNbCom() ?>
<?php $plxShow->artNbCom('#nb commentaire','#nb commentaire','#nb commentaires') ?>
<?php $plxShow->artNbCom('#nb','#nb','#nb') ?>
artTitle¶
Usage
<?php $plxShow->artTitle('$type') ?>
Détails des paramètres
$type (string) (optionnel) : valeur possible : “link”. Affiche le titre de l’article sous forme d’un lien cliquable
Exemples
<?php $plxShow->artTitle() ?>
<?php $plxShow->artTitle('link') ?>
artThumbnail¶
Usage
<?php $plxShow->artThumbnail('$format', $echo); ?>
Détails des paramètres
- $format (string) (optionnel)format du texte pour chaque tag ; valeurs par défauts<a href= »#img_url »><img class= »art_thumbnail » src= »#img_thumb_url » alt= »#img_alt » title= »#img_title » /></a> ; valeurs possibles :
img_url : l’URL de l’image d’accroche
img_thumb_url : l’URL de la miniature de l’image d’accroche
img_title : Titre de l’image d’accroche
img_alt : Texte alternatif d’affichage de l’image d’accroche
$echo (boolean) (optionnel) : valeurs possibles : true / false. Par défaut la valeur est à true. Si la valeur est à false, alors l’image ne sera pas affiché
$article (boolean) (optionnel) : valeurs possibles : true / false. Par défait la valeur est false. Si la valeur est true, alors au clic sur l’image PluXml redirige vers l’article et non vers l’image.
Exemples
<?php $plxShow->artThumbnail() ?>
<?php $plxShow->artThumbnail('<a href="#img_url">
<img class="art_thumbnail" src="#img_thumb_url" alt="#img_alt" title="#img_title" /></a>', true) ?>
artUrl¶
Usage
<?php $plxShow->artUrl() ?>
Détails des paramètres
$type (deprecated) : lien relatif ou absolu
Exemple
<?php $plxShow->artUrl() ?>
Exemple avancé
Partager facilement un article sur les réseaux sociaux :
<a href="http://www.facebook.com/sharer.php?u=<?php $plxShow->artUrl() ?>">Partager sur Facebook</a>
callHook¶
Usage
<?php $plxShow->callHook('$hookName','$parms') ?>
Détails des paramètres
$hookName (string) (requis) : nom du hook
$parms (string) (requis) : paramètre ou liste de paramètres sous forme de array
Exemple
Sans return, passage d’un paramètre :
<?php eval($plxShow->callHook('MyPluginFunction', 'AZERTY')); ?>
Avec return, passage de 2 paramètres à faire sous forme de tableau :
<?php $b = $plxShow->callHook('MyPluginFunction', array('AZERTY', 'QWERTY')); ?>
capchaQ¶
Usage
<?php $plxShow->capchaQ() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->capchaQ() ?>
capchaR¶
Usage
<?php $plxShow->capchaR() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->capchaR() ?>
catDescription¶
Usage
<?php $plxShow->catDescription() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->catDescription() ?>
catId¶
Usage
<?php $plxShow->catId() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->catId() ?>
Exemple avancé
<?php
$var = $plxShow->catId();
echo $var;
?>
catList¶
Usage
<?php $plxShow->catList('$extra','$format','include','exclude') ?>
Détails des paramètres
$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
<?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é
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>');
?>
catName¶
Usage
<?php $plxShow->catName('$type') ?>
Détails des paramètres
$type (string) (optionnel) : valeur possible : “link”. Affiche le nom de la catégorie sous forme d’un lien cliquable
Exemples
<?php $plxShow->catName() ?>
<?php $plxShow->catName('link') ?>
catThumbnail¶
Usage
<?php $plxShow->catThumbnail('$format', $echo); ?>
Détails des paramètres
- $format (string) (optionnel)format du texte pour chaque tag ; valeurs possibles :
img_url : l’URL de l’image d’accroche
img_thumb_url : l’URL de la miniature de l’image d’accroche
img_title : Titre de l’image d’accroche
img_alt : Texte alternatif d’affichage de l’image d’accroche
$echo (boolean) (optionnel) : valeurs possibles : true / false. Par défaut la valeur est à true. Si la valeur est à false, alors l’image ne sera pas affichée
Exemples
<?php $plxShow->catThumbnail() ?>
<?php $plxShow->catThumbnail('<a href="#img_url">
<img class="cat_thumbnail" src="#img_thumb_url" alt="#img_alt" title="#img_title" /></a>', true) ?>
catUrl¶
Usage
<?php $plxShow->catUrl($id) ?>
Détails des paramètres
$id (integer) (requis) : id de la categorie sous la forme numérique ou formatée (ex: 1 ou 001)
Exemple
<?php $plxShow->catUrl(1) ?>
Exemple avancé
<?php
$var = $plxShow->catUrl(1);
echo $var;
?>
Cet exemple affichera http://example.org/categorie1/nom-de-ma-categorie
charset¶
Usage
<?php $plxShow->charset('$casse'); ?>
Détails des paramètres
$casse (string) (optionnel) : la $casse est soit “min” soit “maj”. Par défaut “min”.
Exemples
<?php $plxShow->charset(); ?>
Affichera par exemple :
utf-8
Autre exemple
<?php $plxShow->charset('maj'); ?>
Affichera par exemple :
UTF-8
Exemple avancé
<meta http-equiv="Content-Type" content="text/html; charset=<?php $plxShow->charset(); ?>" />
chrono¶
Usage
<?php $plxShow->chrono() ?>
Détails des paramètres
aucun
Exemple
<p>Page générée en <?php $plxShow->chrono() ?></p>
comContent¶
Usage
<?php $plxShow->comContent() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->comContent() ?>
comDate¶
Usage
<?php $plxShow->comDate('$format') ?>
Détails des paramètres
- $format (string) (optionnel)format du texte de la date ; valeurs possibles :
minute : affiche les minutes
hour : affiche l’heure
day : affiche le nom du jour (lundi, mardi, etc…)
month : affiche le nom du mois (janvier, février, etc…)
num_day : affiche le numéro du jour (01, 15, 31)
num_month : affiche le numéro du mois (01, 06, 12)
num_year(2) : affiche l’année au format court (ex: 12)
num_year(4) : affiche l’année au format long (ex: 2012)
valeur libre : un caractère au choix
Exemples
<?php $plxShow->comDate('#day #num_day #month #num_year(4)') ?>
<?php $plxShow->comDate('#num_day/num_#month/#num_year(4)') ?>
comFeed¶
Usage
<?php $plxShow->comFeed('$type',$article,'$format') ?>
Détails des paramètres
$type (string) (OBSOLETE - requis, vide) : type de flux
$article (integer) (optionnel) : identifiant (sans les 0) d’un article
- $format (string) (optionnel)format du lien ; valeurs possibles :
feedUrl : url du flux RSS
feedName : nom du flux RSS
Exemple
<?php $plxShow->comFeed() ?>
<?php $plxShow->comFeed('',3,'<a href="#feedUrl" title="#feedTitle">#feedName</a>') ?>
Note : les guillemets simples sont obligatoires quand on précise l’ID de l’article en raison du paramètre $type obsolète
comGet
Usage
<?php $plxShow->comGet($key,'$defaut') ?>
Note : manque de précision
Détails des paramètres
$key (string) (requis) : clé du tableau GET
$defaut (string) (requis) : valeur par défaut si variable vide
comId¶
Usage
<?php $plxShow->comId() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->comId() ?>
comMessage¶
Usage
<?php $plxShow->comMessage() ?>
Note : manque de précision
Détails des paramètres
aucun
Exemple
<?php $plxShow->comMessage() ?>
comType¶
Usage
<?php $plxShow->comType() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->comType() ?>
Exemple avancé
Cette fonction est utile pour un habillage CSS différent quand le commentaire est écrit par l’admin du site :
<div class="<?php $plxShow->comType() ?>">ON AFFICHE ICI LE COMMENTAIRE</div>
comUrl¶
Usage
<?php $plxShow->comUrl() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->comUrl() ?>
defaultLang¶
Usage
<?php $plxShow->defaultLang($echo) ?>
Détails des paramètres
$echo (boolean) (optionnel) : si TRUE, affichage à l’écran
Exemple
<?php $plxShow->defaultLang(true) ?>
erreurMessage¶
Usage
<?php $plxShow->erreurMessage() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->erreurMessage() ?>
getLang¶
Usage
<?php $plxShow->getLang('$key') ?>
Détails des paramètres
$key (string) (requis) : clé de traduction à afficher
Exemple
<?php $plxShow->getLang('HOME') ?>
Liste des termes
Vous pouvez trouver la liste dans termes dans les fichiers du répertoire /themes/defaut/lang/.
Voici la liste des termes :
- header.php :
HOME
GOTO_CONTENT
GOTO_MENU
COMMENTS_RSS_FEEDS
COMMENTS
ARTICLES_RSS_FEEDS
ARTICLES
- sidebar.php :
CATEGORIES
LAST_ARTICLES
LAST_COMMENTS
ARCHIVES
- footer.php :
POWERED_BY
PLUXML_DESCRIPTION
IN
ADMINISTRATION
GOTO_TOP
TOP
- erreur.php :
ERROR
BACKTO_HOME
- common :
WRITTEN_BY
CLASSIFIED_IN
TAGS
- commentaires.php :
SAID
WRITE_A_COMMENT
NAME
WEBSITE
EMAIL
COMMENT
CLEAR
SEND
COMMENTS_CLOSED
ANTISPAM_WARNING
get¶
Usage
<?php $plxShow->get() ?>
Note : manque de précision
Détail des paramètres
aucun
httpEncoding¶
Usage
<?php $plxShow->httpEncoding() ?>
Détail des paramètres
aucun
Exemple
<?php $plxShow->httpEncoding() ?>
Si la compression Gzip est activée dans les paramètres avancés de PluXml, alors cette fonction affichera :
Compression GZIP activée
lang¶
Usage
<?php $plxShow->lang('$key') ?>
Détails des paramètres
$key (string) (requis) : texte traduit par PluXml
Exemple
<?php $plxShow->lang('CATEGORIES') ?>
Liste des termes
Vous pouvez trouver la liste dans termes dans les fichiers du répertoire /themes/defaut/lang/.
Voici la liste des termes :
- header.php :
HOME
GOTO_CONTENT
GOTO_MENU
COMMENTS_RSS_FEEDS
COMMENTS
ARTICLES_RSS_FEEDS
ARTICLES
- sidebar.php :
CATEGORIES
LAST_ARTICLES
LAST_COMMENTS
ARCHIVES
- footer.php :
POWERED_BY
PLUXML_DESCRIPTION
IN
ADMINISTRATION
GOTO_TOP
TOP
- erreur.php :
ERROR
BACKTO_HOME
- common :
WRITTEN_BY
CLASSIFIED_IN
TAGS
- commentaires.php :
SAID
WRITE_A_COMMENT
NAME
WEBSITE
EMAIL
COMMENT
CLEAR
SEND
COMMENTS_CLOSED
ANTISPAM_WARNING
lastArtList¶
Usage
<?php $plxShow->lastArtList('$format',$max,$cat_id,'$ending',$sort) ?>
Détails des paramètres
- $format (string) (optionnel)format du texte pour chaque article ; valeurs possibles :
art_id : affiche l’ID de l’article
art_url : affiche l’URL de l’article
art_status : affiche le status de l’article (active / noactive)
art_author : affiche l’auteur de l’article
art_title : affiche le titre de l’article
art_chapo : affiche le chapô de l’article
art_content : affiche un extrait du contenu de l’article
art_content(num) : affiche un extrait du contenu de l’article en précisant le nom de caractère affichés
art_date : affiche la date de publication de l’article au format court (jj/mm/aaaa)
art_hour : affiche l’heure de publication de l’article au format court (hh:mm)
cat_list : affiche les catégories auxquelles appartient l’article sous forme d’un lien
art_nbcoms : affiche le nombre de commentaires pour chaque article
$max (integer) (optionnel) : nombre d’article à afficher ; valeur par defaut : 5
$cat_id (integer) (optionnel) : limiter l’affiche des articles à une catégorie précise
$ending (string) (optionnel) : texte à ajouter en fin de ligne ; Note : ne semble pas fonctionner
$sort (string) (optionnel) : ordre de trie. Valeur possible sort|rsort|alpha|random
Exemple
<?php $plxShow->lastArtList('<li><a href="#art_url" title="#art_title">#art_title</a></li>',3) ?>
Limiter l’affichage aux 5 derniers articles de la catégorie 1 :
<?php $plxShow->lastArtList('<li><a href="#art_url" title="#art_title">#art_title</a></li>',5,1) ?>
lastComList¶
Usage
<?php $plxShow->lastComList('$format',$max,$art_id,$cat_ids) ?>
Détails des paramètres
- $format (string) (optionnel)format du texte pour chaque commentaire ; valeurs possibles :
com_id : affiche l’ID du commentaire
com_url : affiche l’URL du commentaire
com_author : affiche l’auteur du commentaire
com_content(num) : affiche les N (num) premiers caractères du commentaire
com_content : affiche le commentaire dans son intégralité
com_date : affiche la date du commentaire
com_hour : affiche l’heure de commentaire
valeur libre : caractère libre
$max (integer) (optionnel) : nombre de commentaires maximum à afficher ; valeur par défaut : 5
$art_id (integer) (optionnel) : restreindre l’affichage des derniers commentaires à un article précis via son ID (ex: 24, 3)
$cat_ids (integer) (optionnel) : restreindre l’affichage des derniers commentaires à certaines catégories via leur ID (ex: 1|2 ; voir exemples)
Exemples
Affichage basique :
<?php $plxShow->lastComList(
'<li><a href="#com_url">#com_author a dit :</a><p>#com_content(50)</p></li>') ?>
Afficher seulement les 3 derniers commentaires :
<?php $plxShow->lastComList(
'<li><a href="#com_url">#com_author a dit :</a><p>#com_content(50)</p></li>',3) ?>
Afficher seulement les 3 derniers commentaires de l’article ayant l’ID 9 :
<?php $plxShow->lastComList(
'<li><a href="#com_url">#com_author a dit :</a><p>#com_content(50)</p></li>',3,9) ?>
Afficher seulement les 3 derniers commentaires de la catégorie 6 :
<?php $plxShow->lastComList(
'<li><a href="#com_url">#com_author a dit :</a><p>#com_content(50)</p></li>',3,'',6) ?>
Note : notez les guillements simples “” à la place de $art_id
Afficher seulement les 3 derniers commentaires des catégories 6 et 8 :
<?php $plxShow->lastComList(
'<li><a href="#com_url">#com_author a dit :</a><p>#com_content(50)</p></li>',3,'',6|8) ?>
mainTitle¶
Usage
<?php $plxShow->mainTitle('$type') ?>
Détails des paramètres
$type (string) (optionnel) : type d’affichage en format texte ou sous forme de lien ; valeur possible : link
Exemples
<?php $plxShow->mainTitle() ?>
<?php $plxShow->mainTitle('link') ?>
Exemple avancé
<div id="header"><h1><?php $plxShow->mainTitle('link') ?></h1></div>
Note
cette fonction définie le contenu et la cible du lien. Pour personnaliser le contenu du lien, voir la [fontion racine|plxShow-racine]
meta¶
Usage
<?php $plxShow->meta('$meta') ?>
Détails des paramètres
$meta (string) (requis) : nom du meta à afficher ; les différentes valeurs possibles sont : description, keywords, author
Exemples
<?php $plxShow->meta('description') ?>
<?php $plxShow->meta('keywords') ?>
<?php $plxShow->meta('author') ?>
Note
Cette fonction sert principalement à remplir automatiquement les champs « meta » de la balise <head></head>
Lors de la rédaction d’un article, vous pouvez indiquer le contenu des balises « description » et « keywords »
mode¶
Usage
<?php $plxShow->mode() ?>
Détail des paramètres
aucun
Exemple
<?php
$var = $plxShow->mode();
echo $var;
?>
Affichera soit home, article, categorie, static, archives ou tags.
Exemple avancé
<?php
$var = $plxShow->mode();
if ($var == 'home') {
echo "mode HOME";
}
else{
echo "mode NON HOME";
}
?>
nbAllArt¶
Usage
<?php $plxShow->nbAllArt() ?>
Détails des paramètres
$f1 (string) (optionnel) : format d’affichage si nombre d’article = 0 ; variable possible : #nb pour afficher le nombre d’article ; valeur par défaut “aucun article”
$f2 (string) (optionnel) : format d’affichage si nombre d’article = 1 ; variable possible : #nb pour afficher le nombre d’article ; valeur par défaut “#nb article”
$f2 (string) (optionnel) : format d’affichage si nombre d’article > 1 ; variable possible : #nb pour afficher le nombre d’articles ; valeur par défaut “#nb articles”
Exemples
<?php $plxShow->nbAllArt() ?>
<?php $plxShow->nbAllArt('aucun article','#nb article publié','#nb articles au total') ?>
nbAllCom¶
Usage
<?php $plxShow->nbAllCom('$f1','$f2','$f3') ?>
Détails des paramètres
$f1 (string) (optionnel) : format d’affichage si nombre de commentaire = 0 ; valeur possible : #nb pour afficher le nombre de commentaire
$f2 (string) (optionnel) : format d’affichage si nombre de commentaire = 1 ; valeur possible : #nb pour afficher le nombre de commentaire
$f3 (string) (optionnel) : format d’affichage si nombre de commentaire > 0 ; valeur possible : #nb pour afficher le nombre de commentaire
Exemples
<?php $plxShow->nbAllCom() ?>
<?php $plxShow->nbAllCom('Aucun commentaire', '#nb commentaire', '#nb commentaires au total') ?>
pageBlog¶
Usage
<?php $plxShow->pageBlog('$format') ?>
Détails des paramètres
- $format (string) (optionnel)format du texte pour l’affichage ; valeurs possibles :
page_id : ID de la page
page_status : status de la page
page_url : URL de la page
page_name : nom de la page
Exemples
<?php $plxShow->pageBlog() ?>
<?php $plxShow->pageBlog('<li id="#page_id">
<a class="#page_status" href="#page_url" title="#page_name">#page_name</a></li>') ?>
pageTitle¶
Usage
<?php $plxShow->pageTitle() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->pageTitle() ?>
Note
Cette fonction sert principalement à remplir automatiquement le champ TITLE de la balise <head></head> pour la page courante.
Lors de la rédaction d’un article, vous pouvez personnaliser le contenu de cette balise.
pagination¶
Usage
<?php $plxShow->pagination() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->pagination() ?>
racine¶
Usage
<?php $plxShow->racine() ?>
Détail des paramètres
aucun
Exemple
<?php $plxShow->racine() ?>
Si la « Racine du site » est définie sur http://example.org/, alors cette fonction affichera :
http://example.org/
Si la « Racine du site » est définie sur http://example.org/pluxml/, alors cette fonction affichera :
http://example.org/pluxml/
Exemple avancé
Une alternative à la fonction mainTitle :
<a href="<?php $plxShow->racine() ?>">Mon super site</a>
staticContent¶
Usage
<?php $plxShow->staticContent() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->staticContent() ?>
staticDate¶
Usage
<?php $plxShow->staticDate('$format') ?>
Détails des paramètres
- $format (string) (optionnel)format du texte de la date ; valeurs possibles :
minute : affiche les minutes
hour : affiche l’heure
day : affiche le jour (lundi, mardi, …)
month : affiche le mois (janvier, février, …)
num_day : affiche le numéro du jour (1, 15, 31)
num_month : affiche le numéro du mois (1, 6, 12)
num_year(4) : affiche l’année au format long (ex: 2012)
num_year(2) : affiche l’année au format court (ex: 12)
valeur libre : caractère libre
Exemples
<?php $plxShow->staticDate('#day #num_day #month #num_year(4)') ?>
<?php $plxShow->staticDate('#num_day/#num_month/#num_year(4)') ?>
staticGroup¶
Usage
<?php $plxShow->staticGroup() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->staticGroup() ?>
staticId¶
Usage
<?php $plxShow->staticId() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->staticId() ?>
Exemple avancé
<?php
$var = $plxShow->staticId();
echo $var;
?>
staticInclude¶
Usage
<?php $plxShow->staticInclude($id) ?>
Détails des paramètres
$id (integer) (requis) : ID de la page statique à inclure
Exemple
Pour intégrer le contenu de la page statique ayant pour ID 1 :
<?php $plxShow->staticInclude(1) ?>
staticList¶
Usage
<?php $plxShow->staticList('$extra','$format','$format_group') ?>
Détails des paramètres
$extra (string) (optionnel) : nom du lien vers la page d’accueil
- $format (string) (optionnel)format du texte pour chaque pagevaleurs possibles :
static_id : ID de la page statique
static_status : status de la page statique (active / noactive)
static_url : URL de la page statique
static_name : nom de la page statique
static_class : class (CSS) d’une page statique (valeur : static menu [si la page appartient à un groupe] ou static-group [si la page n’appartient pas à un groupe])
- $format_group (string) (optionnel)format du texte pour chaque groupe de pagesvaleurs possibles :
group_id : ID d’un groupe de pages statiques
group_class : class (CSS) d’un groupe de pages statiques (valeur : static-group)
group_name : nom d’un groupe de pages statiques
Exemples
<?php $plxShow->staticList() ?>
<?php $plxShow->staticList('accueil','<li id="#static_id" class="#static_class">
<a href="#static_url" class="#static_status" title="#static_name">#static_name</a></li>') ?>
<?php $plxShow->staticList('','<li id="#static_id" class="#static_class">
<a href="#static_url" class="#static_status" title="#static_name">#static_name</a></li>'),
'<li id="#group_id" class="#group_class">GROUPE : #group_name</li>') ?>
Note : notez les guillemets simples vides “” pour $extra ; ils sont obligatoires quand on ne veut pas de lien vers la page d’accueil mais qu’on personnalise $format ou $format_group
staticTitle¶
Usage
<?php $plxShow->staticTitle() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->staticTitle() ?>
staticUrl¶
Usage
<?php $plxShow->staticUrl() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->staticUrl() ?>
subTitle¶
Usage
<?php $plxShow->subTitle() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->subTitle() ?>
tagFeed¶
Usage
<?php $plxShow->tagFeed('$type', '$tag', '$format') ?>
Détails des paramètres
$type (string) (OBSOLETE - requis, vide) : type de flux
$tag (string) (optionnel) : le mot clé
- $format (string) (optionnel)format du lien ; valeurs possibles :
feedUrl : url du flux RSS
feedTitle : valeur de la constante L_ARTFEED_RSS_TAG
feedName : valeur de la constante L_ARTFEED_RSS_TAG
Exemple
<?php $plxShow->tagFeed() ?>
<?php $plxShow->tagFeed('','pluxml','<a href="#feedUrl" title="#feedTitle">#feedName</a>') ?>
Note : les guillemets simples sont obligatoires quand on précise l’ID de l’article en raison du paramètre $type obsolète
tagList¶
Usage
<?php $plxShow->tagList('$format', '$max', '$order') ?>
Détails des paramètres
- $format (string) (optionnel)format du texte pour chaque tag ; valeurs possibles :
tag_status : status du tag (active / noactive)
tag_url : URL du tag
tag_name : nom du tag
nb_art : nombre d’article dans ce tag
$max (integer) (optionnel) : nombre max de tags à afficher
$order (string) (optionnel) : tri des tags (random, alpha, “” = tri par popularité)
Exemples
<?php $plxShow->tagList(
'<li><a class="#tag_status" href="#tag_url" title="#tag_name">#tag_name</a></li>') ?>
<?php $plxShow->tagList(
'<li><a class="#tag_status" href="#tag_url" title="#tag_name">#tag_name</a></li>', '10', 'alpha') ?>
tagName¶
Usage
<?php $plxShow->tagName('$type') ?>
Détails des paramètres
$type (string) (optionnel) : type d’affichage, soit sous forme d’un lien soit en texte seul ; valeur possible : “link”
Exemples
<?php $plxShow->tagName() ?>
<?php $plxShow->tagName('link') ?>
Exemple avancé
Pour afficher le nom du tag dans la page tag, dans le fichier /themes/mon-themes/tags.php :
<h2>Tag : <?php $plxShow->tagName() ?></h2>
<#-- la boucle des derniers articles -->
templaceCss¶
Usage
<?php $plxShow->templateCss('$css_dir') ?>
Détails des paramètres
$css_dir (string) (requis) : répertoire de stockage des fichiers css (avec un / à la fin)
Note : manque de précision
Exemple
<?php $plxShow->templateCss() ?>
template¶
Usage
<?php $plxShow->template() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->template() ?>
Exemple avancé
Cet exemple affichera l’image contenue dans /themes/mon-theme/img/image.png :
<img src="<?php $plxShow->template() ?>/img/image.png" />
urlRewrite¶
Usage
<?php $plxShow->urlRewrite('$url') ?>
Détail des paramètres
$url (string) (requis) : url à réécrire
Exemple
<a href="<?php $plxShow->urlRewrite('feed.php?rss') ?>">RSS</a>
version¶
Usage
<?php $plxShow->version() ?>
Détails des paramètres
aucun
Exemple
<?php $plxShow->version() ?>