Citriq : une extension pour WordPress

citriq-wordpress-plugin

Vous utilisez WordPress pour votre blog littéraire ? L’extension Citriq pour WordPress peut vous aider à mieux référencer vos articles en créant automatiquement des liens entre vos critiques et d’autres critiques du même livre sur d’autres sites littéraires ! Citriq.net est aussi un moteur de recherche qui recensent des dizaines milliers de critiques littéraires issues de centaines de sites et blogs.

Installation

La première chose à faire est d’inscrire votre blog sur Citriq.net (si ce n’est pas déjà fait).

Citriq pour WordPress est disponible dans l’annuaire des extensions de WordPress, ce qui vous permettra de l’installer facilement et de bénéficier des mises à jour automatique à chaque nouvelle version. Rendez-vous dans l’onglet Extensions de WordPress, cliquer sur Rechercher et entrez Citriq comme mot-clé. Repérez l’extension, cliquez sur Installer maintenant puis sur Activez l’extension, et c’est tout !

Si vous préférez installer l’extension manuellement, voici la marche à suivre :

  1. Téléchargez le fichier zip de la dernière version de l’extension.
  2. Sur la page des extensions de WordPress, en haut à droite, cliquez sur Ajouter.
  3. Dans les onglets sous Installer des extensions, cliquez sur Envoyer.
  4. Sélectionnez sur votre ordinateur le fichier zip téléchargé plus tôt, puis cliquez sur Installez maintenant.
  5. Une fois l’installation terminée, cliquez sur Activer l’extension.
  6. L’extension est activée et prête à être utilisée !

Utilisation

Une fois l’extension installée et activée sur votre blog, il vous faudra utiliser les champs personnalisés de WordPress pour que l’extension sache lesquels de vos articles doivent être référencés sur Citriq, et à quel livre correspond la critique.

Il faudra donc, dans un premier temps, activer les champs personnalisés (si ce n’est pas déjà fait) en cliquant, sur la page d’écriture des articles, sur Options de l’écran (en haut à droite) puis en cochant la case Champs personnalisés.

citriq-wordpress-1

Pour signaler à l’extension qu’un article est une critique à référencer, il vous faudra renseigner l’ISBN du livre en créant un champ personnalisé isbn. Repérez la zone la zone Ajouter un champ personnalisé puis entrez isbn (en minuscule, c’est important) dans le champ Nom et l’ISBN du livre critique dans le champ Valeur. Cliquez enfin sur Mettre à jour pour enregistrer les modifications de votre article.

citriq-wordpress-2

NB : L’ISBN est un numéro unique attribué à chaque livre publié, long de 13 chiffres et commençant toujours par 978 ou 979. On le trouve dans les premières pages du livre ou au dos, généralement près du code barre. Il peut être entré avec ou sans tiret.

Répétez ensuite cette opération pour chaque article à référencer dans Citriq.

 Résolution des problèmes

Pour vérifiez que l’extension fonctionne correctement, ajoutez ?debug=1 ou &debug=1 à l’adresse de la page de l’article dans la barre de votre navigateur. Le widget Citriq affichera un message d’erreur détaillant le problème s’il y a lieu.

citriq-wordpress-debug

Si vous parvenez pas à résoudre le problème, n’hésitez pas poster le message d’erreur en commentaire à cet article (avec l’adresse de l’article posant problème), je tâcherai de vous aider.

Pour aller plus loin

Pour envoyer plus d’information à Citriq, il est possible d’utiliser d’autres champs personnalisés. Le champ isbn est le seul obligatoire, mais voici d’autres champs que vous pouvez utiliser :

  • excerpt : un extrait de la critique (jusqu’à 500 caractères) ;
  • reviewer : l’auteur de la critique (s’il y en a plusieurs sur le site) ;
  • source : support dont est issue la critique (si différent du site) ;
  • rating : permet d’indiquer une note (un entier, sur 100) ;

citriq-wordpress-custom-params

Historique des modifications

1.0.3 (13/02/2014)
  • Les liens s’affichent désormais aussi si la critique est affiché sur une page avec d’autres articles (accueil, catégorie, tag) mais l’adresse de la critique n’est pas enregistrée dans ce cas (paramètre ‘ignore’)
  • Ajout d’un paramètre ‘plugin’ pour détecter les blogs utilisateurs de l’extension à des fins statistiques
  • La date de publication de l’article est désormais transmise avec le paramètre ‘date’
