Email Service

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: (2e 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: (3e 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 ([email protected]) ou Carol Bonnefil ([email protected]), 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