fil rss }}} Note : vous pouvez faire un lien vers le fil RSS ou Atom d'une catégorie très facilement en ajoutant l'identifiant de la catégorie à l'URL, comme ceci par exemple : {{{ #!php RSS général }}} @param string name Nom de la propriété à afficher ('name') */ function dcInfo($name='name') { switch ($name) { case 'theme' : echo $GLOBALS['theme_uri'].$GLOBALS['__theme']; break; case 'img' : echo $GLOBALS['img_path']; break; case 'url' : echo dc_blog_url; break; case 'rss' : echo dc_blog_rss; break; case 'atom' : echo dc_blog_atom; break; case 'search' : echo dc_blog_url; break; case 'logo' : echo $GLOBALS['img_path'].'/dotclear_pw.png'; break; case 'encoding' : echo dc_encoding; break; case 'lang' : echo dc_default_lang; break; case 'desc' : echo dc_blog_desc; break; default : echo dc_blog_name; } } /** @function dcDayDate Cette fonction affiche la date du jour. Elle est utilisée dans la boucle des billets et n'affiche la date que lors du premier billet du jour. Cela permet d'afficher la date du jour au dessus de plusieurs billets du même jour. On peut entourer la date de marqueur ou de texte grâce à la chaîne de substitution '''s''' passée en argument. Par exemple: {{{ #!php %s'); ?> }}} @param string s Chaine de substition ('%s') */ function dcDayDate($s='%s') { if ($GLOBALS['news']->firstPostOfDay()) { printf($s,$GLOBALS['news']->getLDate()); } } /** @function dcCalendar Cette fonction affiche un calendrier contextuel (mois, année, jour). Le calendrier est un tableau dans une balise
dont la classe CSS|Cascading Style Sheet est ''cal''. Les nom des jours sont indiqués avec des cellules d'en-tête (th) et le titre avec (caption). Exemple d'utilisation : {{{ #!php }}} @param string block Chaine de substitution pour pour le tableau ('
%s
') */ function dcCalendar($block='
%s
') { global $year,$month,$day,$cat_id,$lang; echo $GLOBALS['blog']->xCalendar($year,$month,$day,$cat_id,$lang,$block); } /** @function dcHeadLinks Cette fonction affiche les liens (link) dans l'en-tête du fichier HTML. Elle génère automatiquement les liens de navigation dans le blog. Il suffit de la placer dans l'en-tête du document : {{{ #!php }}} */ function dcHeadLinks() { global $blog, $cat_id, $rs_cat; echo dcPostNext(1,''."\n"); echo dcPostNext(-1,''."\n"); if (!$rs_cat->isEmpty() && !$cat_id) { while (!$rs_cat->EOF()) { if ($rs_cat->f('nb_post') > 0) { $id = $rs_cat->f('cat_libelle_url'); $libelle = $rs_cat->f('cat_libelle'); $lien = sprintf($blog->front_url['cat'],$id); echo ''."\n"; } $rs_cat->moveNext(); } $rs_cat->moveStart(); } $arry_months = $GLOBALS['arry_months']; $comp_url = ''; if ($cat_id) { $comp_url = $cat_id.'/'; } foreach ($arry_months as $ts => $d) { $titre = dt::str('%B %Y',$ts); $url = sprintf($blog->front_url['archive'],$comp_url.date('Y',$ts),date('m',$ts)); echo ''."\n"; } if ($GLOBALS['mode'] == 'home') { echo $GLOBALS['news']->getHeadLinks(); } } /** @function dcSinglePostTitle Cette fonction affiche le titre d'un billet si on est sur une page présentant un billet (/blog/yyyy/mm/dd/titre par exemple). On l'utilisera dans la balise du document. Par exemple: {{{ #!php <title><?php dcSinglePostTitle(); ?> }}} @param string s Chaîne de substitution ('%s - ') */ function dcSinglePostTitle($s='%s - ') { if ($GLOBALS['mode'] == 'post') { printf($s,$GLOBALS['news']->f('post_titre')); } } /** @function dcSingleCatTitle Cette fonction affiche le nom de la catégorie s'il y a lieu de l'afficher. On peut l'utiliser dans le titre, comme '''dcSinglePostTitle'''. @param string s Chaîne de substitution ('%s - ') */ function dcSingleCatTitle($s='%s - ') { if ($GLOBALS['cat_id'] != '') { printf($s,$GLOBALS['news']->f('cat_libelle')); } } /** @function dcSingleMonthTitle Cette fonction affiche le mois et l'année en cours s'il y a lieu de l'afficher. S'utilise aussi dans le titre comme '''dcSinglePostTitle'''. @param string s Chaîne de substitution ('%s - ') */ function dcSingleMonthTitle($s='%s - ') { if ($GLOBALS['mode'] == 'month') { $ts = strtotime($GLOBALS['year'].'-'.$GLOBALS['month'].'-01 00:00'); printf($s,dt::str('%B %Y',$ts)); } } /** @function dcCustomTitle Cette fonction affiche le contenu de la variable globale $dc_custom_title. Cette variable peut-être assignée par un plugin. @param string s Chaîne de substitution ('%s - ') */ function dcCustomTitle($s='%s - ') { if (!empty($GLOBALS['dc_custom_title'])) { printf($s,$GLOBALS['dc_custom_title']); } } /** @doc ==== Exemples d'usage des fonctions pour la balise ==== Voici un exemple de commun de balise <title> à partir des fonctions précédentes : {{{ #!php <title><?php dcSinglePostTitle('%s - '); dcSingleCatTitle('%s - '); dcSingleMonthTitle('%s - '); dcCustomTitle('%s - '); dcInfo(); ?> }}} */ /** @function dcLangList Cette fonction affiche une liste des langues définies dans les billets. Les langues s'affichent uniquement si au moins deux langues différentes existent. Ceci permet d'offrir une navigation par langue dans le weblogue. @param string block Chaine de substitution pour pour la liste ('') @param string item Chaine de substitution pour un élément ('
  • %s
  • ') */ function dcLangList($block='',$item='
  • %s
  • ') { global $rs_lang,$lang,$blog; if ($rs_lang->nbRow() > 1) { $res = ''; while ($rs_lang->fetch()) { $lien = ''. $rs_lang->f(0).''; if ($lang == $rs_lang->f(0)) { $lien = ''.$lien.''; } $res .= sprintf($item,$lien); } printf($block,$res); } } /** @function dcCatList Cette fonction affiche une liste des catégories avec les liens pour y accéder. La liste générée est une liste non ordonnée (