Documentation de Nabopoll, script PHP de gestion de sondages

• Installation
• Votre premier sondage
• Personnalisation
• Traduction et licence de ce document

Installation

Commencez par télécharger nabopoll, puis décompressez les fichiers dans un répertoire, en gardant la structure des répertoires. Uploadez tous les fichiers sur votre serveur Web. Si vous effectuez une mise à jour, il est recommandé de supprimer tous les (anciens) fichiers sur votre serveur Web et, bien sûr, de faire une sauvegarde de votre base de données.

Je vous recommande fortement de protéger le répertoire admin avec un fichier .htaccess…

Une fois que tout est uploadé, allez sur la page http://.../nabopoll/admin/install.php. Vous devriez voir un écran vous demandant les paramètres d'accès à votre base de données. Si un de ces paramètres est défini par une variable d'environnement, cliquez sur la case à cocher correspondante, nabopoll fera un getenv sur la variable pour obtenir la valeur réelle (par exemple, mon FAI me demande de me connecter au serveur défini par la variable d'environnement MYSQL_HOST).

Remplissez tous les champs et cliquez sur le bouton Suivant. Si vous faites un changement de version, on vous demande alors si vous voulez mettre à jour votre version ou réinstaller à partir de zéro la nouvelle version. Si vous n'avez jamais installé nabopoll auparavant alors l'installation à partir de zéro doit être la seule option disponible. Assurez-vous d'avoir une sauvegarde de votre base de données dans tous les cas, avant de poursuivre.

Sélectionnez l'option appropriée. La procédure d'installation doit maintenant effectuer toutes les modifications nécessaires dans votre base de données pour terminer l'installation. Tout doit fonctionner correctement (j'espère…) et vous pouvez maintenant utiliser nabopoll.

Haut de page

Votre premier sondage

Maintenant, allez à l'adresse suivante : http://.../nabopoll/admin/index.php et vous pouvez créer maintenant un nouveau sondage, ajouter des questions et des réponses types et bien sûr modifier à peu près tout. La signification des icônes que vous trouverez dans l'interface d'administration (j'utiliserai le terme "item" pour désigner, de manière générale, un sondage, une question ou une réponse type - l'item courant étant celui qui se trouve sur la ligne sur laquelle vous cliquez sur l'icône) est donnée ci-dessous :

Signification des icônes

Icône	Action
	Ajoute un item dans la base de données. Avant de cliquer, modifiez le nouvel item sur la gauche de cet icône.
	Valide les modifications que vous avez effectuées sur l'item courant.
	Supprime un item. Pas de confirmation demandée !
	Insère un item vide devant l'item courant.
	Déplace l'item courant vers le haut dans la liste courante.
	Déplace l'item courant vers le bas dans la liste courante.
	Descend d'un niveau : sur la page des sondages, cela vous permet de modifier les questions du sondage courant ; sur la page des questions, cela vous permet de modifier les réponses types à la question courante.
	Cela vous permet de remettre à zéro les résultats du sondage courant.
	Cela vous permet de voir les résultats du sondage courant.
	Cela vous permet de voir l'historique des réponses faites pour le sondage courant.

Vous avez différentes options pour un sondage :

• Vote unique ("Single vote") : permet à, ou empêche, une même personne de voter plusieurs fois à un sondage. La vérification peut être effectuée à l'aide de cookies ou d'une méthode basée sur les adresses IP
• Log : permet l'enregistrement de toutes les réponses faites pour le sondage. Vous serez capable de vérifier exactement ce que chaque votant répond à chaque question
• Oblig. ("Required") : Si c'est coché, alors un votant doit répondre à toutes les questions du sondage
• Clos ("Closed") : aucun nouveau vote ne peut être enregistré pour ce sondage

Une fois que votre sondage est prêt, vous pouvez y accéder par l'URL suivante : http://.../nabopoll/vote.php?surv=1 (bien sûr, vous pouvez remplacer 1 par le numéro de votre sondage).

Pour un sondage rapide à inclure dans votre page d'accueil par exemple, incluez le fichier quickpoll.php où vous voulez dans votre page. Regardez test/test.php pour un exemple d'inclusion et mettez à jour les variables (vous devriez avoir besoin de modifier la variable $path)…

Si vous voulez toutes les questions de votre sondage, utilisez http://.../nabopoll/vote_1page.php?surv=1 à la place.

Haut de page

Personnalisation

Vous pouvez personnaliser la présentation de vos sondages pour correspondre à votre charte graphique. Nabopoll utilise des modèles à cette fin. Un modèle est un ensemble de fichiers html définissant la façon dont nabopoll doit présenter vos sondages. Deux modèles sont fournis : classique ("classic") et compact (utilisé pour les sondages rapides). Vous pouvez les modifier ou en créer de nouveaux en créant un nouveau sous répertoire dans le répertoire templates. Placez y tous les fichiers .tpl listés ci-dessous (vous pouvez copier ceux du modèle classic et les modifier). Uploadez ce nouveau répertoire sur votre serveur Web et votre modèle est automatiquement détecté par nabopoll et prêt à l'emploi ! Vous pouvez créer autant de modèles que vous voulez.

Vous trouverez ci-dessous une explication sur l'utilisation de chaque fichier :

Les fichiers modèles et leur utilisation

Fichier	Utilisation
header.tpl	En-tête commune à toutes les pages. En général, ouvre les tags html et définit la présentation graphique.
footer.tpl	Pied de page commun à toutes les pages. Ferme ce que header.tpl ouvre…
vote.tpl	Page de vote standard affichant une question et ses réponses.
survey_end.tpl	Message affiché après que l'utilisateur a répondu à la dernière question du sondage.
result.tpl	Pour afficher les résultats d'un sondage.
error.tpl	Page d'erreur.

Dans tous ces fichiers, vous avez juste à utiliser des tags (marqueurs) simples (comme {QUESTION_TEXT}) pour afficher les données de votre sondage. Regardez svp les fichiers du modèle classique pour connaître tous les tags disponibles dans chaque fichier et leur utilisation. Pour vote.tpl et result.tpl, tout ce qui est entre <!-- ANSWER START --> et <!-- ANSWER END --> sera répété pour chaque réponse à la question.

Vous pouvez également personnaliser les images utilisées dans votre modèle dans l'interface d'administration. La première image est le bouton de vote affiché après chaque question. Les trois images suivantes sont utilisées pour afficher les barres. En général, ce sont des images de taille 1x1. Vous pouvez créer vos propres images si vous voulez utiliser d'autres couleurs que celles proposées.

Haut de page

Traduction et licence de ce document

Traduction française : Hervé Chuzeville (www.chuzeville.com).
Ce document est mis à disposition selon le Contrat "Paternité-NonCommercial-ShareAlike 2.0 France" disponible en ligne http://creativecommons.org/licenses/by-nc-sa/2.0/fr/ ou par courrier postal à Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.