Retrouvez cet article dans : Linux Pratique 40

Il s'agit d'un gestionnaire de sondages écrit en PHP et doté de plusieurs fonctionnalités intéressantes, parmi lesquelles une installation automatique, la possibilité de mettre en place un nombre illimité de sondages ou de réponses à ceci, une interface gestion très complète et des archives des anciens sondages.Ces fonctionnalités, ainsi que sa facilité d'emploi, en font un gestionnaire de sondages très prisé par les webmestres en quête d'outils conviviaux, faciles d'installation et d'emploi. Qui plus est, @lex Poll permet l’installation de thèmes, au travers d'un gestionnaire de skins, ce qui le rend facile à intégrer dans le design de votre propre site.

Installation

La première étape de l'installation consistera à vous rendre sur http://www.alexphpteam.com/ pour télécharger le script. Pour cela, choisissez @lex Poll 2.1 dans le menu latéral gauche, dans la catégorie Les Scripts. Au pied de l'écran de présentation du script, cliquez sur le lien TÉLÉCHARGER et le tour est joué : vous voilà désormais en possession d'une archive nommée alex_poll2.zip que vous pouvez décompresser avec votre outil préféré.
Une fois ceci fait, chargez via un outil FTP le répertoire alex_poll2 ainsi que son contenu sur votre propre espace web, par exemple à la racine de celui-ci. Puis, depuis votre navigateur, exécutez le script setup.php par exemple en saisissant l'URL suivante :
http://www.votresite.com/alex_poll2/setup.php
L'installation du gestionnaire est alors automatique. Vous arrivez immédiatement sur une page vous invitant à choisir la langue d'installation du script. Bien sûr, dans le menu déroulant, choisissez français.

Fig. 1 : Choix de la langue d'installation

L'écran suivant demande à l'utilisateur diverses informations qui vont permettre au script de se configurer seul tout en assurant la création des entrées nécessaires dans la base de données. À moins d'avoir des besoins spécifiques, vous passerez sans les modifier sur les rubriques Nom des tables et Extension du script. En revanche, vous accorderez une attention particulière à la rubrique Identifiants Base de données.

• Type de base utilisée : ce script fonctionne avec de nombreuses bases de données, parmi lesquelles: MSACCESS, MSSQL-ODBC, MSSQL, MySQL, ODBC, ORACLE, POSTGRE7. Par exemple, chez Tuxfamily, vous pouvez faire usage d'une base de type MySQL.
• Host : saisissez ici le host du serveur de données; dans le cas de Tuxfamily, ce sera un simple sql.
• Utilisateur : saisissez ici l'identifiant d'un utilisateur ayant des droits de création sur la base de données.
• Mot de passe : sans surprise, saisissez le mot de passe correspondant à l'utilisateur précédent.
• Nom de la base de données : si vous avez plusieurs bases de données, saisissez ici le nom de la base dans laquelle les tables d'@lex Poll vont être créées.

Fig. 2 : L'écran de saisie des données qui permettront l'installation automatique

Les tables sont désormais prêtes à être créées, mais il vous reste encore à choisir les identifiants d'administration du gestionnaire. Rendez-vous pour cela dans la dernière rubrique de la fenêtre : Identifiants d'accès à la partie administration. Choisissez un nom d'utilisateur et un mot de passe (que vous répéterez par mesure de sûreté).
Et voilà, c'est fini, vous n'avez plus qu'à cliquer sur le bouton Installer ! Vous penserez bien évidemment, en faisant usage de votre outil FTP, à supprimer le fichier setup.php qui a servi à lancer cette procédure d'installation automatique. Tant que vous y êtes, vérifiez que le script ait des droits de lecture, d'écriture et d'exécution sur le répertoire config/.

Fig. 3 : Mention de succès

Utilisation d'@lex Poll

Une fois le gestionnaire de sondage installé, vous pouvez accéder à l'interface de gestion en saisissant l'URL suivante dans votre navigateur : http://www.votresite.com/alex_poll2/admin/
Vous aboutissez alors à un gestionnaire de connexion, qui vous invite à saisir l'identifiant et le mot de passe définis lors de l'installation.

Fig. 4 : Une fenêtre de connexion classique

L'interface qui se présente est d'un grand classicisme, avec un écran principal et un menu latéral à gauche, divisé en plusieurs catégories.

• Options : cette partie permet de spécifier les options générales ou techniques du script ; il est probablement plus sage de ne pas les modifier, à moins de savoir ce que vous faites.
• Sondage : cette partie donne l'accès à trois interfaces différentes ; la première permet de créer un nouveau sondage ; la deuxième, de gérer les sondages existants ; et enfin, la troisième, de créer des rubriques de sondages, permettant de proposer des sondages indépendants par rubrique propre de
  votre site.
• Skins : cette partie permet de personnaliser les thèmes d'affichage des sondages, des fenêtres pop up, ainsi que des archives de sondage.
• A propos de... : cette dernière partie permet de consulter la documentation rédigée par l'auteur (avec une courte Foire aux Questions) ou de laisser un message dans le Livre d'Or du site.

Découverte de l'espace sondage

En cliquant sur le lien Nouveau de la rubrique Sondage, vous aboutissez directement sur la première page de définition d'un Nouveau Sondage. Un champ numérique vous permet de saisir le nombre de réponses possibles, avant de passer à
l'étape suivante.

Fig. 5 : Étape 1, définition préliminaire du nombre de réponses possibles au sondage

