Grosso Modo

Ce système est souple au sens où si rien n'est défini, c'est l'ancien fonctionnement qui est utilisé. Personne n'est donc obligé de tout définir.

Cette extension pour Dotclear 2 nécessite de modifier une page du thème utilisé pour le blog (mais c'est facile, maintenant, avec l'éditeur de thème). Il faut, dans la page tag.html, là où on veut la description du tag, entourer la présentation actuelle du mot-clef par <tpl:TagDescription>...</tpl:TagDescription>. Par exemple :

<tpl:TagDescription><h2>{{tpl:lang Keyword}} - {{tpl:MetaID}}</h2></tpl:TagDescription>

Cette extension ajoute une table dans la base de données. Elle n'a pas été testée avec PostgresQL (mais je ne vois pas pourquoi ça échouerait, je ne fais que des opérations extrêmement simples).

La page de maintenance de cette extension est à cette adresse : http://jean-christophe.dubacq.fr/post/kezako.

Installation

Utilisez le fichier zippé fourni en annexe de ce billet. Ensuite, rendez-vous en zone d'administration, donnez le rôle (la permission) editor aux utilisateurs qui doivent décrire des catégories ou des mots-clefs. Le menu Kezako devrait apparaître dans l'interface d'administration pour ces utilisateurs. Faites aussi la modification de thème décrite plus haut. Si la table n'est pas créée, c'est que vous n'êtes pas passés par la zone d'administration.

Paramètres de Kezako

Il y a deux paramètres pour cette extension : un qui permet de remplacer la description des catégories par celles de l'extension, et un qui permet de dire que l'on veut des catégories en plusieurs langues (pas uniquement celle du blog). Comme la plupart des blogs sont unilingues, et que remplacer la définition des catégories n'est pas utile dans ce cas-là, les deux paramètres sont désactivés par défaut. Pour une utilisation complète de l'extension, il est possible de les activer. Notez que la langue du blog doit être non-vide si vous n'utilisez que celle-ci.

Je n'ai pas trouvé d'extension concurrente à celle-ci.

La version courante de cette extension est 0.8 (local svn 396).

Cette extension est sous la licence GPL version 2.0.

Utilisation

Liste des descriptions

Dans le menu « Blog » de la zone d'administration, vous accédez aux deux paramètres et à la liste de toutes les descriptions connues. Vous pouvez les modifier ou les effacer, et en insérer de nouvelles. Quand vous modifiez ou insérez une description, vous utilisez l'éditeur visuel habituel de dotclear. L'identifiant de la description pour un mot-clef est le mot-clef lui-même, la langue est à choisir dans le menu (si vous avez le choix de la langue), et votre description est entièrement libre. À noter que pour les mots-clefs, elle remplace complètement ce qu'il y avait avant (Mot-clef - tag), pas ajouté derrière.

Entrée d'une description

Si une description pour une catégorie n'est pas trouvée par Kezako dans ses propres tables, c'est la description intrinsèque de Dotclear qui est utilisée à la place. Ainsi, Kezako n'a pas d'effet visible sur un blog où il est installé mais non utilisé.

Travail restant à faire

• Vérifier que l'extension fonctionne sans le framework dctranslation (ça devrait).
• Permettre de désactiver convenablement les catégories dans le cas d'une plateforme multiblog.