AddThis est un service gratuit permettant d’ajouter à un site web un bouton dynamique offrant aux visiteurs différentes possibilités d’ajouter la page à leurs favoris ou de la partager avec leurs contacts. Voici une solution pour l’intégrer à Dotclear.
Mise à jour du 18/10/2010 :
AddThis propose depuis quelques temps une nouvelle API permettant l’intégration du bouton dans un blog de façon beaucoup plus simple. Désormais, plus besoin de toucher au code de Dotclear, il suffit d’ajouter quelques lignes dans les fichiers du thème 
Dans le fichier _footer.html :
|
1 |
<script type="text/javascript" src="http://s7.addthis.com/js/250/addthis_widget.js#username=votre_login_AddThis"></script> |
Dans les autres fichiers .html de votre thème, en choisissant l’emplacement qui vous convient le mieux :
|
1 2 3 |
<!-- AddThis Button BEGIN --> <a class="addthis_button" addthis:url="{{tpl:EntryURL}}" addthis:title="{{tpl:EntryTitle encode_html="1"}}"></a> <!-- AddThis Button END --> |
Billet original du 19/07/2009 :
En effet, l’intégration à Dotclear n’est pas triviale : le bouton AddThis utilise du JavaScript, ce qui nécessite de lui fournir le titre des posts sous forme « échappée » (c’est-à-dire avec les caractères ‘ remplacés par ‘, le ‘ étant le marqueur de fin de chaîne en JavaScript).
Pour cela, nous allons modifier le fichier inc/public/class.dc.template.php pour ajouter une nouvelle balise de template, baptisée EscapedEntryTitle, qui retournera la même chose que la balise EntryTitle existante, mais en version échappée.
Tout d’abord, il faut déclarer cette nouvelle balise, en dupliquant la ligne 167 et en modifiant la copie pour déclarer le nouveau nom :
|
1 |
$this->addValue('EscapedEntryTitle',array($this,'EscapedEntryTitle')); |
Il faut ensuite définir la fonction générant la valeur de la balise. Pour cela, nous allons à nouveau dupliquer le code gérant la balise EntryTitle (lignes 1683 à 1691) en adaptant le code pour cette nouvelle balise, c’est-à-dire en ajoutant un appel à la fonction addslashes() de PHP :
|
1 2 3 4 5 |
/*dtd <!ELEMENT tpl:EscapedEntryTitle - O -- Escaped Entry title --> */ public function EscapedEntryTitle($attr) { $f = $this->getFilters($attr); return '<?php echo addslashes('.sprintf($f,'$_ctx->posts->post_title').'); ?>'; } |
Il ne reste plus qu’à insérer le code AddThis dans les fichiers .html de votre thème, en choisissant l’emplacement qui vous convient le mieux :
|
1 2 3 4 5 6 7 8 9 |
<!-- AddThis Button BEGIN --> <script type="text/javascript"> var addthis_hover_delay = 500; var addthis_pub="votre_login_AddThis"; var addthis_language="{tpl:EntrlyLang}"; </script> <a href="http://www.addthis.com/bookmark.php?v=20" onmouseover="return addthis_open(this, '', '{{tpl:EntryURL}}', '{{tpl:EscapedEntryTitle}}')" onmouseout="addthis_close()" onclick="return addthis_sendto()"><img src="http://s7.addthis.com/static/btn/lg-share-{tpl:EntrlyLang}.gif" width="125" height="16" alt="Bookmark and Share" style="border:0"/></a> <script type="text/javascript" src="http://s7.addthis.com/js/200/addthis_widget.js"></script> <!-- AddThis Button END --> |
Attention : pensez bien à renseigner votre login AddThis à la seconde ligne.
Pour appliquer ce patch, déposez le à la racine de votre installation Dotclear puis ouvrez une console sur votre serveur, positionnez vous à la racine de votre installation Dotclear et tapez la commande suivante :
|
1 |
patch -p1 -ul -i fichier.patch -d . |
Vous pourrez ensuite rétablir la version non patchée avec cette commande :
|
1 |
patch -p1 -ulR -i fichier.patch -d . |