Dans l'étape suivante, vous spécifierez les réponses que vous souhaitez autoriser pour votre sondage. Dans la partie inférieure de l'écran, vous spécifiez explicitement grâce à un bouton radio si vous autorisez ou non les réponses multiples. Vous pouvez également spécifier une période temporelle de validité du sondage, sachant qu'en cochant la case pas de limite dans la durée, la période au cours de laquelle il est possible de répondre est prolongée indéfiniment. La dernière rubrique Statut permet de définir si le sondage est Actif (si oui, il est possible de préciser la rubrique de votre site concernée), s'il est indépendant, ou s'il est à placer dans les archives.
Il ne vous reste plus alors qu'à utiliser Enregistrer ce nouveau sondage pour le valider. Bien sûr, vous n'oublierez pas de choisir l'un des skins possibles pour le sondage. Une fois la procédure terminée, le script vous informe sur le code PHP à insérer dans une page qui portera obligatoirement l'extension .php :

Fig. 6 : Création des questions et des réponses possibles

<?php
unset($id_rubrique_apoll2, $id_poll_apoll2, $voter_apoll2);
$id_poll_apoll2 = 1;
$chem_script_apoll2 = "{CHEMIN}";
include($chem_script_apoll2."poll.php");
?>

Il vous faudra toutefois remplacer {CHEMIN} par le chemin relatif approprié, depuis la page contenant ce script jusqu'au répertoire alex_poll2/. Attention, malgré la trivialité apparente de cette information, il s'agit du principal écueil à l'usage de ce gestionnaire. Ainsi, supposons que vous avez placé ce code dans un fichier sondage.php, placé dans un sous-répertoire sondage/ du répertoire du gestionnaire alex_poll2/. L'arborescence du site serait quelque chose comme :

racine
	|_ alex_poll2/
		|_ admin/
		|_ config/
		|_ db/
		...
		|_ sondage/
			sondage.php
		|_ templates/

{CHEMIN} devra donc être tout simplement remplacé par ../ pour remonter jusqu'au répertoire parent alex_poll2/.

Si vous avez choisi un skin en pop up, le sondage apparaîtra dans une petite boîte flottante. Sinon, il apparaîtra au sein de la page sondage.php.

Fig. 7 : Un bout de code à coller dans une page qui sera impérativement du .php !

Si vous ne parvenez pas à trouver le {CHEMIN} qui convient à votre architecture de site, n'hésitez pas à visiter les forums officiels : http://www.alexphpteam.com/phpbb/. La question y a été posée maintes fois. Avec un minimum de bonne volonté, vous devriez y arriver sans trop de problème...

Fig. 8 : Avec l'un des thèmes par défaut, un aperçu de votre premier sondage

Gestion des sondages et des rubriques

Le lien Gestion des sondages de la rubrique Sondage mène, sans surprise, à une petite interface d'administration, permettant de visualiser les questions des sondages. Pour chacun d'eux, il est proposé de les supprimer (en cochant une case et en cliquant sur le bouton Supprimer les sondages sélectionnés) ou de les modifier en cliquant sur le lien (rouge) correspondant. Le statut du sondage (actif, indépendant ou archives) est également mentionné.
En cliquant sur modifier, vous aboutissez à une nouvelle interface, qui n'est pas sans rappeler l'étape 2 de la création de votre sondage. Elle permet, en plus d'éditer les titres et réponses déjà saisis, d'ajouter de nouvelles réponses, de réinitialiser tout ou partie des nombres de vote pour chaque réponse, voire de forcer les valeurs à un nombre donné. Bien sûr, le code à insérer dans votre page.php est également rappelé, dans le cas où vous auriez malheureusement oublié de copier/coller celui-ci lors de la création du sondage. Enfin, il est possible d'ajouter des Commentaires dans le champ approprié : ils ne seront visibles que lorsque le sondage sera archivé.
Pour sa part, le lien Gestion des rubriques permet de créer des rubriques différentes de sondage (idéalement, une par rubrique existante dans votre site). Lorsque vous créerez un sondage actif, vous pourrez en préciser la rubrique et insérer le code approprié dans la page de sondage de la rubrique correspondante de votre site. Sans modifier le code présent sur cette page, à chaque fois que vous changerez le sondage actif de la rubrique, la page sera actualisée avec le sondage en question, sans intervention supplémentaire de votre part.

Fig. 9 : Le gestionnaire des sondages

Fig. 10 : Le gestionnaire des sondages

Bien sûr, après avoir voté, un visiteur voit les statistiques relatives à chaque réponse, avec le nombre total de votes. Il remarquera certainement un lien Archives qui conduira à une page regroupant tous les sondages passés, avec les résultats de chacune des questions, et, bien sûr, les commentaires du gestionnaire du sondage.

Conclusion

A part la subtilité relative au {CHEMIN} qui peut dérouter les apprentis webmestres et les débutants en informatique, @lex Poll est un gestionnaire de sondages mature et efficace, ainsi qu'en témoigne sa longue existence sur la Toile et les nombreuses évolutions du script. Les designers de site apprécieront la possibilité de créer des thèmes indépendants pour les sondages, les fenêtres pop up et les archives, et les webmestres apprécieront l'aisance de la création d'un nouveau sondage et de son archivage. Les débutants, quant à eux, apprécieront n'avoir quasiment rien à faire pour l'installer.

Liens

• Page du projet @lex Poll : www.alexphpteam.com/alex_sondage.php
• Page d'accueil de l'alexPHPteam : www.alexphpteam.com/
• Le forum d'aide : www.alexphpteam.com/phpbb/index.php?c=2

Retrouvez cet article dans : Linux Pratique 40