1.0.2 (11/02/2014)
  • Suppression du fichier inutile wp_auto_update.class.php
1.0.1 (10/02/2014)
  • Suppression de la mise à jour automatique
1.0 (08/02/2014)
  • Première version de l’extension

Les blogs qui utilisent l’extension WordPress

N’hésitez pas à me signaler toute utilisation de cette extension (en précisant la version de WordPress utilisée). Outre le fait que ça me fera plaisir, je pourrais vérifier que tout fonctionne correctement et lister sur cette page les blogs utilisants l’extension.

Citriq : automatiser le référencement de vos critiques littéraires avec PHP

Si votre site ou blog utilise php, il est facile de lui faire écrire le petit code JavaScript permettant de référencer automatiquement vos critiques dans Citriq. Cela vous évitera d’avoir à les entrer une par une.

Voici une fonction qui permet de faire écrire automatiquement le code widget à PHP en fonction des paramètres reçus. Elle nécessite PHP 5.

Cette fonction permet notamment via deux nouveaux paramètres excerpt et rating d’envoyer à Citriq un extrait (jusqu’à 500 caractères) de la critique et une note (sur 100). Ces paramètres étaient jusqu’à présent réservés aux critiques entrées manuellement.  La fonction se charge en outre de l’encodage du texte dans les paramètres du widget de manière à ce que les caractères soient correctement pris en charge par Citriq.

La fonction

function citriq($params) {
  if(empty($params["uid"])) $error = "Le paramètre uid est obligatoire";
  elseif(empty($params["isbn"])) $error = "Le paramètre isbn est obligatoire";
  else return '<script type="text/javascript" src="http://citriq.net/w/crawl?'.http_build_query($params).'"><script>';
  if($params["debug"] == 1 && isset($error)) die("Erreur Citriq : ".$error); 
}

Utilisation

Cette fonction prend comme seule valeur un tableau php (array) dont les clés sont les différents paramètres du widget Citriq. Sauf mention contraire, ils sont tous facultatifs. Notez que les noms des paramètres sont toujours en minuscules.

  • uid (obligatoire) : l’identifiant unique de la critique dans votre base ;
  • isbn (obligatoire) : le code IBSN du livre critiqué ;
  • excerpt : un extrait de la critique (jusqu’à 500 caractères) ;
  • reviewer : l’auteur de la critique (s’il y en a plusieurs sur le site) ;
  • source : support dont est issue la critique (si différent du site) ;
  • rating : permet d’indiquer une note (un entier, sur 100) ;
  • date : la date de publication de la critique ;
  • ignore : permet d’afficher le widget sans enregistrer la page en cours ;
  • debug : si ce paramètre facultatif est égal à 1, Citriq affichera des informations statistiques et un éventuel message d’erreur sur votre site.

La fonction retourne le code javascript du widget préparé qu’on peut récupérer dans une variable ou afficher immédiatement avec l’instruction echo.

Exemple

Ci-dessous, un exemple de code (fictif) qui permettrait de référencer la critique publiée sur cette page, pour le résultat sur cette page.

$params["uid"] = 3601;
$params["isbn"] = 9782277492830;
$params["excerpt"] = "Quand, voici quelques mois, les jeunes éditions Dystopia Workshop publièrent Le Prophète et le vizir, la surprise fut de taille. On ne s’attendait pas le moins du monde à voir le couple Rémy revenir à l’écriture et publier de l’inédit. Il avait eu une assez belle carrière dans les années 70, dont plus d’un se serait satisfait, mais il semblait qu’elle fût désormais de...";
$params["reviewer"] = "Jean-Pierre Lion";
$params["source"] = "Bifrost 71";
$params["rating"] = "80"; // Equivaut à 4 étoiles sur 5
echo citriq($params);

Exemple avec WordPress

Il est possible d’utiliser les champs personnalisés de WordPress pour faire générer automatiquement le code du widget Citriq par WordPress. On trouvera plus d’information à ce sujet dans l’article Automatiser le référencement de vos critiques avec WordPress.

MAJ du 08/02/2014 : il existe aussi une extension WordPress pour Citriq, qui utilise cette fonction php mais est beaucoup plus simple à mettre en oeuvre.

