Héberger plusieurs Qwidgets Guide version 2 Création: 5 septembre 2013 Contenu I. Fonctionnement... 2 II. Qwidget version 4 (publié le 25 août 2013)... 2 III. Qwidgets plus anciens... 3 A. Analysez la page ou des pages qui hébergeront les Qwidgets supplémentaires... 3 IV. Modification du code du Qwidget original ou d une copie de Qwidget (publié avant octobre 2012)...3 A. Identifiez le code du Qwidget original... 3 B. Modifiez le code du Qwidget original... 4 C. Ajoutez le snippet javascript additionnel... 4 VI. Insertion de Qwidgets publiés entre octobre 2012 et août 2013... 5 VI. Assistance... 5
I. Fonctionnement Jusqu à 5 Qwidgets de QuestionPoint peuvent être ajoutés dans une même page Web. Les Qwidgets peuvent être une combinaison de snippets de Qwidgets existants, de nouveaux snippets, ou des copies de snippets. Chaque Qwidget dans la page (existant ou nouveau) doit contenir un identificateur unique comme décrit ci-dessous, dans le code du snippet. II. Qwidget version 4 (publié le 25 août 2013) Si votre Qwidget a été créé ou mis à jour le, ou après le, 25 août 2013, il s'agit d'un Qwidget version 4 (qwidgetv4) et son code source sur votre page Web ressemblera à ceci : Figure 1: Qwidget version 4 Votre tâche sera plus facile! Le code du snippet contient déjà (dans le haut du snippet) le code javascript nécessaire (voir Figure 1) : <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.8.0/jquery.min.js" type="text/javascript" ></script> Suivez les instructions mentionnées dans le code et utilisez un identifiant unique pour chaque snippet de Qwidget comme illustré à la Figure 2. Figure 2: Instructions pour le Qwidget version 4 Page 2
III. Qwidgets plus anciens Si le code de votre Qwidget ne contient pas «qwidgetv4», suivez les instructions dans la section IV ou la section V de ce guide selon la version de votre Qwidget. Chaque page doit contenir un nouveau script additionnel afin de permettre l affichage de plusieurs Qwidgets. A. Analysez la page ou des pages qui hébergeront les Qwidgets supplémentaires Si un Qwidget de QuestionPoint est déjà affiché dans votre ou vos pages cibles, il y a de fortes chances que ce Qwidget ne contienne pas encore un identifiant unique. Vous devez donc déterminer comment ce Qwidget est implanté sur votre page cible. Quel est la version du Qwidget et comment est-il implanté? Est-il dans une bannière ou dans un menu latéral affiché dans une ou plusieurs pages du site Web, ou est-il intégré directement dans la page cible? Si le Qwidget est dans une bannière ou dans un menu latéral affiché dans plusieurs pages, localisez la page qui contient le snippet du Qwidget et modifiez d abord le code, en utilisant normalement le chiffre «1» comme identifiant unique pour le Qwidget original comme décrit dans les étapes de configuration ci-dessous. Une fois que ce Qwidget potentiellement «omniprésent» a été identifié par le chiffre 1, ce chiffre ne peut plus être utilisé pour d autres Qwidgets. Si le Qwidget n'est pas dans une section «réutilisée» de la page (comme une bannière ou un menu latéral), modifiez le code du Qwidget existant dans la page cible même. Encore une fois, en utilisant normalement le chiffre «1» comme identifiant unique pour le Qwidget original comme décrit dans les étapes de configuration ci-dessous. IV. Modification du code du Qwidget original ou d une copie de Qwidget (publié avant octobre 2012) A. Identifiez le code du Qwidget original Il y a actuellement trois formats de code acceptés pour les Qwidgets existants. Figure 3: (1 ère génération de code pour Qwidget lancé en 2006.) Page 3
Figure 4: (2 e génération de code pour Qwidget lancé en 2008) B. Modifiez le code du Qwidget original Peu importe le type de code de votre Qwidget original, vous devez insérer les 2 lignes de code suivantes à l intérieur du code du Qwidget original, remplaçant le X rouge par un chiffre unique entre 1 et 5 (normalement, vous nommeriez le Qwidget original «1») : 1. <div id="qpchatwidget" qwidgetno="x" ></div> [inséré au début du snippet du Qwidget original]; 2. qwidgetno="x" [inséré dans le corps du code du Qwidget]. Le code pour votre Qwidget original devrait maintenant ressembler à ceci : Figure 5 Notez l insertion de l option 2 comme élément dans le corps du code. C. Ajoutez le snippet javascript additionnel Un snippet javascript additionnel doit également être ajouté dans les pages Web contenant des Qwidgets de version 1 ou 2 : <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.8.0/jquery.min.js" type="text/javascript" ></script> REMARQUE : 1. Ce script ne doit apparaître qu une fois dans chaque page cible, peu importe le nombre de Qwidgets (de 1 à 5) apparaissant dans la page. Page 4
VI. Insertion de Qwidgets publiés entre octobre 2012 et août 2013 Si vous insérer le snippet d'un Qwidget créé après le 13 octobre 2012 mais avant le 25 août 2013 (version 3), il contiendra du code additionnel qui devra être inclus au moins une fois dans la page cible, et il aura un numéro de Qwidget que vous devez modifiez en remplaçant le «1» par un chiffre de 2 à 5. Le nouveau code qui doit être ajouté est déjà inclus à la Figure 6 ci-dessous. Ce code est : <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.8.0/jquery.min.js" type="text/javascript" ></script> Figure 6: (3 e génération de code pour Qwidget publié après le 10 octobre 2012 et avant le 25 août 2013) VI. Assistance Avant de mettre votre page avec Qwidgets multiples en application, nous vous recommandons de la tester pour vous assurer que le code nécessaire a été ajouté. Si tout le code a bien été ajouté, vous devriez voir tous les Qwidgets dans la page. Si le code est incorrect, aucun des Qwidgets n apparaîtra. Si vous avez des difficultés à installer 2 Qwidgets ou plus dans une seule page, veuillez contacter David Leslie (leslied@oclc.org) ou Carol Bonnefil (bonnefic@oclc.org), et faites-leur parvenir votre page HTML contenant les Qwidgets, comme vous l avez créée, afin de leur permettre d examiner le code et d identifier le problème. Page 5