<?php

/**
 * Classe plxShow responsable de l'affichage sur stdout
 *
 * @package PLX
 * @author    Florent MONTHEL, Stephane F, Pedro "P3ter" CADETE
 **/

const PLX_SHOW = true;

class plxShow
{

    public $plxMotor = false; # Objet plxMotor
    private $lang; # fichier de traduction du theme

    private static $instance = null;

    /**
     * Méthode qui se charger de créer le Singleton plxShow
     *
     * @return    self            return une instance de la classe plxShow
     * @author    Stephane F
     **/
    public static function getInstance()
    {
        if (!isset(self::$instance))
            self::$instance = new plxShow();
        return self::$instance;
    }

    /**
     * Constructeur qui initialise l'objet plxMotor par référence
     *
     * @param plxMotor    objet plxMotor passé par référence
     * @return    null
     * @author    Florent MONTHEL
     **/
    protected function __construct()
    {

        $this->plxMotor = plxMotor::getInstance();

        # Chargement du fichier de lang du theme
        $langfile = PLX_ROOT . $this->plxMotor->aConf['racine_themes'] . $this->plxMotor->style . '/lang/' . $this->plxMotor->aConf['default_lang'] . '.php';
        if (is_file($langfile)) {
            include $langfile;
            $this->lang = $LANG; # $LANG = tableau contenant les traductions présentes dans le fichier de langue
        }

        # Hook Plugins
        eval($this->plxMotor->plxPlugins->callHook('plxShowConstruct'));

    }

    /**
     * Méthode qui affiche les urls réécrites
     *
     * @param url            url à réécrire
     * @author    Stéphane F
     **/
    public function urlRewrite($url = '')
    {

        echo $this->plxMotor->urlRewrite($url);
    }

    /**
     * Méthode qui affiche le type de compression http
     *
     * @scope    global
     * @author    Stephane F
     **/
    public function httpEncoding()
    {

        $encoding = plxUtils::httpEncoding();
        if ($this->plxMotor->aConf['gzip'] and $encoding)
            printf(L_HTTPENCODING, strtoupper($encoding));

    }

    /**
     * Méthode qui affiche l'URL du site
     *
     * @scope    global
     * @author    Florent MONTHEL
     **/
    public function racine()
    {

        echo $this->plxMotor->racine;
    }

    /**
     * Méthode qui affiche ou retourne le mode d'affichage
     *
     * @param echo    si à VRAI affichage écran (à FAUX par défaut pour gérer la non régression PluXml < 5.6)
     * @return    string    mode d'affichage (home, article, categorie, static ou erreur)
     * @scope    global
     * @author    Stephane F.
     **/
    public function mode($echo = false)
    {
        if ($echo)
            echo $this->plxMotor->mode;
        else
            return $this->plxMotor->mode;
    }

    /**
     * Méthode qui affiche le charset selon la casse $casse
     *
     * @param casse    casse min ou maj
     * @scope    global
     * @author    Florent MONTHEL
     **/
    public function charset($casse = 'min')
    {

        if ($casse != 'min') # En majuscule
            echo strtoupper(PLX_CHARSET);
        else # En minuscule
            echo strtolower(PLX_CHARSET);
    }

    /**
     * Méthode qui affiche la version de PluXml
     *
     * @scope    global
     * @author    Anthony GUÉRIN et Florent MONTHEL
     **/
    public function version()
    {

        echo PLX_VERSION;
    }

    /**
     * Méthode qui affiche ou renvoie la langue par défaut
     *
     * @param echo        si à VRAI affichage à l'écran
     * @return    stdout/string
     * @author    Stéphane F
     **/
    public function defaultLang($echo = true)
    {
        if ($echo)
            echo $this->plxMotor->aConf['default_lang'];
        else
            return $this->plxMotor->aConf['default_lang'];
    }


    /**
     * Méthode qui affiche la variable get de l'objet plxMotor (variable $_GET globale)
     *
     * @scope    global
     * @author    Florent MONTHEL
     **/
    public function get()
    {

        echo $this->plxMotor->get;
    }

    /**
     * Méthode qui affiche le temps d'exécution de la page
     *
     * @scope    global
     * @author    Anthony GUÉRIN et Florent MONTHEL
     **/
    public function chrono()
    {

        echo round(getMicrotime() - PLX_MICROTIME, 3) . 's';
    }

    /**
     * Méthode qui affiche le dossier de stockage du style actif
     *
     * @scope    global
     * @author    Stephane F
     **/
    public function template()
    {

        echo $this->plxMotor->urlRewrite($this->plxMotor->aConf['racine_themes'] . $this->plxMotor->style);

    }

    /**
     * Méthode qui affiche le titre de la page selon le mode
     *
     * @parm    format        format d'affichage (ex: home=#title - #subtitle;article=#title)
     *                        paramètres: home, categorie, article, static, archives, tags, erreur
     * @parm    sep            caractère de séparation dans le format d'affichage entre les paramètres
     * @scope    global
     * @author    Stéphane F
     **/
    public function pageTitle($format = '', $sep = ";")
    {

        $capture = '';

        # Hook Plugins
        if (eval($this->plxMotor->plxPlugins->callHook('plxShowPageTitle'))) return;

        if ($this->plxMotor->mode == 'home') {
            $title = $this->plxMotor->aConf['title'];
            $subtitle = $this->plxMotor->aConf['description'];
        } elseif ($this->plxMotor->mode == 'categorie') {
            $title_htmltag = $this->plxMotor->aCats[$this->plxMotor->cible]['title_htmltag'];
            $title = $title_htmltag != '' ? $title_htmltag : $this->plxMotor->aCats[$this->plxMotor->cible]['name'];
            $subtitle = $this->plxMotor->aConf['title'];
        } elseif ($this->plxMotor->mode == 'article') {
            $title_htmltag = $this->plxMotor->plxRecord_arts->f('title_htmltag');
            $title = $title_htmltag != '' ? $title_htmltag : $this->plxMotor->plxRecord_arts->f('title');
            $subtitle = $this->plxMotor->aConf['title'];
        } elseif ($this->plxMotor->mode == 'static') {
            $title_htmltag = $this->plxMotor->aStats[$this->plxMotor->cible]['title_htmltag'];
            $title = $title_htmltag != '' ? $title_htmltag : $this->plxMotor->aStats[$this->plxMotor->cible]['name'];
            $subtitle = $this->plxMotor->aConf['title'];
        } elseif ($this->plxMotor->mode == 'archives') {
            preg_match('/^(\d{4})(\d{2})?(\d{2})?/', $this->plxMotor->cible, $capture);
            $year = !empty($capture[1]) ? ' ' . $capture[1] : '';
            $month = !empty($capture[2]) ? ' ' . plxDate::getCalendar('month', $capture[2]) : '';
            $day = !empty($capture[3]) ? ' ' . plxDate::getCalendar('day', $capture[3]) : '';
            $title = L_PAGETITLE_ARCHIVES . $day . $month . $year;
            $subtitle = $this->plxMotor->aConf['title'];
        } elseif ($this->plxMotor->mode == 'tags') {
            $title = L_PAGETITLE_TAG . ' ' . $this->plxMotor->cibleName;
            $subtitle = $this->plxMotor->aConf['title'];
        } elseif ($this->plxMotor->mode == 'erreur') {
            $title = $this->plxMotor->plxErreur->getMessage();
            $subtitle = $this->plxMotor->aConf['title'];
        } else { # mode par défaut
            $title = $this->plxMotor->aConf['title'];
            $subtitle = $this->plxMotor->aConf['description'];
        }

        $fmt = '';
        if (preg_match('/' . $this->plxMotor->mode . '\s*=\s*(.*?)\s*(' . $sep . '|$)/i', $format, $capture)) {
            $fmt = trim($capture[1]);
        }
        $format = $fmt == '' ? '#title - #subtitle' : $fmt;
        $txt = str_replace('#title', trim($title), $format);
        $txt = str_replace('#subtitle', trim($subtitle), $txt);
        echo plxUtils::strCheck(trim($txt, ' - '));

    }

    /**
     * Méthode qui affiche le meta passé en paramètre
     *
     * @param meta    nom du meta à afficher (description, keywords,author)
     * @scope    global
     * @author    Stéphane F, Pedro "P3ter" CADETE
     **/
    public function meta($meta = '')
    {
        # Hook Plugins
        if (eval($this->plxMotor->plxPlugins->callHook('plxShowMeta'))) return;

        if (!in_array($meta, array('description', 'keywords', 'author')))
            return;

        $meta = strtolower($meta);

        if ($this->plxMotor->mode == 'home') {
            if (!empty($this->plxMotor->aConf['meta_' . $meta]))
                echo "\t" . '<meta name="' . $meta . '" content="' . plxUtils::strCheck($this->plxMotor->aConf['meta_' . $meta]) . '" />' . "\n";
            return;
        }

        if ($this->plxMotor->mode == 'article') {
            if ($meta == 'author')
                echo "\t" . '<meta name="author" content="' . $this->artAuthor(false) . '" />' . "\n";
            else {
                $meta_content = trim($this->plxMotor->plxRecord_arts->f('meta_' . $meta));
                if (!empty($meta_content))
                    echo "\t" . '<meta name="' . $meta . '" content="' . plxUtils::strCheck($meta_content) . '" />' . "\n";
            }
            return;
        }

        if ($this->plxMotor->mode == 'static') {
            if (!empty($this->plxMotor->aStats[$this->plxMotor->cible]['meta_' . $meta]))
                echo "\t" . '<meta name="' . $meta . '" content="' . plxUtils::strCheck($this->plxMotor->aStats[$this->plxMotor->cible]['meta_' . $meta]) . '" />' . "\n";
            return;
        }
        if ($this->plxMotor->mode == 'categorie') {
            if (!empty($this->plxMotor->aCats[$this->plxMotor->cible]['meta_' . $meta]))
                echo "\t" . '<meta name="' . $meta . '" content="' . plxUtils::strCheck($this->plxMotor->aCats[$this->plxMotor->cible]['meta_' . $meta]) . '" />' . "\n";
            return;
        }
    }

    /**
     * Méthode qui affiche le titre du blog linké (variable $type='link') ou non
     *
     * @param type    type d'affichage: texte ou sous forme de lien
     * @scope    global
     * @author    Anthony GUÉRIN, Florent MONTHEL, Stephane F
     **/
    public function mainTitle($type = '')
    {

        $title = plxUtils::strCheck($this->plxMotor->aConf['title']);
        if ($type == 'link') # Type lien
            echo '<a class="maintitle" href="' . $this->plxMotor->urlRewrite() . '" title="' . $title . '">' . $title . '</a>';
        else # Type normal
            echo $title;
    }

    /**
     * Méthode qui affiche le sous-titre du blog
     *
     * @scope    global
     * @author    Anthony GUÉRIN et Florent MONTHEL
     **/
    public function subTitle()
    {

        echo plxUtils::strCheck($this->plxMotor->aConf['description']);
    }

