Extension:Survey/fr

À propos
Survey est une extension MediaWiki permettant aux administrateurs de créer des sondages qu'on peut alors soumettre à un groupe spécifié d'utilisateurs.

Vue d'ensemble des fonctionnalités

 * les sondages sont présentés aux utilisateurs du wiki à l'aide d'un beau formulaire surgissant.
 * On peut créer des sondages et les modifier à l'aide d'un tableau de bord administratif (Special:Surveys).
 * On peut présenter les sondages à des types d'utilisateurs spécifiques (logés, anonymes, éditeur, confirmé, ...)
 * On peut présenter les sondages à un pourcentage défini d'utlisateurs, et seulement après une certaine quantité de pages visitées.
 * Les questions des sondages peuvent avoir différents types d'entrées, dont certaines autorisent à restreindre les réponses.
 * Les administrateurs peuvent tester les sondages grâce à Special:TakeSurvey sans que ceux-soient activés dans le wiki.
 * On peut accéder à un résumé des réponses aux sondages à Special:SurveyStats.
 * les données soumises au sondages (i.e. les réponse des utilisateurs) peuvent être exportées à l'aide d'une API.

Prérequis
Pour un sondage, il faut :


 * MediaWiki 1.17 ou plus
 * PHP 5.3 ou plus

Téléchargement
On peut trouver la version courante de Survey sur Google Code download page, et aussi à cette liste de miroirs.

Installation
Une fois qu'on a téléchargé le code, placer le répertoire Survey dans le répertoire 'extensions' de votre MediaWiki. Ajouter ensuite le code suivant dans le fichier LocalSettings.php :

La dernière étape consiste à lancer le script de mise à jour de MediaWiki 'update.php', qu'on peut trouver dans le répertoire de maintenance de son installation de MediaWiki. En ligne de commande, on fait typiquement de la façon suivante :

Configuration
On configure Survey en affectant une valeur à la variable $egSurveySettings dans son fichier LocalSettings.php. Les options sont listées ci-dessous et leurs valeurs par défaut sont déclarées dans le fichier des réglages de Survey.

Il ne faut PAS modifier le fichier de réglages, mais l'examiner pour voir comment utiliser ces réglages, dans le cas où les descriptions ci-dessous seraient insuffisantes.

Voici des exemples de façon de modifier un réglage :

Réglages disponibles :

Utilisation
Cette section est destinée aux administrateurs de site qui veulent créer et maintenir des sondages. Pour les utilisateurs l'utilisation des sondages est censé être intuitif.

Création et rédaction de sondages
On peut créer, rédiger et détruire des sondages à Special:Surveys quand on dispose du droit 'survey admin', accordé aux sysops par défaut seulement.

Test des sondages
On peut tester les sondages en cliquant sur le nom du sondage ou sur "take this survey" dans l'interface d'administration. Cela va à la page Special:TakeSurvey, qu'on peut utiliser pour tester le fonctionnement de sondages. On peut renvoyer le sondage aussi souvent qu'on veut. Seuls les utilisateurs avec le droit 'survey admin' ont accès à cette page.

Déploiement des sondages
UNe fois qu'un sondage est activé, il est déployé dans la totalité du wiki pour tous les utilisateurs satisfaisant aux critères. Ces utilisateurs devront alors visiter un nombre minimum de pages avant que le sondage ne soit activé, et à ce moment un tirage au sort est effectué, pour assurer qu'un pourcentage spécifié d'utilisateurs passe le sondage.

Si on veut au contraire déployer un sondage sur une ou plusieurs pages spécifiques, il faut inclure le tag dans chacune. Il faut l'appeler de la façon suivante :



l'ID doit correspondre à l'ID du sondage, qui est la chaîne apparaissant après "Special:TakeSurvey/". Les autres attributs correspondent chacun à des réglages de Special:EditSurvey.

Notez bien que l'utilisation du tag 'survey' est expérimentale et pourrait ne pas fonctionner dans certaines situations.

Garder un trace des sondages
On peut trouver un résumé des sondages à Special:SurveyStats, qui est lié à l'interface d'administration. Cette page n'est accessible qu'aux utilisateurs disposant de la permission 'survey admin'.

Exportation des données à l'aide de l'API
Survey permet d'exporter les sondages et les données des réponses à l'aide de l'API de MediaWiki avec ces trois modules d'API :


 * ApiQuerySurveys — get the surveys matching the provided conditions —
 * ApiQuerySurveySubmissions — get the submissions for a survey —
 * ApiQuerySurveyAnswers — get the answers (there is 1 for each field in a submission) —

These modules can only be used to query data by people that have the surveyadmin right. Full documentation for these API modules can be found at api.php on your wiki.

Version
This is a copy of the release notes file on SVN, which might be more up to date then this page.

Version 0.1.2
2011-11-14


 * Fixed issue with database index names causing update.php to fail when running after installation of Survey.
 * Fixed several IE JavaScript issues.
 * Added missing action- messages.

Version 0.1.1
2011-09-18


 * Restricted access to survey statistics via the API to survey admins.

Version 0.1
2011-09-13

Initial release with these features:


 * Surveys get displayed to wiki users using a nice pop-up form.
 * Surveys can be created and modified via an admin panel (Special:Surveys).
 * Surveys can be shown to specific types of users (logged in, anonymous, editor, confirmed, …)
 * Surveys can be shown for a specified percentage of users, and only after a certain amount of page views.
 * Survey questions can have different types of inputs, of which some allow restricting answers.
 * Surveys can be tested by admins via Special:TakeSurvey without them being live on the wiki.
 * Summaries of survey submissions can be found on Special:SurveyStats.
 * The survey submission data (i.e. user answers) can be exported via an API.

Internationalization
Survey is fully internationalized. Translation of Survey messages is done through translatewiki.net. The translation for this extension can be found [//translatewiki.net/w/?title=Special:Translate&group=ext-survey here]. To add language values or change existing ones, you should create an account on translatewiki.net, then request permission from the administrators to translate a certain language or languages on this page (this is a very simple process). Once you have permission for a given language, you can log in and add or edit whatever messages you want to in that language.

Auteurs
Survey has been written by Jeroen De Dauw as WikiWorks consultant for the IEEE.