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 — récupère les sondages correspondant aux conditions données —
 * ApiQuerySurveySubmissions — récupère les réponses d'un sondage —
 * ApiQuerySurveyAnswers — récupère les réponses (une pour chaque champ de donnée dans un envoi) —

Ces modules permettent de demander des données seulement pour les utilisateurs disposant du droit de 'surveyadmin'. La documentation complète de ces modules d'API peut être trouvée à api.php dans votre wiki.

Version
Version 0.3.0 alpha is the attempt to bring this extension to compatibility with MediaWiki 1.23+.

The only cover up to version 2.0 at this point.

Internationalisation
Survey internationalisé complètement. La traduction de messages de Survey se fait à l'aide de translatewiki.net. On peut trouver la traduction pour cette version [//translatewiki.net/w/?title=Special:Translate&group=ext-survey ici]. Pour ajouter des langues ou modifier celles qui existent, il faut créer un compte sur translatewiki.net, puis demander la permission des administrateurs pour traduire une certaine langue ou certain groupe de langues à cette page (c'est un processus très simple). Une fois qu'on la permission pour une langue, on peut se connecter et ajouter ou modifier n'importe quel message dans cette langue.

Auteurs
Survey a été écrit par Jeroen De Dauw en tant que WikiWorks consultant pour the IEEE.