Informations générales

En quelques mots

Par défaut, Dotclear embarque uniquement des interfaces pour créer des billets ("post") et des pages ("pages"). L'extension Muppet permet à un administrateur d'une installation de blogs Dotclear de créer de nouveaux types de contenus.. L'idée de Muppet est très simple : proposer aux rédacteurs du blog d'ajouter davantage de contenu en marge des billets classiques.

Administration du plugin

Une nouvelle entrée Mes types fait son apparition dans le menu EXTENSIONS du tableau de bord. Au nouveau contenu, on associe un nouveau type de billet. C'est un élément clé que l'on va retrouver à plusieurs endroits dans cet article.

Création d'un nouveau type de billet

Pour la création d'un nouveau type de billet, plusieurs informations sont demandées :

  • Des obligatoires :
    • Une image : celle-ci s'affichera dans le menu de votre tableau de bord en regard du lien de gestion du contenu associé.
    • Un type : (ou type de billet) il s'agit d'un mot non accentué qui est utilisé notamment côté base de données pour enregistrer votre nouveau genre de billets. Vous pouvez très bien choisir un mot comme code, photo, player mais pourquoi pas oioaigh3 ou qmlksqsj. C'est vous qui voyez :)
    • Un nom (singulier) : ce mot est le repère que vous aurez dans le tableau de bord et dans les widgets Muppet.
  • Des facultatives :
    • Deux options d'intégration pour inclure automatiquement les nouvelles donnés sur les URLs traditionnelles des billets : page d'accueil du blog, la page des catégories, la page des tags, les archives et la recherche. Une seconde option permet de proposer les données dans les fils de syndication.
    • La position du menu : soit dans la section BLOG, soit dans une nouvelle section nommée CONTENU.
    • La forme plurielle du nom choisi précédemment.
    • Le format d'URL des nouvelles données est personnalisation suivant la syntaxe traditionnelle des {t}, {y}, {id}, etc. suivant la syntaxe déjà utilisée dans Dotclear (voir panneau d'aide de la page "Paramètres du blog"). C'est le titre du billet {t} par défaut.

Suite à la création d'un nouveau type de billet, l'extension créé toute seule :

  • Une nouvelle permission associée à votre type : si le nom de votre type est par exemple "player", la nouvelle permission sera "gérer les joueurs". C'est la forme plurielle du nom qui est reprise ici.
  • Un nouveau menu dans le tableau de bord : dans la section BLOG ou CONTENU.
  • Une URL de regroupement accessible à l'adresse http://mon.site.fr/<type du billet>s
  • Un nouveau fil de syndication dédié à ce nouveau type de billet sur l'adresse suivante : http//mon.site.fr/feed/<type du billet>s/atom (ou rss2).

Pour aller plus loin

Le template associé à la page de regroupement se nomme list-<type du billet>.html . Pour la visualisation publique d'un billet seul, un template single-<type du billet>.html est recherché et le cas échéant utilisé. S'il n'est pas trouvé, c'est le fichier post.html qui est utilisé.

Deux widgets sont livrés avec l'extension :

  • Muppet - derniers billets : celui reprend les mêmes options que le widget "derniers billets" avec le choix du type de billet et la configuration du lien vers la page de regroupement de ce type.
  • Muppet - billets sélectionnés : c'est le même que le widget "billets sélectionnés" avec le choix du type de billet.

Aperçus

Capture #1

Capture #1

Capture #2

Capture #2

Capture #3

Capture #3

Capture #4

Capture #4

Informations techniques

  • Version du plugin : 1.4.0RC
  • Version minimale de Dotclear : 2.7
  • Licence : GNU GPL v2
  • Support : Forum Dotclear