Prenons un exemple simple. Notre blogueur lambda souhaite commenter les grands titres de l'actualité. Il va par exemple se baser sur le flux "A la une" du journal "Le Monde".

Dans l'interface de configuration de l'extension, il définit un nouveau type de billet personnalisé "A la une" avec le flux en question : Définition de billets personnalisés

Le choix "feed-item-list" représente le modèle de mise en page utilisé, en l'occurrence un liste des éléments du flux. C'est un des modèles présents dans l'installation standard de cette extension.

A partir de là, une nouvelle entrée de menu nommée <Nouveau billet "A la une"> est proposée dans le menu d'édition de dotclear : Nouveau billet personnalisé

En cliquant sur cette entrée de menu, un nouveau billet est créé. Son texte initial est basé sur le contenu du flux paramétré : Contenu généré

Le reste, c'est une édition classique de billet.

En couplant l'usage de cette extension à celui d'un lecteur de flux, on peut publier un contenu un peu plus personnalisé. Par exemple, le lecteur de flux Google Reader permet de marquer les articles qui retiennent notre attention et de publier la liste des articles marqués comme un nouveau flux. En utilisant celui-ci avec "Post Maker", on peut écrire rapidement des billets de "revue de web".

J'ai pour ma part déjà un tel flux. Il apparait sur la page d'accueil de mon blog sous l'intitulé "Au fil de mes lectures". Désormais, je vais essayer de publier des billets qui commentent ces lectures. D'où mon intérêt pour écrire une telle extension...

Rentrons maintenant dans la partie un peu plus technique. L'extension fournit par défaut 2 modèles de billet mais il est relativement simple d'en rajouter car le contenu des modèles est dans des fichiers texte.
2 types de fichiers sont utilisés : les ".hentry" et les ".wentry". Les premiers sont des modèles pour les billets composés en xhtml, les seconds sont pour les billets en syntaxe wiki. Le choix du modèle est effectué à partir des préférences de l'utilisateur.

Exemple de fichiers :

Le contenu est du html dans le premier cas, du texte wiki dans le second mais avec quelques balises en plus. Ces balises auront un air familier pour ceux qui connaissent les thèmes dotclear : le même moteur de template est utilisé pour définir les modèles de billet mais avec un jeu de balise entièrement dédié (les balises de thèmes dotclear n'ont aucun sens dans ce contexte).

Pour rajouter des modèles, il suffit de mettre les fichiers adéquats dans le dossier "templates" de l'extension.

La liste des balises disponibles dans la version 1.0 de "Post Maker" :

  • <tpl:EntryTitle> : block qui définit le titre du billet
  • <tpl:EntryExcerpt> : block qui définit l'extrait du billet
  • <tpl:EntryContent> : block qui définit le contenu du billet
  • {{FeedURL}} : adresse du flux paramétré
  • {{FeedProperty name="..."}} : propriété du flux.
    • Exemple : {{tpl:FeedProperty name="title"}} pour le titre
  • <tpl:FeedItems> : block de boucle sur les éléments du flux
  • {{FeedItemProperty name=""}} : propriété de l'élément courant.
    • Exemple : {{tpl:FeedItemProperty name="link"}} pour l'URL de l'élément
  • {{FeedItemDate}} : date de publication de l'élément courant dans le format défini dans les paramètres du blog
  • {{FeedItemTime}} : heure de publication de l'élément courant dans le format défini dans les paramètres du blog

Bonne utilisation !
Et j'attends bien sûr toutes les remarques utiles à l'amélioration de cette extension !