Prendre un Café - gravatar

Dotclear2 et les gravatars

NiKo — Thu, 21 Sep 2006 15:07:00 +0200

Voici une astuce pour gérer les gravatars dans les commentaires de votre blog Dotclear2. Dans le répertoire de votre thème courant, créez un fichier _public.php et ajoutez-y ces quelques lignes de code ^[1] :

<?php
$core->tpl->addValue('gravatar', array('gravatar', 'tplGravatar'));
class gravatar {
  public static function tplGravatar($attr)
  {
    return '<?php echo md5(strtolower($_ctx->comments->getEmail(false))); ?>';
  }
}
?>

Maintenant, dans votre fichier de template pour les billets (généralement, il s'agit de post.html), vous pouvez appeller votre image de gravatar de cette façon entre les balises <tpl:Comments> et </tpl:Comments> :

<img src="http://www.gravatar.com/avatar.php?gravatar_id={{tpl:gravatar}}"
     class="gravatar_img" alt="Gravatar Image" />

Voila, c'est codé en 5 minutes et vous aurez constaté que je ne génère pas directement l'url complète du gravatar et encore moins la syntaxe HTML de la balise image depuis la classe PHP, c'est tout simplement car :

J'en ai la flemme,
Je préfère gérer ça dans le template.

Hope it helps anyway

Edit du 22 septembre 2006

Bon, voila finalement une version un poil plus customizable. Le code qui suit annule et remplace le précedent dans votre fichier _public.php :

<?php
$core->tpl->addValue('gravatar', array('gravatar', 'tplGravatar'));

class gravatar {

  const
    URLBASE = 'http://www.gravatar.com/avatar.php?gravatar_id=%s&amp;default=%s&amp;size=%d',
    HTMLTAG = '<img src="%s" class="%s" alt="%s" />',
    DEFAULT_SIZE = '40',
    DEFAULT_CLASS = 'gravatar_img',
    DEFAULT_ALT = 'Gravatar de %s';

  public static function tplGravatar($attr)
  {
    $md5mail = '\'.md5(strtolower($_ctx->comments->getEmail(false))).\'';
    $size    = array_key_exists('size',   $attr) ? $attr['size']   : self::DEFAULT_SIZE;
    $class   = array_key_exists('class',  $attr) ? $attr['class']  : self::DEFAULT_CLASS;
    $alttxt  = array_key_exists('alt',    $attr) ? $attr['alt']    : self::DEFAULT_ALT;
    $altimg  = array_key_exists('altimg', $attr) ? $attr['altimg'] : '';
    $gurl    = sprintf(self::URLBASE,
                       $md5mail, urlencode($altimg), $size);
    $gtag    = sprintf(self::HTMLTAG,
                       $gurl, $class, eregi("%s", $alttxt) ?
                                      sprintf($alttxt, '\'.$_ctx->comments->comment_author.\'') : $alttxt);
    return '<?php echo \'' . $gtag . '\'; ?>';
  }

}
?>

Du côté de votre template post.html et toujours entre vos deux balises <tpl:Comments> et </tpl:Comments>, voila comment ça se passe :

{{tpl:gravatar class="gravatar_img" size="80" altimg="http://www.example.host/default_gravatar.png" alt="Gravatar de %s"}}

Je crois que les attributs sont assez parlants, mais en voici le détail au cas où :

class : le nom de la classe CSS à appliquer à l'image
size : la taille en pixels
alt : Le contenu du texte alternatif à l'image (acepte la syntaxe de sprintf)
altimg : L'url de l'image par defaut en l'absence de gravatar (sera url encodée automatiquement)

Enjoy.

Finalement, voila le plugin

Bon, je suis incorrigible mais l'occasion était trop belle pour commencer à mettre le nez dans le nouveau système de plugins de Dotclear2 ; voici donc le plugin Gravatars ^[2] :

Bien évidemment, pour une toute première version, il doit exister quelques bugs et limitations :

Pas de traduction française
Pas d'aide contextuelle
Pas de configuration par blog (à venir)
Utilisation d'un archaïque fichier INI (pas compris comment mettre les settings en base)

Au chapitre des fonctionnalités :

Possibilité de définir les paramètres des gravatars de façon globale...
ou individuellement au niveau du template d'appel (voir plus haut)

Edit du 25 août 2007 : Grâce à Goulven, vous avez droit à la version patchée compatible Dotclear2b7 du plugin :

Notes

[1] Prochaine étape : gérer la coloration syntaxique du code dans Dotclear2.

[2] Packagé grâce au plugin Pack it! d'Elaboration.be

Planquez-vous, je tente un Dotclear2

NiKo — Fri, 15 Sep 2006 18:30:00 +0200

C'est même plus un casque de chantier qu'il vous faut porter, mais un abri anti-atomique portatif

Le but est avant tout de conserver les urls de l'ancienne version du blog et/ou gérer des règles de réécritures les faisant pointer sur les nouvelles.

Ce qui a été fait, ce qu'il reste à faire :

Import des billets, catégories et commentaires : OK
Prise en charge des anciennes URLs (règles de réécritures Apache) : OK
Virer le index.php des urls : OK
Prendre en charge la redirection des anciens répertoires images et share : OK (Les liens symboliques sont mes amis)
Prendre en charge les anciennes urls des commentaires et trackbacks : OK (Pep est mon ami)
Régler les problèmes de flux RSS : OK (Un plugin dédié à la gestion des flux Feedburner existe !)
Portage du thème : OK ^[1]
Prendre à nouveau en charge les Gravatars via le mécanisme de templates de Dotclear2 : OK (Plus d'informations)
Taguer les billets : OK
Réintégrer la syntaxe wiki dans les commentaires : ~~À faire~~ Finalement, non.
Gérer les anciennes émoticônes : ~~À faire~~ Pfff, on s'en fiche, non ?
Prendre à nouveau en charge la coloration syntaxique via Geshi : OK -> Merci Lalex

Si vous voyez d'autres choses, n'hésitez pas à me les signaler en commentaire.

En attendant je dois reconnaître qu'Olivier a effectué un excellent boulot sur cette nouvelle version de Dotclear, et que le thème par défaut est magnifique

Edit : Toutes mes excuses aux lecteurs du Planet Ubuntu-fr qui font (encore) les frais du changement d'urls des flux de syndication.

Notes

[1] J'en ai profité pour demander l'autorisation d'utiliser l'habillage des tags de Blogmarks. Permission accordée, cool

Liste des plugins utilisés sur ce blog

NiKo — Wed, 08 Jun 2005 17:59:00 +0000

Je reçois pas mal de mails me demandant quel est tel ou tel plugin utilisé sur ce blog, et où le trouver ; voici donc la petite liste des greffons Dotclear utilisés ici

BBClone - Statistiques complètes.
Billets voisins catégoriques - Affiche les liens vers les billets suivant et précédent dans la même catégorie.
Citations - Comme son nom l'indique, affiche une citation de façon aléatoire.
Gravatars - Afficher les gravatars des auteurs de commentaires et de billets.
Informations étendues - Affiche le nombre de billets, de commentaires et de trackbacks de/sur votre blog.
Last Comments - Les derniers commentaires postés.
Last Blogmarks - Affiche les derniers blogmarks (d'ailleurs ça devrait plutôt être Latest blogmarks, mais j'ai la flemme de tout changer)
Pagination - Permet de présenter les listes de billets sur plusieurs pages.
PDF Export - J'y travaille mais je manque de temps. Promis je me grouille.
Referers - Affiche une liste des affluents à votre blog.
SchedulePosts - Permet de programmet la date et l'heure de publication d'un billet.
Smilies Manager - Permet de gérer vos smilies par thèmes.

Vous trouverez d'autre part la plupart des plugins existant pour Dotclear sur le Wiki des Plugins (quel joli nom).