    /**
     * 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.
     *
     * @param string $extra nom du lien vers la page d'accueil
     * @param string $format format du texte pour chaque catégorie (variable : #cat_id, #cat_status, #cat_url, #cat_name, #cat_description, #art_nb)
     * @param string $include liste des n° de catégories à afficher, séparés par un ou plusieurs caractères (exemple: '001 |003 5, 45|50')
     * @param string $exclude liste des catégories à ne pas afficher
     * @scope    global
     * @author    Anthony GUÉRIN, Florent MONTHEL, Stephane F, Jean-Pierre Pourrez "bazooka07"
     **/
    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 = '')
    {
        # Hook Plugins
        if (eval($this->plxMotor->plxPlugins->callHook('plxShowLastCatList'))) return;

        # Si on a la variable extra, on affiche un lien vers la page d'accueil (avec $extra comme nom)
        if (!empty($extra)) {
            echo strtr($format, array(
                '#cat_id' => 'cat-home',
                '#cat_url' => $this->plxMotor->urlRewrite(),
                '#cat_name' => plxUtils::strCheck($extra),
                '#cat_status' => ($this->catId() == 'home') ? 'active' : 'noactive',
                '#art_nb' => '',
            ));
        }

        # On verifie qu'il y a des categories
        if ($this->plxMotor->aCats) {
            $currentCats = $this->catId(true);
            foreach ($this->plxMotor->aCats as $idCatStr => $v) {
                # On vérifie qu'on peut afficher cette catégorie et qu'elle est active
                if (in_array($v['menu'], array('oui', 1)) && $v['active']) {
                    $idCatNum = intval($idCatStr);
                    $pattern = '@\b0*' . $idCatNum . '\b@';
                    if (empty($include) or preg_match($pattern, $include)) {
                        if (empty($exclude) || !preg_match($pattern, $exclude)) {
                            if ($v['articles'] > 0 || $this->plxMotor->aConf['display_empty_cat']) {
                                # on a des articles pour cette catégorie ou on affiche les catégories sans article
                                # On modifie nos motifs
                                echo strtr($format, array(
                                    '#cat_id' => 'cat-' . $idCatNum,
                                    '#cat_url' => $this->plxMotor->urlRewrite('?categorie' . $idCatNum . '/' . $v['url']),
                                    '#cat_name' => plxUtils::strCheck($v['name']),
                                    '#cat_status' => !empty($currentCats) && in_array($idCatStr, $currentCats) ? 'active' : 'noactive',
                                    '#cat_description' => plxUtils::strCheck($v['description']),
                                    '#art_nb' => $v['articles'],
                                ));
                            }
                        }
                    }
                }
            } # Fin du while
        }
    }

    /**
     * Méthode qui retourne les id de catégorie pour la categorie ou l'article en cours
     *
     * @param bool asArray retourne le resultat sous forme d'un tableau de chaines au lieu d'une ".CSV" chaine
     * @return    string or array
     * @scope    home,categorie,article,tags,archives
     * @author    Florent MONTHEL, Jean-Pierre Pourrez "bazooka07"
     **/
    public function catId($asArray = false)
    {

        switch ($this->plxMotor->mode) {
            case 'categorie':
                # On vérifie que la categorie
                if ($asArray) {
                    return isset($this->plxMotor->aCats[$this->plxMotor->cible]) ? array($this->plxMotor->cible) : array('home');
                } else {
                    return isset($this->plxMotor->aCats[$this->plxMotor->cible]) ? $this->plxMotor->cible : 'home';
                }
                break;
            case 'article':
                $artCatsStr = $this->plxMotor->plxRecord_arts->f('categorie');
                if (empty($artCatsStr)) {
                    return $asArray ? array('home') : 'home';
                }
                $aCats = $this->plxMotor->aCats;
                # On vérifie que les categories de l'article existe et sont actives
                $activeCats = array_filter(explode(',', $artCatsStr), function ($idCat) use ($aCats) {
                    return array_key_exists($idCat, $aCats) && in_array($aCats[$idCat]['active'], array('oui', 1));
                });
                # categorie 'home' par défaut si échec
                if (empty($activeCats)) {
                    $aCats = array('home');
                }
                return $asArray ? $activeCats : implode(',', $activeCats);
                break;
            case 'home':
                return $asArray ? array('home') : 'home';
                break;
            default:
                # Pas categorie pour ce mode
                return false;
        }
    }

    /**
     * Méthode qui affiche le contenu de la description d'une catégorie
     *
     * @param format    format du texte à afficher (variable: #cat_description)
     * @scope    categorie
     * @author    Stephane F.
     **/
    public function catDescription($format = '<div class="infos">#cat_description</div>')
    {

        $desc = plxUtils::getValue($this->plxMotor->aCats[$this->plxMotor->cible]['description']);
        if ($this->plxMotor->mode and $desc)
            echo str_replace('#cat_description', $desc, $format);
    }

    /**
     * Méthode qui retourne l'url d'une catégorie
     *
     * @param id            id de la categorie sous la forme numérique ou formatée (ex: 1 ou 001)
     * @return    string
     * @author    Stephane F.
     **/
    public function catUrl($id)
    {

        $id = str_pad($id, 3, '0', STR_PAD_LEFT);
        if (isset($this->plxMotor->aCats[$id])) {
            return $this->plxMotor->urlRewrite('?categorie' . intval($id) . '/' . $this->plxMotor->aCats[$id]['url']);
        }
    }

    /**
     * Méthode qui affiche le nom de la catégorie active (linké ou non)
     *
     * @param type    type d'affichage : link => sous forme de lien
     * @scope    home,categorie,article,tags,archives
     * @author    Florent MONTHEL, Stephane F
     **/
    public function catName($type = '')
    {

        # On va verifier que la categorie existe en mode categorie
        if ($this->plxMotor->mode == 'categorie' and isset($this->plxMotor->aCats[$this->plxMotor->cible])) {
            # On recupere les infos de la categorie
            $id = $this->plxMotor->cible;
            $name = plxUtils::strCheck($this->plxMotor->aCats[$id]['name']);
            $url = $this->catUrl($id);
            # On effectue l'affichage
            if ($type == 'link')
                echo '<a href="' . $url . '" title="' . $name . '">' . $name . '</a>';
            else
                echo $name;
        } # On va verifier que la categorie existe en mode article
        elseif ($this->plxMotor->mode == 'article' and isset($this->plxMotor->aCats[$this->plxMotor->plxRecord_arts->f('categorie')])) {
            # On recupere les infos de la categorie
            $id = $this->plxMotor->plxRecord_arts->f('categorie');
            $name = plxUtils::strCheck($this->plxMotor->aCats[$id]['name']);
            $url = $this->catUrl($id);
            # On effectue l'affichage
            if ($type == 'link')
                echo '<a href="' . $url . '" title="' . $name . '">' . $name . '</a>';
            else
                echo $name;
        } # Mode home
        elseif ($this->plxMotor->mode == 'home') {
            if ($type == 'link')
                echo '<a href="' . $this->plxMotor->urlRewrite() . '" title="' . plxUtils::strCheck($this->plxMotor->aConf['title']) . '">' . L_HOMEPAGE . '</a>';
            else
                echo L_HOMEPAGE;
        } else {
            echo L_UNCLASSIFIED;
        }
    }

    /**
     * Méthode qui affiche l'image d'accroche d'une catégorie
     *
     * @param format    format d'affichage (variables: #img_url, #img_thumb_url, #img_alt, #img_title)
     * @param echo    si à VRAI affichage à l'écran
     * @return    string
     * @scope    home,categorie,article,tags,archives
     * @author    Stephane F, Philippe-M
     **/
    public function catThumbnail($format = '<a href="#img_url"><img class="cat_thumbnail" src="#img_thumb_url" alt="#img_alt" title="#img_title" /></a>', $echo = true)
    {
        $filename = plxUtils::getValue($this->plxMotor->aCats[$this->plxMotor->cible]['thumbnail']);
        if (!empty($filename)) {
            $img_url = $this->plxMotor->urlRewrite($filename);
            $img_thumb = plxUtils::thumbName($filename);
            $result = str_replace(
                array(
                    '#img_url',
                    '#img_thumb_url',
                    '#img_title',
                    '#img_alt'
                ),
                array(
                    $img_url, # #img_url
                    (file_exists(PLX_ROOT . $img_thumb)) ? $this->plxMotor->urlRewrite($img_thumb) : $img_url, # #img_thumb_url
                    plxUtils::strCheck(plxUtils::getValue($this->plxMotor->aCats[$this->plxMotor->cible]['thumbnail_title'])), # #img_title
                    plxUtils::strCheck(plxUtils::getValue($this->plxMotor->aCats[$this->plxMotor->cible]['thumbnail_alt'])) # #img_alt
                ),
                $format
            );

            if ($echo)
                echo $result;
            else
                return $result;
        } elseif (!$echo) {
            return false;
        }
    }

    /**
     * Méthode qui retourne l'identifiant de l'article en question (sans les 0 supplémentaires)
     *
     * @return    int
     * @scope    home,categorie,article,tags,archives
     * @author    Florent MONTHEL
     **/
    public function artId()
    {

        return intval($this->plxMotor->plxRecord_arts->f('numero'));
    }

    /**
     * Méthode qui affiche ou retourne l'url de l'article
     *
     * @param echo    si à VRAI affichage à l'écran
     * @param extra    paramètres supplémentaires pouvant être rajoutés à la fin de l'url de l'atricle
     * @scope    home,categorie,article,tags,archives
     * @author    Florent MONTHEL, Stephane F
     **/
    public function artUrl($echo = true, $extra = '')
    {

        # On affiche l'URL
        $id = intval($this->plxMotor->plxRecord_arts->f('numero'));
        $url = $this->plxMotor->urlRewrite('?article' . $id . '/' . $this->plxMotor->plxRecord_arts->f('url') . $extra);
        if ($echo)
            echo $url;
        else
            return $url;

    }

    /**
     * Méthode qui affiche le titre de l'article linké (variable $type='link') ou non
     *
     * @param type    type d'affichage : link => sous forme de lien
     * @scope    home,categorie,article,tags,archives
     * @author    Anthony GUÉRIN, Florent MONTHEL, Stephane F
     **/
    public function artTitle($type = '')
    {

        if ($type == 'link') { # Type lien
            $id = intval($this->plxMotor->plxRecord_arts->f('numero'));
            $title = plxUtils::strCheck($this->plxMotor->plxRecord_arts->f('title'));
            $url = $this->plxMotor->plxRecord_arts->f('url');
            # On effectue l'affichage
            echo '<a href="' . $this->plxMotor->urlRewrite('?article' . $id . '/' . $url) . '" title="' . $title . '">' . $title . '</a>';
        } else { # Type normal
            echo plxUtils::strCheck($this->plxMotor->plxRecord_arts->f('title'));
        }
    }

    /**
     * Méthode qui affiche l'image d'accroche d'un article avec un lien vers l'article ou vers l'image
     *
     * @param string $format format d'affichage (variables: #img_url, #img_thumb_url, #img_alt, #img_title)
     * @param bool $echo si à VRAI affichage à l'écran
     * @param bool $article si vrai, #img_url pointe sur l'article à la place de l'image
     * @return    bool|string
     * @scope    home,categorie,article,tags,archives
     * @author    Stephane F, Thatoo, J.P. Pourrez (bazooka07))
     **/
    public function artThumbnail($format = '<a href="#img_url"><img class="art_thumbnail" src="#img_thumb_url" alt="#img_alt" title="#img_title" /></a>', $echo = true, $article = false)
    {

        $filename = trim($this->plxMotor->plxRecord_arts->f('thumbnail'));

        if (!empty($filename)) {
            $imgUrl = $this->plxMotor->urlRewrite($filename);
            $imgThumb = plxUtils::thumbName($filename);
        } else {
            $imgUrl = '';
            $echo = false;
        }

        if ($article) {
            $artId = intval($this->plxMotor->plxRecord_arts->f('numero'));
            $artUrl = $this->plxMotor->plxRecord_arts->f('url');
            $url = $this->plxMotor->urlRewrite('?article' . $artId . '/' . $artUrl);
        } else {
            $url = $imgUrl;
        }

        $result = strtr($format, array(
            '#img_url' => $url,
            '#img_thumb_url' => (!empty($imgThumb) and file_exists(PLX_ROOT . $imgThumb)) ? $this->plxMotor->urlRewrite($imgThumb) : $imgUrl,
            '#img_title' => plxUtils::strCheck($this->plxMotor->plxRecord_arts->f('thumbnail_title')),
            '#img_alt' => $this->plxMotor->plxRecord_arts->f('thumbnail_alt')
        ));

        if ($echo)
            echo $result;
        else
            return $result;
    }

    /**
     * Méthode qui affiche ou renvoie l'auteur de l'article
     *
     * @param echo si à VRAI affichage à l'écran
     * @scope    home,categorie,article,tags,archives
     * @author    Anthony GUÉRIN, Florent MONTHEL et Stephane F
     **/
    public function artAuthor($echo = true)
    {

        if (isset($this->plxMotor->aUsers[$this->plxMotor->plxRecord_arts->f('author')]['name']))
            $author = plxUtils::strCheck($this->plxMotor->aUsers[$this->plxMotor->plxRecord_arts->f('author')]['name']);
        else
            $author = L_ARTAUTHOR_UNKNOWN;
        if ($echo)
            echo $author;
        else
            return $author;
    }

    /**
     * Méthode qui affiche l'adresse email de l'auteur de l'article
     *
     * @scope    home,categorie,article,tags,archives
     * @author    Stephane F
     **/
    public function artAuthorEmail()
    {

        if (isset($this->plxMotor->aUsers[$this->plxMotor->plxRecord_arts->f('author')]['email']))
            echo plxUtils::strCheck($this->plxMotor->aUsers[$this->plxMotor->plxRecord_arts->f('author')]['email']);
    }

    /**
     * Méthode qui affiche les informations sur l'auteur de l'article
     *
     * @param format    format du texte à afficher (variable: #art_authorinfos, #art_author)
     * @scope    home,categorie,article,tags,archives
     * @author    Stephane F
     **/

    public function artAuthorInfos($format = '<div class="infos">#art_authorinfos</div>')
    {

        $infos = plxUtils::getValue($this->plxMotor->aUsers[$this->plxMotor->plxRecord_arts->f('author')]['infos']);
        if (trim($infos) != '') {
            $txt = str_replace('#art_authorinfos', $infos, $format);
            $txt = str_replace('#art_author', $this->artAuthor(false), $txt);
            echo $txt;
        }
    }

    /**
     * Méthode qui affiche la date de publication de l'article selon le format choisi
     *
     * @param format    format du texte de la date (variable: #minute, #hour, #day, #month, #num_day, #num_day(1), #num_day(2), #num_month, #num_year(4), #num_year(2), #time)
     * @scope    home,categorie,article,tags,archives
     * @author    Stephane F.
     **/
    public function artDate($format = '#day #num_day #month #num_year(4)')
    {

        echo plxDate::formatDate($this->plxMotor->plxRecord_arts->f('date'), $format);
    }

    /**
     * Méthode qui retourne la liste des catégories de l'article séparées par des virgules
     *
     * @return    string
     * @scope    home,categorie,article,tags,archives
     * @author    Stephane F
     **/
    public function artCatIds()
    {

        return $this->plxMotor->plxRecord_arts->f('categorie');
    }

    /**
     * Méthode qui retourne un tableau contenant les numéros des catégories actives de l'article
     *
     * @return    array
     * @scope    home,categorie,article,tags,archives
     * @author    Stephane F
     **/
    public function artActiveCatIds()
    {

        $artCatIds = explode(',', $this->plxMotor->plxRecord_arts->f('categorie'));
        $activeCats = explode('|', $this->plxMotor->activeCats);
        return array_intersect($artCatIds, $activeCats);

    }

    /**
     * Méthode qui affiche la liste des catégories l'article sous forme de lien
     * ou la chaîne de caractère 'Non classé' si la catégorie
     * de l'article n'existe pas
     *
     * @param separator    caractère de séparation entre les catégories affichées
     * @scope    home,categorie,article,tags,archives
     * @author    Anthony GUÉRIN, Florent MONTHEL, Stephane F, J.P. Pourrez "bazooka07"
     **/
    public function artCat($separator = ', ')
    {

        $cats = array();
        foreach ($this->artActiveCatIds() as $idx => $catId) {
            # On valide si la categorie est "home"
            if ($catId == 'home') {
				$href = '';
				$name = L_HOMEPAGE;
				$className = 'active';
                $cats[] = '<a class="active" href="' . $this->plxMotor->urlRewrite() . '" title="' . L_HOMEPAGE . '">' . L_HOMEPAGE . '</a>';
			} elseif(isset($this->plxMotor->aCats[$catId])) {
				# La catégorie existe. On en récupère les infos
				$name = plxUtils::strCheck($this->plxMotor->aCats[$catId]['name']);
				$url = $this->plxMotor->aCats[$catId]['url'];
				$href = '?categorie' . intval($catId) . '/' . $url;
				$active = (
					$this->plxMotor->mode == 'categorie' and
					isset($this->plxMotor->aCats[$this->plxMotor->cible]['url']) and
					$url == $this->plxMotor->aCats[$this->plxMotor->cible]['url']
				);
				$className = $active ? 'active' : 'noactive';
			} else {
				# Rien à faire
				continue;
			}

			# On mémorise pour afficher
			$cats[] = '<a class="' . $className . '" href="' . $this->plxMotor->urlRewrite($href) . '" title="' . $name . '">' . $name . '</a>';
        }

        # si $cats est vide, on n'a trouvé aucune catégorie valide
        echo !empty($cats) ? implode($separator, $cats) : L_UNCLASSIFIED;
    }

    /**
     * Méthode qui affiche la liste des tags l'article sous forme de lien
     *
     * @param format    format du texte pour chaque tag (variable : #tag_status, #tag_url, #tag_name)
     * @param separator    caractère de séparation entre les tags affichées
     * @scope    home,categorie,article,tags,archives
     * @author    Stephane F
     **/
    public function artTags($format = '<a class="#tag_status" href="#tag_url" title="#tag_name">#tag_name</a>', $separator = ',')
    {
        # Hook Plugins
        if (eval($this->plxMotor->plxPlugins->callHook('plxShowArtTags'))) return;

        # Initialisation de notre variable interne
        $taglist = $this->plxMotor->plxRecord_arts->f('tags');
        if (!empty($taglist)) {
            $tags = array_map('trim', explode(',', $taglist));
            foreach ($tags as $idx => $tag) {
                $t = plxUtils::urlify($tag);
                $name = str_replace('#tag_url', $this->plxMotor->urlRewrite('?tag/' . $t), $format);
                $name = str_replace('#tag_name', plxUtils::strCheck($tag), $name);
                $name = str_replace('#tag_status', (($this->plxMotor->mode == 'tags' and $this->plxMotor->cible == $t) ? 'active' : 'noactive'), $name);
                echo $name;
                if ($idx != sizeof($tags) - 1) echo $separator . ' ';
            }
        } else echo L_ARTTAGS_NONE;
    }

    /**
     * Méthode qui affiche le lien "Lire la suite" si le chapô de l'article est renseigné
     *
     * @param format    format d'affichage du lien pour lire la suite de l'article (#art_url, #art_title)
     * @scope    home,categorie,tags,archives
     * @author    Stephane F
     **/
    public function artReadMore($format = '')
    {

        # Affichage du lien "Lire la suite" si un chapo existe
        if ($this->plxMotor->plxRecord_arts->f('chapo') != '') {
            $format = ($format == '' ? '<p class="more"><a href="#art_url" title="#art_title">' . L_ARTCHAPO . '</a></p>' : $format);
            if ($format) {
                # On recupere les infos de l'article
                $id = intval($this->plxMotor->plxRecord_arts->f('numero'));
                $title = plxUtils::strCheck($this->plxMotor->plxRecord_arts->f('title'));
                $url = $this->plxMotor->plxRecord_arts->f('url');
                # Formatage de l'affichage
                $row = str_replace("#art_url", $this->plxMotor->urlRewrite('?article' . $id . '/' . $url), $format);
                $row = str_replace("#art_title", $title, $row);
                echo $row;
            }
        }
    }

    /**
     * Méthode qui affiche le châpo de l'article ainsi qu'un lien
     * pour lire la suite de l'article. Si l'article n'a pas de chapô,
     * le contenu de l'article est affiché (selon paramètres)
     *
     * @param format    format d'affichage du lien pour lire la suite de l'article (#art_title)
     * @param content    affichage oui/non du contenu si le chapô est vide
     * @param anchor    ancre dans l'article pour faire pointer le lien "Lire la suite" quand on clic dessus
     * @scope    home,categorie,article,tags,archives
     * @author    Anthony GUÉRIN, Florent MONTHEL, Stephane F
     **/
    public function artChapo($format = L_ARTCHAPO, $content = true, $anchor = '')
    {

        # On verifie qu'un chapo existe
        if ($this->plxMotor->plxRecord_arts->f('chapo') != '') {
            # On récupère les infos de l'article
            $id = intval($this->plxMotor->plxRecord_arts->f('numero'));
            $title = plxUtils::strCheck($this->plxMotor->plxRecord_arts->f('title'));
            $url = $this->plxMotor->plxRecord_arts->f('url');
            # On effectue l'affichage
            echo $this->plxMotor->plxRecord_arts->f('chapo') . "\n";
            if ($format) {
                $title = str_replace("#art_title", $title, $format);
                echo '<p class="more"><a href="' . $this->plxMotor->urlRewrite('?article' . $id . '/' . $url) . ($anchor != '' ? '#' . $anchor : '') . '" title="' . $title . '">' . $title . '</a></p>' . "\n";
            }
        } else { # Pas de chapo, affichage du contenu
            if ($content === true) {
                echo $this->plxMotor->plxRecord_arts->f('content') . "\n";
            }
        }
    }

    /**
     * Méthode qui affiche le chapô (selon paramètres) suivi du contenu de l'article
     *
     * @param chapo    affichage oui/non du chapo
     * @scope    home,categorie,article,tags,archives
     * @author    Anthony GUÉRIN, Florent MONTHEL et Stephane F
     **/
    public function artContent($chapo = true)
    {

        if ($chapo === true)
            echo $this->plxMotor->plxRecord_arts->f('chapo') . "\n"; # Chapo
        echo $this->plxMotor->plxRecord_arts->f('content') . "\n";

    }

    /**
     * Méthode qui affiche la date de creation d'un article selon le format choisi
     *
     * @param format    format du texte de la date (variable: #minute, #hour, #day, #month, #num_day, #num_day(1), #num_day(2), #num_month, #num_year(4), #num_year(2), #time)
     * @scope    home,categorie,article,tags,archives
     * @author    Stephane F.
     **/
    public function artCreationDate($format = '#num_day/#num_month/#num_year(4) #time')
    {

        echo plxDate::formatDate($this->plxMotor->plxRecord_arts->f('date_creation'), $format);
    }

    /**
     * Méthode qui affiche la date de mise à jour d'un article selon le format choisi
     *
     * @param format    format du texte de la date (variable: #minute, #hour, #day, #month, #num_day, #num_day(1), #num_day(2), #num_month, #num_year(4), #num_year(2), #time)
     * @scope    home,categorie,article,tags,archives
     * @author    Stephane F.
     **/
    public function artUpdateDate($format = '#num_day/#num_month/#num_year(4) #time')
    {

        echo plxDate::formatDate($this->plxMotor->plxRecord_arts->f('date_update'), $format);
    }

    /**
     * Méthode qui affiche un lien vers le fil Rss des articles
     * d'une catégorie précise (si $categorie renseigné) ou du site tout entier
     *
     * @param type        type de flux (obsolete)
     * @param categorie    identifiant (sans les 0) d'une catégorie
     * @param format        format du code HTML pour l'affichage du lien (variable : #feedUrl, #feedTitle, #feedName)
     * @scope    home,categorie,article,tags,archives
     * @author    Florent MONTHEL, Stephane F, Pedro "P3ter" CADETE
     **/
    public function artFeed($type = 'rss', $categorie = '', $format = '<a href="#feedUrl" title="#feedTitle">#feedName</a>')
    {
        # Hook Plugins
        if (eval($this->plxMotor->plxPlugins->callHook('plxShowArtFeed')))
            return;

        if ($this->plxMotor->aConf ['enable_rss']) {
            if ($categorie != '' and is_numeric($categorie)) {
                # Fil Rss des articles d'une catégorie
                $id = str_pad($categorie, 3, '0', STR_PAD_LEFT);
                if (isset ($this->plxMotor->aCats [$id])) {
                    $result = str_replace('#feedUrl', $this->plxMotor->urlRewrite('feed.php?rss/categorie' . $categorie . '/' . $this->plxMotor->aCats[$id]['url']), $format);
                    $result = str_replace('#feedTitle', L_ARTFEED_RSS_CATEGORY, $result);
                    $result = str_replace('#feedName', L_ARTFEED_RSS_CATEGORY, $result);
                }
            } else {
                # Fil Rss des articles
                $result = str_replace('#feedUrl', $this->plxMotor->urlRewrite('feed.php?rss'), $format);
                $result = str_replace('#feedTitle', L_ARTFEED_RSS, $result);
                $result = str_replace('#feedName', L_ARTFEED_RSS, $result);
            }
            echo $result;
        }
    }

    /**
     * Méthode qui affiche le nombre de commentaires (sous forme de lien ou non selon le mode) d'un article
     *
     * @param f1        format d'affichage si nombre de commentaire = 0 (#nb pour afficher le nombre de commentaire)
     * @param f2        format d'affichage si nombre de commentaire = 1 (#nb pour afficher le nombre de commentaire)
     * @param f3        format d'affichage si nombre de commentaire > 1 (#nb pour afficher le nombre de commentaire)
     * @scope    home,categorie,article,tags,archives
     * @author    Stephane F
     **/
    public function artNbCom($f1 = 'L_NO_COMMENT', $f2 = '#nb L_COMMENT', $f3 = '#nb L_COMMENTS')
    {

        $nb = intval($this->plxMotor->plxRecord_arts->f('nb_com'));
        $num = intval($this->plxMotor->plxRecord_arts->f('numero'));
        $url = $this->plxMotor->plxRecord_arts->f('url');

        if ($nb == 0) {
            $txt = str_replace('L_NO_COMMENT', L_NO_COMMENT, $f1);
            $title = $nb . ' ' . L_NO_COMMENT;
        } elseif ($nb == 1) {
            $txt = str_replace('L_COMMENT', L_COMMENT, $f2);
            $title = $nb . ' ' . L_COMMENT;
        } else {
            $txt = str_replace('L_COMMENTS', L_COMMENTS, $f3);
            $title = $nb . ' ' . L_COMMENTS;
        }
        $txt = str_replace('#nb', $nb, $txt);

        if ($this->plxMotor->mode == 'article')
            echo $txt;
        else
            echo '<a href="' . $this->plxMotor->urlRewrite('?article' . $num . '/' . $url) . '#comments" title="' . $title . '">' . $txt . '</a>';

    }

    /**
     * Méthode qui affiche le nombre total d'articles publiés sur le site.
     *
     * @param f1        format d'affichage si nombre d'article = 0 (#nb pour afficher le nombre de commentaire)
     * @param f2        format d'affichage si nombre d'article = 1 (#nb pour afficher le nombre de commentaire)
     * @param f3        format d'affichage si nombre d'article > 1 (#nb pour afficher le nombre de commentaire)
     * @scope    global
     * @author    Stephane F
     **/
    public function nbAllArt($f1 = 'L_NO_ARTICLE', $f2 = '#nb L_ARTICLE', $f3 = '#nb L_ARTICLES')
    {

        $nb = $this->plxMotor->nbArticles('published', '[0-9]{3}', '', 'before');

        if ($nb == 0)
            $txt = str_replace('L_NO_ARTICLE', L_NO_ARTICLE, $f1);
        elseif ($nb == 1)
            $txt = str_replace('L_ARTICLE', L_ARTICLE, $f2);
        else
            $txt = str_replace('L_ARTICLES', L_ARTICLES, $f3);

        $txt = str_replace('#nb', $nb, $txt);

        echo $txt;
    }

    /**
     * Méthode qui affiche la liste des $max derniers articles.
     * Si la variable $cat_id est renseignée, seuls les articles de cette catégorie sont retournés.
     * On tient compte si la catégorie est active
     *
     * @param format    format du texte pour chaque article
     * @param max        nombre d'articles maximum
     * @param cat_id    ids des catégories cible (numérique ou urls) : séparés par des |
     * @param ending    texte à ajouter en fin de ligne
     * @param sort    tri de l'affichage des articles (sort|rsort|alpha|random)
     * @scope    global
     * @author    Florent MONTHEL, Stephane F, Cyril MAGUIRE, Thomas Ingles
     **/
    public function lastArtList($format = '', $max = 5, $cat_id = '', $ending = '', $sort = 'rsort')
    {

        $capture = '';

        $format = empty($format) ? '<li><a href="#art_url" title="#art_title">#art_title</a></li>' : $format; # V5.8 format par defaut si vide

        # Hook Plugins
        if (eval($this->plxMotor->plxPlugins->callHook('plxShowLastArtList'))) return;

        # Génération de notre motif
        $all = (isset($all) ? $all : empty($cat_id)); # pour le hook : si $all = TRUE, n'y passe pas
        $cats = $this->plxMotor->activeCats . '|home'; # toutes les categories active
        if (!$all) {
            if (is_numeric($cat_id)) # inclusion à partir de l'id de la categorie
                $cats = str_pad($cat_id, 3, '0', STR_PAD_LEFT);
            else { # inclusion à partir de url de la categorie
                $cat_id .= '|';
                foreach ($this->plxMotor->aCats as $key => $value) {
                    if (strpos($cat_id, $value['url'] . '|') !== false) {
                        $cats = explode('|', $cat_id);
                        if (in_array($value['url'], $cats)) {
                            $cat_id = str_replace($value['url'] . '|', $key . '|', $cat_id);
                        }
                    }
                }
                $cat_id = substr($cat_id, 0, -1);
                if (empty($cat_id)) {
                    $all = true;
                } else {
                    $cats = $cat_id;
                }
            }
        }
        if (empty($motif)) {# pour le hook. motif par defaut s'il n'a point créé cette variable
            if ($all)
                $motif = '/^[0-9]{4}.(?:[0-9]|home|,)*(?:' . $cats . ')(?:[0-9]|home|,)*.[0-9]{3}.[0-9]{12}.[a-z0-9-]+.xml$/';
            else
                $motif = '/^[0-9]{4}.((?:[0-9]|home|,)*(?:' . $cats . ')(?:[0-9]|home|,)*).[0-9]{3}.[0-9]{12}.[a-z0-9-]+.xml$/';
        }

        # Nouvel objet plxGlob et récupération des fichiers
        $plxGlob_arts = clone $this->plxMotor->plxGlob_arts;
        if ($aFiles = $plxGlob_arts->query($motif, 'art', $sort, 0, $max, 'before')) {
            foreach ($aFiles as $v) { # On parcourt tous les fichiers
                $art = $this->plxMotor->parseArticle(PLX_ROOT . $this->plxMotor->aConf['racine_articles'] . $v);
                $num = intval($art['numero']);
                $date = $art['date'];
                if (($this->plxMotor->mode == 'article') and ($art['numero'] == $this->plxMotor->cible))
                    $status = 'active';
                else
                    $status = 'noactive';

                # Mise en forme de la liste des catégories
                $catList = array();
                $catIds = explode(',', $art['categorie']);
                foreach ($catIds as $idx => $catId) {
                    if (isset($this->plxMotor->aCats[$catId])) { # La catégorie existe
                        $catName = plxUtils::strCheck($this->plxMotor->aCats[$catId]['name']);
                        $catUrl = $this->plxMotor->aCats[$catId]['url'];
                        $catList[] = '<a title="' . $catName . '" href="' . $this->plxMotor->urlRewrite('?categorie' . intval($catId) . '/' . $catUrl) . '">' . $catName . '</a>';
                    } else {
                        $catList[] = L_UNCLASSIFIED;
                    }
                }

                # On modifie nos motifs
                $row = str_replace('#art_id', $num, $format);
                $row = str_replace('#cat_list', implode(', ', $catList), $row);
                $row = str_replace('#art_url', $this->plxMotor->urlRewrite('?article' . $num . '/' . $art['url']), $row);
                $row = str_replace('#art_status', $status, $row);
                $author = plxUtils::getValue($this->plxMotor->aUsers[$art['author']]['name']);
                $row = str_replace('#art_author', plxUtils::strCheck($author), $row);
                $row = str_replace('#art_title', plxUtils::strCheck($art['title']), $row);
                $strlength = preg_match('/#art_chapo\(([0-9]+)\)/', $row, $capture) ? $capture[1] : '100';
                $chapo = plxUtils::truncate($art['chapo'], $strlength, $ending, true, true);
                $row = str_replace('#art_chapo(' . $strlength . ')', '#art_chapo', $row);
                $row = str_replace('#art_chapo', $chapo, $row);
                $strlength = preg_match('/#art_content\(([0-9]+)\)/', $row, $capture) ? $capture[1] : '100';
                $content = plxUtils::truncate($art['content'], $strlength, $ending, true, true);
                $row = str_replace('#art_content(' . $strlength . ')', '#art_content', $row);
                $row = str_replace('#art_content', $content, $row);
                $row = str_replace('#art_date', plxDate::formatDate($date, '#num_day/#num_month/#num_year(4)'), $row);
                $row = str_replace('#art_hour', plxDate::formatDate($date, '#hour:#minute'), $row);
                $row = str_replace('#art_time', plxDate::formatDate($date, '#time'), $row);
                $row = plxDate::formatDate($date, $row);
                $row = str_replace('#art_nbcoms', $art['nb_com'], $row);
                $row = str_replace('#art_thumbnail', '<img class="art_thumbnail" src="#img_url" alt="#img_alt" title="#img_title" />', $row);
                $row = str_replace('#img_url', $this->plxMotor->urlRewrite($art['thumbnail']), $row);
                $row = str_replace('#img_title', $art['thumbnail_title'], $row);
                $row = str_replace('#img_alt', $art['thumbnail_alt'], $row);

                # Hook plugin
                eval($this->plxMotor->plxPlugins->callHook('plxShowLastArtListContent'));

                # On genère notre ligne
                echo $row;
            }
        }
    }

    /**
     * Méthode qui affiche l'id du commentaire précédé de la lettre 'c'
     *
     * @param echo        (boolean) fait un affichage si valeur à TRUE
     * @return    stdout/id    sortie stdout ou retourne l'id du commentaire
     * @scope    article
     * @author    Florent MONTHEL
     **/
    public function comId($echo = true)
    {
        $id = 'c' . $this->plxMotor->plxRecord_coms->f('article') . '-' . $this->plxMotor->plxRecord_coms->f('index');
        if ($echo)
            echo $id;
        else
            return $id;
    }

    /**
     * Méthode qui affiche l'url du commentaire de type relatif ou absolu
     *
     * @param type    type de lien : relatif ou absolu (URL complète) DEPRECATED
     * @scope    article
     * @author    Florent MONTHEL, Stephane F
     **/
    public function comUrl($type = 'relatif')
    {

        # On affiche l'URL
        $artId = $this->plxMotor->plxRecord_coms->f('article');
        $artInfo = $this->plxMotor->artInfoFromFilename($this->plxMotor->plxGlob_arts->aFiles[$artId]);
        echo $this->urlRewrite('?article' . intval($artId) . '/' . $artInfo['artUrl'] . '#' . $this->ComId(false));
    }

    /**
     * Méthode qui affiche l'index d'un commentaire
     *
     * @scope    article
     * @author    Stephane F.
     **/
    public function comIndex()
    {

        echo $this->plxMotor->plxRecord_coms->f('index');
    }

    /**
     * Get comment indent number
     * @return    integer        level number for comment indentation
     * @author    Stephane F.
     **/
    public function comNumLevel()
    {
        return $this->plxMotor->plxRecord_coms->f('level');
    }

    /**
     * Add CSS class fort comments indentation
     * @param class    css class used to indent comments
     * @author    Stephane F., Jerry Wham, Pedro "P3ter" CADETE
     **/
    public function comLevel($class = 'level')
    {
        $numLevel = $this->comNumLevel();
        if ($numLevel > 5)
            echo $class . '-' . $numLevel . ' ' . $class . '-max';
        else
            echo $class . '-' . $numLevel;
    }

    /**
     * Méthode qui affiche le nombre total de commentaires publiés sur le site.
     *
     * @param f1        format d'affichage si nombre de commentaire = 0 (#nb pour afficher le nombre de commentaire)
     * @param f2        format d'affichage si nombre de commentaire = 1 (#nb pour afficher le nombre de commentaire)
     * @param f3        format d'affichage si nombre de commentaire > 1 (#nb pour afficher le nombre de commentaire)
     * @scope    global
     * @author    Stephane F
     **/
    public function nbAllCom($f1 = 'L_NO_COMMENT', $f2 = '#nb L_COMMENT', $f3 = '#nb L_COMMENTS')
    {

        $nb = $this->plxMotor->nbComments('online', 'before');

        if ($nb == 0)
            $txt = str_replace('L_NO_COMMENT', L_NO_COMMENT, $f1);
        elseif ($nb == 1)
            $txt = str_replace('L_COMMENT', L_COMMENT, $f2);
        else
            $txt = str_replace('L_COMMENTS', L_COMMENTS, $f3);

        $txt = str_replace('#nb', $nb, $txt);

        echo $txt;
    }

    /**
     * Méthode qui affiche l'auteur du commentaires linké ou non
     *
     * @param type    type d'affichage : link => sous forme de lien
     * @scope    article
     * @author    Anthony GUÉRIN, Florent MONTHEL et Stephane F.
     **/
    public function comAuthor($type = '')
    {

        # Initialisation de nos variables interne
        $author = $this->plxMotor->plxRecord_coms->f('author');
        $site = $this->plxMotor->plxRecord_coms->f('site');
        if ($type == 'link' and $site != '') # Type lien
            echo '<a rel="nofollow" href="' . $site . '" title="' . $author . '">' . $author . '</a>';
        else # Type normal
            echo $author;
    }

    /**
     * Méthode qui affiche le type du commentaire (admin ou normal)
     *
     * @scope    article
     * @author    Florent MONTHEL
     **/
    public function comType()
    {

        echo $this->plxMotor->plxRecord_coms->f('type');
    }

    /**
     * Méthode qui affiche la date de publication d'un commentaire selon le format choisi
     *
     * @param format    format du texte de la date (variable: #minute, #hour, #day, #month, #num_day, #num_day(1), #num_day(2), #num_month, #num_year(2), #num_year(4), #time)
     * @scope    article
     * @author    Florent MONTHEL et Stephane F
     **/
    public function comDate($format = '#day #num_day #month #num_year(4) @ #time')
    {

        echo plxDate::formatDate($this->plxMotor->plxRecord_coms->f('date'), $format);
    }

    /**
     * Méthode qui affiche le contenu d'un commentaire
     *
     * @scope    article
     * @author    Florent MONTHEL
     **/
    public function comContent()
    {

        echo nl2br($this->plxMotor->plxRecord_coms->f('content'));
    }

    /**
     * Méthode qui affiche si besoin le message généré par le système
     * suite à la création d'un commentaire
     * @param format  format du texte à afficher (variable: #com_message, #com_class)
     * @return        true si un message est affiché
     * @scope        article
     * @author        Stephane F, J.P Pourrez.
     * @version        2017-12-28
     **/
    public function comMessage($format = '<p id="com_message" class="#com_class"><strong>#com_message</strong></p>')
    {

        if (!empty($_SESSION['msgcom'])) {
            switch ($_SESSION['msgcom']) {
                case L_COM_IN_MODERATION:
                    $color = 'orange';
                    break;
                case L_COM_PUBLISHED:
                    $color = 'green';
                    break;
                default:
                    $color = 'red';
            }
            $row = str_replace('#com_message', $_SESSION['msgcom'], $format);
            $row = str_replace('#com_class', 'alert ' . $color, $row);
            echo $row;
            unset($_SESSION['msgcom']);
            return true;
        }
        return false;
    }

    /**
     * Méthode qui affiche si besoin la variable $_GET[$key] suite au dépôt d'un commentaire
     *
     * @param key        clé du tableau GET
     * @param defaut    valeur par défaut si variable vide
     * @scope    article
     * @author    Florent MONTHEL
     **/
    public function comGet($key, $defaut = '')
    {

        if (isset($_SESSION['msg'][$key]) and !empty($_SESSION['msg'][$key])) {
            echo plxUtils::strCheck($_SESSION['msg'][$key]);
            $_SESSION['msg'][$key] = '';
        } else echo $defaut;

    }

    /**
     * Méthode qui affiche un lien vers le fil Rss des commentaires
     * d'un article précis (si $article renseigné) ou du site tout entier
     *
     * @param type        type de flux (obsolete)
     * @param article        identifiant (sans les 0) d'un article
     * @param format        format du code HTML pour l'affichage du lien (variable : #feedUrl, #feedTitle, #feedName)
     * @scope    global
     * @author    Anthony GUÉRIN, Florent MONTHEL, Stephane F, Pedro "P3ter" CADETE
     **/
    public function comFeed($type = 'rss', $article = '', $format = '<a href="#feedUrl" title="#feedTitle">#feedName</a>')
    {
        # Hook Plugins
        if (eval ($this->plxMotor->plxPlugins->callHook('plxShowComFeed')))
            return;

        if ($this->plxMotor->aConf ['enable_rss_comment']) {
            if ($article != '' and is_numeric($article)) { # Fil Rss des commentaires d'un article
                $result = str_replace('#feedUrl', $this->plxMotor->urlRewrite('feed.php?rss/commentaires/article' . $article), $format);
                $result = str_replace('#feedTitle', L_COMFEED_RSS_ARTICLE, $result);
                $result = str_replace('#feedName', L_COMFEED_RSS_ARTICLE, $result);
            } else { # Fil Rss des commentaires global
                $result = str_replace('#feedUrl', $this->plxMotor->urlRewrite('feed.php?rss/commentaires'), $format);
                $result = str_replace('#feedTitle', L_COMFEED_RSS, $result);
                $result = str_replace('#feedName', L_COMFEED_RSS, $result);
            }
            echo $result;
        }
    }

    /**
     * Méthode qui affiche la liste des $max derniers commentaires.
     * Si la variable $art_id est renseignée, seuls les commentaires de cet article sont retournés.
     *
     * @param format    format du texte pour chaque commentaire
     * @param max        nombre de commentaires maximum
     * @param art_id    id de l'article cible (24,3)
     * @param cat_ids    liste des categories pour filtrer les derniers commentaires (sous la forme 001|002)
     * @scope    global
     * @author    Florent MONTHEL, Stephane F
     **/
    public function lastComList($format = '<li><a href="#com_url">#com_author L_SAID :</a><br/>#com_content(50)</li>', $max = 5, $art_id = '', $cat_ids = '')
    {

        $capture = '';

        # Hook Plugins
        if (eval($this->plxMotor->plxPlugins->callHook('plxShowLastComList'))) return;

        # Génération de notre motif
        if (empty($art_id))
            $motif = '/^[0-9]{4}.[0-9]{10}-[0-9]+.xml$/';
        else
            $motif = '/^' . str_pad($art_id, 4, '0', STR_PAD_LEFT) . '.[0-9]{10}-[0-9]+.xml$/';

        $count = 1;
        $datetime = date('YmdHi');
        # Nouvel objet plxGlob et récupération des fichiers
        $plxGlob_coms = clone $this->plxMotor->plxGlob_coms;
        if ($aFiles = $plxGlob_coms->query($motif, 'com', 'rsort', 0, false, 'before')) {
            $aComArtTitles = array(); # tableau contenant les titres des articles
            $isComArtTitle = (strpos($format, '#com_art_title') != FALSE) ? true : false;
            # On parcourt les fichiers des commentaires
            foreach ($aFiles as $v) {
                # On filtre si le commentaire appartient à un article d'une catégorie inactive
                if (isset($this->plxMotor->activeArts[substr($v, 0, 4)])) {
                    $com = $this->plxMotor->parseCommentaire(PLX_ROOT . $this->plxMotor->aConf['racine_commentaires'] . $v);
                    $artInfo = $this->plxMotor->artInfoFromFilename($this->plxMotor->plxGlob_arts->aFiles[$com['article']]);
                    if ($artInfo['artDate'] <= $datetime) { # on ne prends que les commentaires pour les articles publiés
                        if (empty($cat_ids) or preg_match('/(' . $cat_ids . ')/', $artInfo['catId'])) {
                            $url = '?article' . intval($com['article']) . '/' . $artInfo['artUrl'] . '#c' . $com['article'] . '-' . $com['index'];
                            $date = $com['date'];
                            $content = strip_tags($com['content']);
                            # On modifie nos motifs
                            $row = str_replace('L_SAID', L_SAID, $format);
                            $row = str_replace('#com_id', $com['index'], $row);
                            $row = str_replace('#com_url', $this->plxMotor->urlRewrite($url), $row);
                            $row = str_replace('#com_author', $com['author'], $row);
                            while (preg_match('/#com_content\(([0-9]+)\)/', $row, $capture)) {
                                if ($com['author'] == 'admin')
                                    $row = str_replace('#com_content(' . $capture[1] . ')', plxUtils::strCut($content, $capture[1]), $row);
                                else
                                    $row = str_replace('#com_content(' . $capture[1] . ')', plxUtils::strCheck(plxUtils::strCut(plxUtils::strRevCheck($content), $capture[1])), $row);
                            }
                            $row = str_replace('#com_content', $content, $row);
                            $row = str_replace('#com_date', plxDate::formatDate($date, '#num_day/#num_month/#num_year(4)'), $row);
                            $row = str_replace('#com_hour', plxDate::formatDate($date, '#time'), $row);
                            $row = plxDate::formatDate($date, $row);
                            # récupération du titre de l'article
                            if ($isComArtTitle) {
                                if (isset($aComArtTitles[$com['article']])) {
                                    $row = str_replace('#com_art_title', $aComArtTitles[$com['article']], $row);
                                } else {
                                    if ($file = $this->plxMotor->plxGlob_arts->query('/^' . $com['article'] . '.(.*).xml$/')) {
                                        $art = $this->plxMotor->parseArticle(PLX_ROOT . $this->plxMotor->aConf['racine_articles'] . $file[0]);
                                        $aComArtTitles[$com['article']] = $art_title = $art['title'];
                                        $row = str_replace('#com_art_title', $art_title, $row);
                                    }
                                }
                            }
                            # On genère notre ligne
                            echo $row;
                            $count++;
                        }
                    }
                }
                if ($count > $max) break;
            }
        }
    }

    /**
     * Méthode qui affiche la liste des pages statiques.
     *
     * @param extra            si renseigné: nom du lien vers la page d'accueil affiché en première position
     * @param format            format du texte pour chaque page (variable : #static_id, #static_status, #static_url, #static_name, #group_id, #group_class, #group_name)
     * @param format_group    format du texte pour chaque groupe (variable : #group_class, #group_name, #group_status)
     * @param menublog        position du menu Blog (si non renseigné le menu n'est pas affiché)
     * @scope    global
     * @author    Stephane F
     **/
    public function staticList($extra = '', $format = '<li class="#static_class #static_status" id="#static_id"><a href="#static_url" title="#static_name">#static_name</a></li>', $format_group = '<span class="#group_class #group_status">#group_name</span>', $menublog = false)
    {

        $menus = array();
        # Hook Plugins
        if (eval($this->plxMotor->plxPlugins->callHook('plxShowStaticListBegin'))) return;
        $home = ((empty($this->plxMotor->get) or preg_match('/^page[0-9]*/', $this->plxMotor->get)) and basename($_SERVER['SCRIPT_NAME']) == "index.php");
        # Si on a la variable extra, on affiche un lien vers la page d'accueil (avec $extra comme nom)
        if ($extra != '') {
            $stat = str_replace('#static_id', 'static-home', $format);
            $stat = str_replace('#static_class', 'static menu', $stat);
            $stat = str_replace('#static_url', $this->plxMotor->urlRewrite(), $stat);
            $stat = str_replace('#static_name', plxUtils::strCheck($extra), $stat);
            $stat = str_replace('#static_status', ($home == true ? "active" : "noactive"), $stat);
            $menus[][] = $stat;
        }
        $group_active = "";
        if ($this->plxMotor->aStats) {
            foreach ($this->plxMotor->aStats as $k => $v) {
                if ($v['active'] == 1 and $v['menu'] == 'oui') { # La page  est bien active et dispo ds le menu
                    $stat = str_replace('#static_id', 'static-' . intval($k), $format);
                    $stat = str_replace('#static_class', 'static menu', $stat);
                    if ($v['url'][0] == '?') # url interne commençant par ?
                        $stat = str_replace('#static_url', $this->plxMotor->urlRewrite($v['url']), $stat);
                    elseif (plxUtils::checkSite($v['url'], false)) # url externe en http ou autre
                        $stat = str_replace('#static_url', $v['url'], $stat);
                    else # url page statique
                        $stat = str_replace('#static_url', $this->plxMotor->urlRewrite('?static' . intval($k) . '/' . $v['url']), $stat);
                    $stat = str_replace('#static_name', plxUtils::strCheck($v['name']), $stat);
                    $stat = str_replace('#static_status', ($this->staticId() == intval($k) ? 'active' : 'noactive'), $stat);
                    if ($v['group'] == '')
                        $menus[][] = $stat;
                    else
                        $menus[$v['group']][] = $stat;
                    if ($group_active == "" and $home === false and $this->staticId() == intval($k) and $v['group'] != '')
                        $group_active = $v['group'];
                }
            }
        }
        if ($menublog) {
            if ($this->plxMotor->aConf['homestatic'] != '' and isset($this->plxMotor->aStats[$this->plxMotor->aConf['homestatic']])) {
                if ($this->plxMotor->aStats[$this->plxMotor->aConf['homestatic']]['active']) {
                    $menu = str_replace('#static_id', 'static-blog', $format);
                    if ($this->plxMotor->get and preg_match('/(blog|categorie|archives|tag|article)/', $_SERVER['QUERY_STRING'] . $this->plxMotor->mode)) {
                        $menu = str_replace('#static_status', 'active', $menu);
                    } else {
                        $menu = str_replace('#static_status', 'noactive', $menu);
                    }
                    $menu = str_replace('#static_url', $this->plxMotor->urlRewrite('?blog'), $menu);
                    $menu = str_replace('#static_name', L_PAGEBLOG_TITLE, $menu);
                    $menu = str_replace('#static_class', 'static menu', $menu);
                    array_splice($menus, (intval($menublog) - 1), 0, array($menu));
                }
            }
        }

        # Hook Plugins
        if (eval($this->plxMotor->plxPlugins->callHook('plxShowStaticListEnd'))) return;

        # Affichage des pages statiques + menu Accueil et Blog
        if ($menus) {
            foreach ($menus as $k => $v) {
                if (is_numeric($k)) {
                    echo "\n" . (is_array($v) ? $v[0] : $v);
                } else {
                    $group = str_replace('#group_id', 'static-group-' . plxUtils::urlify($k), $format_group);
                    $group = str_replace('#group_class', 'static group', $group);
                    $group = str_replace('#group_status', ($group_active == $k ? 'active' : 'noactive'), $group);
                    $group = str_replace('#group_name', plxUtils::strCheck($k), $group);
                    echo "\n<li class=\"menu\">\n\t" . $group . "\n\t<ul id=\"static-" . plxUtils::urlify($k) . "\" class=\"sub-menu\">\t\t";
                    foreach ($v as $kk => $vv) {
                        echo "\n\t\t" . $vv;
                    }
                    echo "\n\t</ul>\n</li>\n";
                }
            }
            echo "\n";
        }

    }

    /**
     * Méthode qui retourne l'id de la page statique active
     *
     * @return    int
     * @scope    static
     * @author    Florent MONTHEL, Stéphane F.
     **/
    public function staticId()
    {

        # On va vérifier que la catégorie existe en mode catégorie
        if ($this->plxMotor->mode == 'static' and isset($this->plxMotor->aStats[$this->plxMotor->cible]))
            return intval($this->plxMotor->cible);
        else
            return plxUtils::strCheck($this->plxMotor->mode);
    }

    /**
     * Méthode qui affiche ou retourne l'url de la page statique
     *
     * @param echo    si à VRAI affichage à l'écran
     * @param extra    paramètres supplémentaires pouvant être rajoutés à la fin de l'url de l'article
     * @return    string
     * @scope    static
     * @author    Florent MONTHEL, Stéphane F
     **/
    public function staticUrl($echo = true, $extra = '')
    {

        # Recupération ID URL
        $staticId = $this->staticId();
        $staticIdFill = str_pad($staticId, 3, '0', STR_PAD_LEFT);
        if (!empty($staticId) and isset($this->plxMotor->aStats[$staticIdFill])) {
            $url = $this->plxMotor->urlRewrite('?static' . $staticId . '/' . $this->plxMotor->aStats[$staticIdFill]['url'] . $extra);
            if ($echo)
                echo $url;
            else
                return $url;
        }
    }

    /**
     * Méthode qui affiche le titre de la page statique
     *
     * @scope    static
     * @author    Florent MONTHEL
     **/
    public function staticTitle()
    {

        echo plxUtils::strCheck($this->plxMotor->aStats[$this->plxMotor->cible]['name']);
    }

    /**
     * Méthode qui affiche le groupe de la page statique
     *
     * @scope    static
     * @author    Stéphane F.
     **/
    public function staticGroup()
    {

        echo plxUtils::strCheck($this->plxMotor->aStats[$this->plxMotor->cible]['group']);
    }

    /**
     * Méthode qui affiche la date de la dernière modification de la page statique selon le format choisi
     *
     * @param format    format du texte de la date (variable: #minute, #hour, #day, #month, #num_day, #num_day(1), #num_day(2), #num_month, #num_year(4), #num_year(2), #time)
     * @scope    static
     * @author    Anthony T.
     **/
    public function staticDate($format = '#day #num_day #month #num_year(4)')
    {

        # On genere le nom du fichier dont on veux récupérer la date
        $file = PLX_ROOT . $this->plxMotor->aConf['racine_statiques'] . $this->plxMotor->cible;
        $file .= '.' . $this->plxMotor->aStats[$this->plxMotor->cible]['url'] . '.php';
        # Test de l'existence du fichier
        if (!file_exists($file)) return;
        # On récupère la date de la dernière modification du fichier qu'on formate
        echo plxDate::formatDate(date('YmdHi', filemtime($file)), $format);
    }

    /**
     * Méthode qui affiche la date de creation de la page statique selon le format choisi
     *
     * @param format    format du texte de la date (variable: #minute, #hour, #day, #month, #num_day, #num_day(1), #num_day(2), #num_month, #num_year(4), #num_year(2), #time)
     * @scope    static
     * @author    Stephane F.
     **/
    public function staticCreationDate($format = '#num_day/#num_month/#num_year(4) #time')
    {

        echo plxDate::formatDate($this->plxMotor->aStats[$this->plxMotor->cible]['date_creation'], $format);
    }

    /**
     * Méthode qui affiche la date de modification de la page statique selon le format choisi
     *
     * @param format    format du texte de la date (variable: #minute, #hour, #day, #month, #num_day, #num_day(1), #num_day(2), #num_month, #num_year(4), #num_year(2))
     * @scope    static
     * @author    Stephane F.
     **/
    public function staticUpdateDate($format = '#num_day/#num_month/#num_year(4) #time')
    {

        echo plxDate::formatDate($this->plxMotor->aStats[$this->plxMotor->cible]['date_update'], $format);
    }

    /**
     * Méthode qui inclut le code source de la page statique
     *
     * @scope    static
     * @author    Florent MONTHEL, Stephane F
     **/
    public function staticContent()
    {

        if (eval($this->plxMotor->plxPlugins->callHook("plxShowStaticContentBegin"))) return;

        # On va verifier que la page a inclure est lisible
        if ($this->plxMotor->aStats[$this->plxMotor->cible]['readable'] == 1) {
            # On genere le nom du fichier a inclure
            $file = PLX_ROOT . $this->plxMotor->aConf['racine_statiques'] . $this->plxMotor->cible;
            $file .= '.' . $this->plxMotor->aStats[$this->plxMotor->cible]['url'] . '.php';
            # Inclusion du fichier
            ob_start();
            require $file;
            $output = ob_get_clean();
            eval($this->plxMotor->plxPlugins->callHook('plxShowStaticContent'));
            echo $output;
        } else {
            echo '<p>' . L_STATICCONTENT_INPROCESS . '</p>';
        }

    }

    /**
     * Méthode qui affiche une page statique en lui passant son id (si cette page est active ou non)
     *
     * @param id        id numérique ou url/titre de la page statique
     * @scope    global
     * @author    Stéphane F
     **/
    public function staticInclude($id)
    {

        # Hook Plugins
        if (eval($this->plxMotor->plxPlugins->callHook('plxShowStaticInclude'))) return;
        # On génère un nouvel objet plxGlob
        $plxGlob_stats = plxGlob::getInstance(PLX_ROOT . $this->plxMotor->aConf['racine_statiques'], true, 'statiques');
        if (is_numeric($id)) # inclusion à partir de l'id de la page
            $regx = '/^' . str_pad($id, 3, '0', STR_PAD_LEFT) . '.[a-z0-9-]+.php$/';
        else { # inclusion à partir du titre de la page
            $url = plxUtils::urlify($id);
            $regx = '/^[0-9]{3}.' . $url . '.php$/';
        }
        if ($files = $plxGlob_stats->query($regx)) {
            # on récupère l'id de la page pour tester si elle est active
            if (preg_match('/^([0-9]{3}).(.*).php$/', $files[0], $c)) {
                if ($this->plxMotor->aStats[$c[1]]['active'])
                    include PLX_ROOT . $this->plxMotor->aConf['racine_statiques'] . $files[0];
            }
        }
    }

    /**
     * Méthode qui affiche la pagination
     *
     * @scope    global
     * @author    Florent MONTHEL, Stephane F
     **/
    public function pagination()
    {

        $capture = '';
        $plxGlob_arts = clone $this->plxMotor->plxGlob_arts;
        $aFiles = $plxGlob_arts->query($this->plxMotor->motif, 'art', '', 0, false, 'before');

        if ($aFiles and $this->plxMotor->bypage and sizeof($aFiles) > $this->plxMotor->bypage) {

            # on supprime le n° de page courante dans l'url
            $arg_url = $this->plxMotor->get;
            if (preg_match('/(\/?page[0-9]+)$/', $arg_url, $capture)) {
                $arg_url = str_replace($capture[1], '', $arg_url);
            }
            # Calcul des pages
            $prev_page = $this->plxMotor->page - 1;
            $next_page = $this->plxMotor->page + 1;
            $last_page = ceil(sizeof($aFiles) / $this->plxMotor->bypage);
            # Generation des URLs
            $f_url = $this->plxMotor->urlRewrite('?' . $arg_url); # Premiere page
            $arg = (!empty($arg_url) and $prev_page > 1) ? $arg_url . '/' : $arg_url;
            $p_url = $this->plxMotor->urlRewrite('?' . $arg . ($prev_page <= 1 ? '' : 'page' . $prev_page)); # Page precedente
            $arg = !empty($arg_url) ? $arg_url . '/' : $arg_url;
            $n_url = $this->plxMotor->urlRewrite('?' . $arg . 'page' . $next_page); # Page suivante
            $l_url = $this->plxMotor->urlRewrite('?' . $arg . 'page' . $last_page); # Derniere page

            # Hook Plugins
            if (eval($this->plxMotor->plxPlugins->callHook('plxShowPagination'))) return;

            # On effectue l'affichage
            if ($this->plxMotor->page > 2) # Si la page active > 2 on affiche un lien 1ere page
                echo '<span class="p_first"><a href="' . $f_url . '" title="' . L_PAGINATION_FIRST_TITLE . '">' . L_PAGINATION_FIRST . '</a></span>&nbsp;';
            if ($this->plxMotor->page > 1) # Si la page active > 1 on affiche un lien page precedente
                echo '<span class="p_prev"><a href="' . $p_url . '" title="' . L_PAGINATION_PREVIOUS_TITLE . '">' . L_PAGINATION_PREVIOUS . '</a></span>&nbsp;';
            # Affichage de la page courante
            printf('<span class="p_page p_current">' . L_PAGINATION . '</span>', $this->plxMotor->page, $last_page);
            if ($this->plxMotor->page < $last_page) # Si la page active < derniere page on affiche un lien page suivante
                echo '&nbsp;<span class="p_next"><a href="' . $n_url . '" title="' . L_PAGINATION_NEXT_TITLE . '">' . L_PAGINATION_NEXT . '</a></span>';
            if (($this->plxMotor->page + 1) < $last_page) # Si la page active++ < derniere page on affiche un lien derniere page
                echo '&nbsp;<span class="p_last"><a href="' . $l_url . '" title="' . L_PAGINATION_LAST_TITLE . '">' . L_PAGINATION_LAST . '</a></span>';
        }
    }

    /**
     * Méthode qui affiche la question du capcha
     *
     * @scope    global
     * @author    Florent MONTHEL, Stephane F.
     **/
    public function capchaQ()
    {
        # Hook Plugins
        if (eval($this->plxMotor->plxPlugins->callHook('plxShowCapchaQ'))) return;
        echo $this->plxMotor->plxCapcha->q();
        ?>
        <input type="hidden" name="capcha_token" value="<?= $_SESSION['capcha_token'] ?>"/>
        <?php
    }

    /**
     * DEPRECATED
     *
     * Méthode qui affiche la réponse du capcha cryptée en sha1
     *
     * @scope    global
     * @author    Florent MONTHEL, Stephane F.
     **/
    public function capchaR()
    {
        # Hook Plugins
        if (eval($this->plxMotor->plxPlugins->callHook('plxShowCapchaR'))) return;
        echo $this->plxMotor->plxCapcha->r();

    }

    /**
     * Méthode qui affiche le message d'erreur de l'objet plxErreur
     *
     * @scope    erreur
     * @author    Florent MONTHEL
     **/
    public function erreurMessage()
    {

        echo $this->plxMotor->plxErreur->getMessage();
    }

    /**
     * Méthode qui affiche le nom du tag (linké ou non)
     *
     * @param type    type d'affichage : link => sous forme de lien
     * @scope    tags
     * @author    Stephane F
     **/
    public function tagName($type = '')
    {

        if ($this->plxMotor->mode == 'tags') {
            $tag = plxUtils::strCheck($this->plxMotor->cible);
            $tagName = plxUtils::strCheck($this->plxMotor->cibleName);
            # On effectue l'affichage
            if ($type == 'link')
                echo '<a href="' . $this->plxMotor->urlRewrite('?tag/' . $tag) . '" title="' . $tagName . '">' . $tagName . '</a>';
            else
                echo $tagName;
        }
    }

    /**
     * Méthode qui affiche un lien vers le fil Rss des articles d'un tag
     *
     * @param type        type de flux (obsolete)
     * @param tag            nom du tag
     * @param format        format du code HTML pour l'affichage du lien (variable : #feedUrl, #feedTitle, #feedName)
     * @scope                home,categorie,article,tags,archives
     * @author                Stephane F, Pedro "P3ter" CADETE
     **/

    public function tagFeed($type = 'rss', $tag = '', $format = '<a href="#feedUrl" title="#feedTitle">#feedName</a>')
    {

        # Hook Plugins
        if (eval($this->plxMotor->plxPlugins->callHook('plxShowTagFeed')))
            return;

        if ($this->plxMotor->aConf ['enable_rss']) {
            if ($tag == '' and $this->plxMotor->mode == 'tags') {
                $tag = $this->plxMotor->cible;
            }
            $result = str_replace('#feedUrl', $this->plxMotor->urlRewrite('feed.php?rss/tag/' . plxUtils::strCheck($tag)), $format);
            $result = str_replace('#feedTitle', L_ARTFEED_RSS_TAG, $result);
            $result = str_replace('#feedName', L_ARTFEED_RSS_TAG, $result);
            echo $result;
        }
    }

    /**
     * Méthode qui affiche la liste de tous les tags.
     *
     * @param format    format du texte pour chaque tag (variable : #tag_size, #tag_id, #tag_status, #tag_count, #tag_item, #tag_url, #tag_name, #nb_art)
     * @param max        nombre maxi de tags à afficher
     * @param order    tri des tags (random, alpha, '' = tri par popularité)
     * @scope    global
     * @author    Stephane F, J.P. Pourrez
     **/
    public function tagList($format = '<li class="tag #tag_size"><a class="#tag_status" href="#tag_url" title="#tag_name">#tag_name (#tag_count)</a></li>', $max = '', $order = 'random')
    {
        # Hook Plugins
        if (eval($this->plxMotor->plxPlugins->callHook('plxShowTagList'))) return;

        # On verifie qu'il y a des tags
        if ($this->plxMotor->aTags) {
            $now = date('YmdHi');
            # On liste les tags sans créer de doublon
            $counters = array();
            foreach ($this->plxMotor->aTags as $idart => $tag) {
                if (isset($this->plxMotor->activeArts[$idart]) and $tag['date'] <= $now and $tag['active']) {
                    if ($tags = array_map('trim', explode(',', $tag['tags']))) {
                        foreach ($tags as $tag) {
                            if (!empty($tag)) {
                                if (!array_key_exists($tag, $counters)) {
                                    $counters[$tag] = 1;
                                } else {
                                    $counters[$tag]++;
                                }
                            }
                        }
                    }
                }
            }

            # tri des tags
            switch ($order) {
                case 'alpha':
                    # Le tri alpha se fait sur la clé
                    ksort($counters); # éventuellement uksort pour tri spécifique sur $tag
                    break;
                case 'random':
                    $keys = array_keys($counters);
                    shuffle($keys);
                    $arr_elem = array();
                    foreach ($keys as $key) {
                        $arr_elem[$key] = $counters[$key];
                    }
                    $counters = $arr_elem;
                    break;
                default:
                    arsort($counters);
            }

            # limite sur le nombre de tags à afficher
            if ($max != '') $counters = array_slice($counters, 0, intval($max), true);

            # Recherche de la valeur maxi pour $counters. A multiplier par 10.
            $max_value = array_reduce(
                array_values($counters),
                function ($lastValue, $value) {
                    return ($lastValue > $value) ? $lastValue : $value;
                },
                0
            );
            $max_value *= 0.1; # Pour faire varier la taille des caractères de 1 à 11;

            $mode = $this->plxMotor->mode;

            # Récupération de la liste des tags de l'article si on est en mode 'article'
            # pour mettre en évidence dans la sidebar les tags attachés à l'article
            $artTags = array();
            switch ($mode) {
                case 'article':
                    $artTagList = $this->plxMotor->plxRecord_arts->f('tags');
                    if (!empty($artTagList)) {
                        $artTags = array_map('trim', explode(',', $artTagList));
                    }
                    break;
                case 'home':
                    foreach ($this->plxMotor->plxRecord_arts->result as $record) {
                        foreach (array_map('trim', explode(',', $record['tags'])) as $tag) {
                            if (!in_array($tag, $artTags)) {
                                $artTags[] = $tag;
                            }
                        }
                    }
            }

            # On affiche la liste
            $id = 0;
            foreach ($counters as $tag => $counter) {
                $url = plxUtils::urlify($tag);
                $status = 'noactive';
                switch ($mode) {
                    case 'article':
                        if (in_array($tag, $artTags)) {
                            $status = 'active';
                        }
                        break;
                    case 'tags':
                        $status = ($this->plxMotor->cible == $url) ? 'active' : 'noactive';
                }
                $replaces = array(
                    '#tag_id' => 'tag-' . $id++,
                    '#tag_size' => 'tag-size-' . (1 + intval($counter / $max_value)), # taille des caractères
                    '#tag_count' => $counter,
                    '#nb_art' => $counter,
                    '#tag_item' => $url,
                    '#tag_url' => $this->plxMotor->urlRewrite('?tag/' . $url),
                    '#tag_name' => plxUtils::strCheck($tag),
                    '#tag_status' => $status
                );
                echo str_replace(array_keys($replaces), array_values($replaces), $format);
            }
        }
    }

    /**
     * Méthode qui affiche la liste des archives
     *
     * @param format    format du texte pour l'affichage (variable : #archives_id, #archives_status, #archives_selected, #archives_nbart, #archives_url, #archives_name, #archives_month, #archives_year)
     * @scope    global
     * @author    Stephane F, J.P. Pourrez
     * @version 2017-06-15
     *
     **/
    public function archList($format = '<li id="#archives_id"><a class="#archives_status" href="#archives_url" title="#archives_name">#archives_name</a></li>')
    {

        $capture = '';

        # Hook Plugins
        if (eval($this->plxMotor->plxPlugins->callHook('plxShowArchList'))) return;

        # on compte le nombre d'articles pour chaque mois de la période et pour chaque année passée
        $plxGlob_arts = clone $this->plxMotor->plxGlob_arts;
        if ($files = $plxGlob_arts->query('/^\d{4}\.(?:\d{3},|home,)*(' . $this->plxMotor->activeCats . ')(?:,\d{3}|,home)*\.\d{3}\.\d{12}\.[\w-]+\.xml$/', 'art', 'rsort', 0, false, 'before')) {
            # compte les années en mois !
            $periode = 12; # on détaille pour les 12 derniers mois
            $annee_mois_cc = intval(date('Y')) * 12;
            $ce_mois_ci = $annee_mois_cc + intval(date('n')) - 1; # on compte les mois à partir de 0
            $premier_mois = $ce_mois_ci - $periode; # 1er mois de la période
            $cumuls_mois = array();
            $cumuls_ans = array();
            $total = 0;

            # récupère l'année et le mois de chaque article
            $motif = '@^\d{4}\.(?:\d{3}|home)+(?:,\d{3}|,home)*\.\d{3}\.(\d{4})(\d{2})\d{6}\.[\w-]+\.xml$@';
            foreach ($files as $id => $filename) {
                if (preg_match($motif, $filename, $capture)) {
                    $total++;
                    $annee = intval($capture[1]);
                    $annee_mois = $annee * 12;

                    # cumul pour chaque mois de la période
                    $mois = $annee_mois + intval($capture[2]) - 1; # Nb de mois depuis l'an 0
                    if ($mois >= $premier_mois) {
                        # l'index de $cumuls_mois est le nombre de mois depuis l'an 0
                        if (isset($cumuls_mois[$mois]))
                            $cumuls_mois[$mois]++;
                        else
                            $cumuls_mois[$mois] = 1;
                    }

                    # cumul pour les années écoulées
                    if ($annee_mois < $annee_mois_cc) {
                        # l'index de $cumuls_ans est l'année
                        if (isset($cumuls_ans[$annee]))
                            $cumuls_ans[$annee]++;
                        else
                            $cumuls_ans[$annee] = 1;
                    }
                }
            }
            krsort($cumuls_mois);
            krsort($cumuls_ans);

            # Affichage pour la période en cours
            $page_actuelle = ($this->plxMotor->mode == "archives") ? $this->plxMotor->cible : '';
            # mb_internal_encoding('utf-8');
            $id = 0;
            foreach ($cumuls_mois as $m => $nbarts) {
                $id++;
                $mois = str_pad(($m % 12) + 1, 2, '0', STR_PAD_LEFT);
                $annee = intval($m / 12);
                $active = $page_actuelle == '' . $annee . $mois;
                $nom_mois = plxDate::getCalendar('month', $mois);
                echo strtr($format, array(
                    '#archives_id' => 'arch-month-' . str_pad($id, 2, '0', STR_PAD_LEFT),
                    '#archives_name' => $nom_mois . ' ' . $annee,
                    '#archives_year' => $annee,
                    '#archives_month' => $nom_mois,
                    '#archives_url' => $this->plxMotor->urlRewrite('?archives/' . $annee . '/' . $mois),
                    '#archives_nbart' => $nbarts,
                    '#archives_status' => (($active) ? 'active' : 'noactive'),
                    '#archives_selected' => (($active) ? 'selected' : '')
                ));
            }

            # Affichage annuel
            $id = 0;
            foreach ($cumuls_ans as $annee => $nbarts) {
                $id++;
                $active = $page_actuelle == '' . $annee;
                echo strtr($format, array(
                    '#archives_id' => 'arch-year-' . str_pad($id, 2, '0', STR_PAD_LEFT),
                    '#archives_name' => L_YEAR . ' ' . $annee,
                    '#archives_year' => $annee,
                    '#archives_month' => L_YEAR,
                    '#archives_url' => $this->plxMotor->urlRewrite('?archives/' . $annee),
                    '#archives_nbart' => $nbarts,
                    '#archives_status' => ($active) ? 'active' : 'noactive',
                    '#archives_selected' => ($active) ? 'selected' : ''
                ));
            }

            # Total des articles
            if (strpos($format, '#archives_nbart') !== false) {
                $url = '';
                if ($this->plxMotor->aConf['homestatic'] != '' and isset($this->plxMotor->aStats[$this->plxMotor->aConf['homestatic']])) {
                    $url = ($this->plxMotor->aStats[$this->plxMotor->aConf['homestatic']]['active']) ? '?blog' : '';
                }
                echo strtr($format, array(
                    '#archives_id' => 'arch-total',
                    '#archives_name' => L_TOTAL . ' ',
                    '#archives_year' => str_repeat('–', 4),
                    '#archives_month' => L_TOTAL,
                    '#archives_url' => $this->plxMotor->urlRewrite($url),
                    '#archives_nbart' => $total,
                    '#archives_status' => ($active) ? 'active' : 'noactive',
                    '#archives_selected' => ($active) ? 'selected' : ''
                ));
            }
        }
    }

    /**
     * Méthode qui affiche un lien vers la page blog.php
     *
     * @param format    format du texte pour l'affichage (variable : #page_id, #page_status, #page_url, #page_name)
     * @scope    global
     * @author    Stephane F
     **/
    public function pageBlog($format = '<li class="#page_class #page_status" id="#page_id"><a href="#page_url" title="#page_name">#page_name</a></li>')
    {
        # Hook Plugins
        if (eval($this->plxMotor->plxPlugins->callHook('plxShowPageBlog'))) return;

        if ($this->plxMotor->aConf['homestatic'] != '' and isset($this->plxMotor->aStats[$this->plxMotor->aConf['homestatic']])) {
            if ($this->plxMotor->aStats[$this->plxMotor->aConf['homestatic']]['active']) {
                $name = str_replace('#page_id', 'static-blog', $format);
                if ($this->plxMotor->get and preg_match('/(blog|categorie|archives|tag|article)/', $_SERVER['QUERY_STRING'] . $this->plxMotor->mode)) {
                    $name = str_replace('#page_status', 'active', $name);
                } else {
                    $name = str_replace('#page_status', 'noactive', $name);
                }
                $name = str_replace('#page_class', 'static menu', $name);
                $name = str_replace('#page_url', $this->plxMotor->urlRewrite('?blog'), $name);
                $name = str_replace('#page_name', L_PAGEBLOG_TITLE, $name);
                echo $name;
            }
        }
    }

    /**
     * Méthode qui ajoute, s'il existe, le fichier css associé à un template
     *
     * @param css_dir     répertoire de stockage des fichiers css (avec un / à la fin)
     * @scope    global
     * @author    Stephane F, Thomas Ingles
     **/
    public function templateCss($css_dir = '')
    {

        # Hook Plugins
        if (eval($this->plxMotor->plxPlugins->callHook('plxShowTemplateCss'))) return;

        $css_dir = $this->plxMotor->aConf['racine_themes'] . $this->plxMotor->style . '/' . $css_dir;#add themes/theme_folder/
        $min_css = str_replace('php', 'min.css', $this->plxMotor->template);
        $css = str_replace('php', 'css', $this->plxMotor->template);
        if (is_file($css_dir . $min_css)) {
            plxUtils::printLinkCss($css_dir . $min_css);
        } elseif (is_file($css_dir . $css)) {
            plxUtils::printLinkCss($css_dir . $css);
        }
    }

    /**
     * Méthode qui ajoute, s'il existe, le fichier css associé aux plugins
     *
     * @scope    global
     * @author    Stephane F
     **/
    public function pluginsCss()
    {
        # Hook Plugins
        if (eval($this->plxMotor->plxPlugins->callHook('plxShowPluginsCss'))) return;
        plxUtils::printLinkCss(PLX_PLUGINS_CSS_PATH . 'site.css');
    }

    /**
     * Méthode qui affiche une clé de traduction appelée à partir du thème
     *
     * @param key    clé de traduction à afficher
     * @return    string
     * @scope    global
     * @author    Stephane F
     **/
    public function lang($key = '')
    {
        if (isset($this->lang[$key]))
            echo $this->lang[$key];
        else
            echo $key;
    }

    /**
     * Méthode qui renvoie une clé de traduction appelée à partir du thème
     *
     * @param key    clé de traduction à afficher
     * @return    string
     * @scope    global
     * @author    Stephane F
     **/
    public function getLang($key = '')
    {
        if (isset($this->lang[$key]))
            return $this->lang[$key];
        else
            return $key;
    }

    /**
     * Méthode qui appel un hook à partir du thème
     *
     * @param hookName    nom du hook
     * @param parms        parametre ou liste de paramètres sous forme de array
     * @return    string or array
     * @scope    global
     * @author    Stephane F
     *
     * Exemple:
     *        # sans return, passage d'un paramètre
     *        eval($plxShow->callHook('MyPluginFunction', 'AZERTY'));
     *        # avec return, passage de 2 paramètres à faire sous forme de tableau
     *        $b = $plxShow->callHook('MyPluginFunction', array('AZERTY', 'QWERTY'));
     **/
    public function callHook($hookName, $parms = null)
    {
        $return = $this->plxMotor->plxPlugins->callHook($hookName, $parms);
        if (is_array($return)) {
            ob_start();
            eval($return[0]);
            echo ob_get_clean();
            return $return[1];
        } else {
            return $return;
        }
    }

    /**
     * Méthode qui permet d'injecter du code php au niveau d'un hook
     *
     * @param hookName    nom du hook
     * @param code        code php à injecter
     * @scope    global
     * @author    Stephane F
     */
    public function addCodeToHook($hookName, $userCode)
    {
        $this->plxMotor->plxPlugins->aHooks[$hookName][] = array(
            'class' => '=SHORTCODE=',
            'method' => $userCode
        );
    }

    /**
     * Method in charge of giving an RSS feed URL for current page posts
     *
     * @param mode        the view mode from plxMotor->mode (categorie, tags)
     * @return     string      the contextualised rss feed URL
     * @author     Pedro "P3ter" CADETE
     */
    public function urlPostsRssFeed($mode = 'home')
    {
        $url = '';
        switch ($mode) {
            case 'categorie':
                $id = $this->catId();
                $idNum = intval($id);
                $url = $this->urlRewrite('feed.php?rss/categorie' . $idNum . '/' . $this->plxMotor->aCats[$id]['url']);
                break;
            case 'tags':
                $tag = plxUtils::strCheck($this->plxMotor->cible);
                $url = $this->urlRewrite('feed.php?rss/tag/' . plxUtils::strCheck($tag));
                break;
            default :
                $url = $this->urlRewrite('feed.php?rss');
        }
        return $url;
    }
}
