Présentation :

Voici donc une nouvelle mouture que j'ai baptisée HomePageMode2.

HomePageMode2 permet d'avoir un contenu pour la page d'accueil totalement personnalisable et indépendant du reste du blog. Ce contenu est paramétrable depuis l'administration du plugin.

La documentation ne devrait pas vous intimider, car l'utilisation de base est beaucoup plus simple que les explications qui suivent : vous pouvez consulter directement et sans plus de questions à élucider le tutoriel n° 1 en lien ici : Tutoriels pour le plugin HomepageMode2. Il permet de faire très simplement un éditorial pour la home et est accessible aux débutants. Après, c'est sûr que les possibilités étendues du plugin demanderont un peu plus d'attention pour être utilisées, si vous n'êtes pas déjà un tant soit peu familiarisé avec le langage de template de dotclear 2.

Installation :

Si vous avez déjà d'installé le plugin homePageMode sur votre dotclear2, vous devrez au minimum le désactiver pour tester homePageMode2.

Informations techniques :

  • Sur une installation mono-blog :

    Aucune restriction, toutes les fonctionnalités du plugin sont utilisables.

  • Sur une installation multi-blog :

    Il existe quelques restrictions, pour des raisons de fonctionnement du cache de Dotclear 2, suivant le type d'installation multi-blog que vous avez réalisé.

    • Chaque blog a son propre répertoire de thèmes :

      Pas de souci, tout est fonctionnel si les thèmes utilisés par chaque blog ne sont pas partagés avec d'autres blogs, et si le fichier homepagemode.html du plugin est copié dans chaque thème utilisé par le blog. L'utilisation avancée du plugin permet également de configurer les autres fichiers *.html, dans ce ca, même restriction, ces fichiers doivent être present physiquement dans les thèmes utilisés.

    • Les thèmes sont partagés par plusieurs blogs :

      Si un même répertoire de thèmes alimente plusieurs blogs , seule la partie Intro de la page d'index de l'administration du plugin pourra être utilisée.

Administration :

  • Page d'index :

    Description des différentes sections de la page d'index :

    • Boite de sélection Templates :

      C'est le champ en haut, il sert à sélectionner un fichier template à configurer avec le plugin. Par défaut, c'est le fichier homepagemode.html qui correspond à votre nouvelle page d'accueil quand le mode du plugin est activé. Pour ajouter des templates configurables à la liste, cliquez sur l'onglet Gérer les templates ou Manage templates.

    • Onglet Contenu du template ou Template content :
      • Section Intro :

        Sur cet onglet apparait en haut la section Intro, ( c'est la seule option que vous pourrez utiliser dans le cas d'un multi-blog avec thèmes partagés ).
        Cette section se décompose en deux parties, le Titre et la Description.
        Le contenu de cette section peut être affiché ou vous le voulez sur le template en cours d'édition. Il peux servir par exemple à faire un message d'accueil ou d'introduction.

      • Section Liste des balises de template ou Template tags list :

        Viens ensuite, juste au dessous la section des tags de template configurés pour le template en cours d'édition. Cette section n'est visible que lorsque l'option Activer la gestion des balises de template de l'onglet Options est cochée.

      • Section Mode activation :

        La dernière section de la page d'index du plugin concerne l'activation du mode, et donc l'utilisation du fichier homepagemode.html comme page d'accueil du blog.

    • Onglet Nouvelle Balise ou New tag :

      Cet onglet n'est visible que lorsque l'option Activer la gestion des balises de template ou Tags Active de l'onglet Options est cochée.
      Permet de sélectionner  une balise de template à ajouter pour le template en cour d'édition.
      Un clic sur l'un des tags vous amène sur la page d'édition de celui-ci.

    • Onglet Gérer les templates ou Manage Templates :

      Cet onglet n'est visible que si vous êtes logé en tant que Super Administrateur.
      Un clic sur cet onglet nous amène sur la page de gestion des templates.

    • Onglet Options :

      Cet onglet n'est visible que si vous êtes logé en tant que Super Administrateur.
      Un clic sur cet onglet nous amène sur la page de gestion des options.

  • Page Editer la balise de template ou Edit template tag :

    De cette page vous pouvez régler tous les paramètres de la balise en cour d'édition, cela n'est possible que lorsque l'option Activer la gestion des balises de template ou Tags Active de l'onglet Options est cochée.

    • Section Titre & Description ou Title & Description :

      Cette section permet d'éditer un titre et une description pour la balise en cour d'édition.

    • Section Attributs ou Attributes :

      Cette section permet d'éditer les attributs de la balise en cours, et donc de déterminer ce qui va s'afficher sur le blog.
      Pour en savoir plus sur le rôle de ces attributs, vous pouvez consulter la doc officielle de Dotclear : http://fr.dotclear.org/documentation/2.0/resources/themes/tags.
      Le seul attribut non documenté sur cette doc est l'attribut zone qui est propre au plugin et qui permet de localiser quelle balise du template en cours d'édition sera affectée. son utilisation est détaillée sur la Section code du plugin homePageMode2.

  • Page Gérer les templates ou Manage templates :

    Cette page n'est accessible que si vous êtes logé en tant que Super Administrateur.
    De cette page vous pouvez ajouter, enlever et éditer les templates configurés pour le plugin. Cette page se compose de deux partie :

    • Section Templates non configurés ou Unconfigured templates :

      Vous permet d'ajouter les templates disponible que vous souhaitez configurer avec le plugin.

    • Section Templates configurés ou Configured templates :

      Vous permet de supprimer de la liste des templates configurés ceux que vous ne souhaitez plus utiliser avec le plugin.
      Par défaut, seul le fichier homepagemode.html du plugin est disponible dans cette liste.
      Un lien Editer avec Theme Editor ou Edit whith Theme Editor permet d'accéder directement à la page d'édition du template selectionné.

  • Page Options :

    Cet page n'est accessible que si vous êtes logé en tant que Super Administrateur.
    De cette page vous pouvez activer la gestion des balises de template.
    Le fait d'activer cette option peux entrainer des modifications sur le fichier du template en cours dans le cache, c'est pourquoi il est requis d'être Super Administrateur pour pouvoir le faire.
    Une message de mise en garde est d'ailleurs présent sur cette page :

    Avant d'activer cette option, assurez-vous, si vous êtes sur une installation multi-blog, que ce blog possède bien son propre répertoire de thèmes, et que les thèmes ne soient pas partagés avec d'autres blogs, ceci pour des raisons de fonctionnement du cache de Dotclear 2.

Balises de template de homePageMode2, leurs rôles et comment les utiliser :

Le plugin ajoute une bibliothèques de balises de templates. Vous trouverez tous les détails et le code sur cette page :
Section code pour homePageMode2

Tutoriels :

Une liste de quelques applications pratiques pour utiliser le plugin.

Télécharger le plugin :