$params["uid"] = get_the_id(); // L'identifiant de l'article WordPress
$params["isbn"] = get_post_meta(get_the_id(), "isbn", true); // Le champ personnalisé "isbn"
$params["reviewer] = get_the_author(); // L'auteur de l'article WordPress
$params["excerpt] = get_post_meta(get_the_id(), "extrait", true); // Le champ personnalisé "extrait"
if(is_singular()) echo citriq($params);

Résolution des problèmes

Si le code du widget ne s’affiche pas correctement, vous pouvez utilisez le paramètre facultatif debug pour afficher un message d’erreur. Si vous ne comprenez pas le message d’erreur, n’hésitez pas à poser la question dans les commentaires ci-dessous.

Bonus : l’équivalent en Python (merci Joachim)

Le Bélial’, propulsé par Biblys 2.0

Créé en 2009, le site du Bélial’ est le premier a avoir été propulsé par le moteur Biblys (si l’on excepte la Librairie Ys pour qui le moteur avait été créé). Après son lancement, le site a beaucoup évolué pour répondre à de nouveaux besoins et parfois fait évoluer Biblys avec lui : le blog Bifrost, les forums, la plateforme numérique e-Bélial’, le référencement des critiques de Bifrost, la recherche par mot-clé thématique, etc.

Fin 2012, le site étant devenu lourd, labyrinthique et technologiquement obsolète, il nous a semblé que le moment était venu de travailler sur une nouvelle version. Lancé début mars, ce nouveau site fait du Bélial’ le premier éditeur propulsé par Biblys 2.0 !

En savoir plus sur Biblys.fr

La librairie Scylla, propulsée par Biblys 2.0

Depuis juin 2008 à fin 2012, c’est la Librairie Ys qui s’est chargée de commercialiser les livres d’occasion de Scylla. Mais depuis qu’Ys est retournée au fond des flots, il a fallu doter Scylla d’un nouveau site lui permettant de gérer en direct la vente par correspondance. Naturellement propulsé par Biblys, le site rappelle celui de la Librairie Ys mais propose aussi de nombreuses améliorations.

En savoir plus sur Biblys.fr

Biblys : nouvelle base Articles

Biblys

La base Articles est le cœur de Biblys : elle référence près de 40.000 œuvres avec des informations bibliographiques très détaillées, en grande majorité des livres papiers et numériques, mais aussi quelques CDs, DVD, produits dérivés, etc. Depuis la création de la librairie Ys en 2008, elle a beaucoup grossi mais peu évoluée, malgré des besoins croissants et de nouveaux sites utilisateurs (libraires, éditeurs, festivals, etc.). Ces derniers temps, elle était devenue lourde, peu ergonomique et technologiquement obsolète. Le mois d’août étant traditionnellement une période calme dans le monde du livre, j’en ai profité pour revoir entièrement la structure de la base, avec pour principaux objectif d’améliorer la vitesse d’affichage des pages et l’efficacité du moteur de recherche.

En savoir plus sur Biblys.fr

Les Imaginales 2012, propulsé par Biblys 2.0 !

imaginales.png

Créé en 2008 pour les besoins de la Librairie Ys, le logiciel Biblys s’est depuis grandement complexifié et a évolué pour devenir le moteur sous le capot de quelques autres sites de librairies, mais aussi d’éditeurs ou de festival comme les Imaginales. Fruit de ces besoins, de l’évolution en quatre ans des technologies et de mes propres compétences, la version 2 de Biblys est une réécriture complète du logiciel utilisant toutes sortes de technologies récentes avec un 5 dedans : PHP5, MySQL5, HTML5 mais aussi CSS3. L’objectif étant d’offrir de plus grandes performances et plus de liberté pour chacun des sites propulsés. Les sites déjà existant seront progressivement migrés au cours de l’année, mais le festival Imaginales 2012 est le premier site à utiliser Biblys 2.0.

En savoir plus sur Biblys.fr

La Librairie Charybde, propulsée par Biblys

charybde.png

Créé il y a plus d’un an maintenant, le site de la librairie Charybde, est désormais ouvert au public. Il permet aux clients de se tenir informé de l’actualité de la librairie, des évènements qu’elles organisent et de ses coups de coeur littéraires. Grâce à Biblys, il permet également aux libraires de la rue de Charenton de gérer leur stock, leur compatibilité, et même l’encaissement en magasin.

En savoir plus sur Biblys.fr