Disqus (www.disqus.com) est une plateforme de commentaire. Nous utilisons ce système sur notre blog depuis janvier. Désormais avec l'extension Yuzu Disqus vous pouvez facilement et rapidement intégrer Disqus à eZ Publish 

Objectif 

Chez Yuzu, nous trouvons eZ Publish performant et complet. Mais, il faut reconnaître que ce logiciel n'est pas facile d'accès lorsqu'on débute. C'est pourquoi nous avons décidé de produire des extensions très simples pour ajouter rapidement des fonctionnalités à eZ Publish.

Yuzu Disqus est donc notre première contribution pour la communauté. 

Téléchargement

Notre extension est disponible sur github à l'adresse suivante: https://github.com/AgenceYuzu/YuzuDisqus

Sachez que l'extension Yuzu Disqus possède aussi une page sur projects.ez.no: http://projects.ez.no/yuzudisqus

Elements requis:

Yuzu Disqus nécessite uniquement 2 choses: un compte Disqus et un site eZ Publish

• eZ Publish 4.x (version de développement). Nous n'avons pas testé les versions précédentes mais l'extension doit être compatible avec les version 3 d'eZ Publish.
• Disqus. Il suffit juste de s'inscrire sur le site www.disqus.com

Installation:

Rien de plus simple !

1. Décompressez les fichiers téléchargés sur github dans le répertoire 'extension' de votre site eZ Publish
2. Éditez le fichier "settings/yuzudisqus.ini.append.php"
3. Remplacez 'example' du paramètre shortname par votre shortname sur Disqus.
4. Connectez-vous à l'interface d'administration d'eZ Publish
5. Cliquez sur l'onglet Administration, puis sur Extensions dans le menu de gauche
6. Activez l'extension yuzudisqus
7. Videz les caches

Maintenant que l'extension est intallée, il ne reste plus qu'à intégrer Disqus à votre site eZ Publish

Integrer Disqus dans votre site

Fonctionnalité commentaire

• Éditez le fichier settings/yuzudisqus.ini.append.php
• Inserez le code suivant

 
[blog]
shortname=example

• Remplacez example par votre propre shortname disqus et sauvegardez.
• Éditez le template de la classe de contenu concernée par le module de commentaires. Par exemple extension/ezwebin/design/ezwebin/override/templates/full/blog_post.tpl
• Collez le code source suivant à l'endroit où vous souhaitez insérer les commentaires

 {include uri='design:disqus.tpl' disqusini='blog' node_id=$node.node_id}

disqusini: nom du bloc de paramètres dans yuzudisqus.ini.append.php (ici dans l'exemple blog)
node_id: identifiant pour le système disqus. Dans ce cas, nous vous conseillons d'utiliser l'identifiant du nœud.

• Sauvez les fichiers et videz les caches.

Note:

Si vous utilisez cette extension dans le cadre d'un développement en local (sur votre machine), vous devez activer le mode developpement en ajoutant la ligne suivante

 
[blog]
shortname=example
developer=1

Fonctionnalité nombre de commentaires

Si vous souhaitez afficher le nombre de commentaires sur une page, vous pouvez inclure le code suivant dans la vue "full" d'une classe de contenu:

<a href="#disqus_thread" data-disqus-identifier="{$node.node_id}">
    {include uri='design:disqus_count.tpl' disqusini='example' node_id=$node.node_id} comments
</a>

Evolution

Si vous avez des remarques ou des questions, n'hésitez pas à les partagez avec nous... Utilisez les commentaires Disqus en bas de la page ;)