Guide d’administration

Ce guide vise les administrateurs qui veulent savoir comment créer des votes, des questions et des réponses sur django-voting-app.

Toutes les opérations décrites ci-dessous peuvent être faites sur l’interface d’administration (accesible avec l’url /admin ou en cliquant survotre pseudo puis sur Admin).

Creation des votes, questions et réponses

Votes

Vous pouvez créer des votes sur l’interface d’aministration. Vous devez spécifier :

• un nom

• une date de début

• une date de fin

• oui si les votants doivent être affichés sur la page de résultats

• oui si les résultats doivent être publics (qui peuvent être vus par des personnes non staff)

Avertissement

L’option see_voters est éditable à la création du vote et ne sera pas éditable après.

Optionnellement, vous pouvez ajouter :

• une description

• des restrictions relatives aux groupes

• des traductions pour certains champs (voir le paragraphe correspondant)

Les restrictions sur un vote spécifique sont faites en utilisant des groupes. Si vous renseignez un ou plusieurs groupes, l’utilisateur doit être dans un des groupes au moins pour avoir accès au vote. Si vous ne spécifiez aucun groupe, tous les utilisateurs actifs auront accès au vote.

Les utilisateurs non actifs me peuvent pas se connecter à l’interface.

Un vote est accessible à un utilisateur si les trois conditions suivantes sont réunies :

• le vote a commencé (i.e. la date de départ est passé) et n’est pas fini (i.e. la date de fin n’est pas passé).

• le vote est prêt (voir la estion correspondante).

• le votant a le droit de vote pour ce vote (i.e. il n’a pas encore voté et les conditions sur les groupes sont remplies).

Questions

Pour chaque vote, vous pouvez créer un nombre illimité de questions. Sur la page de vote, chaque questions sera affichée et le votant devra choisir une unique réponse pour chaque question.

Note

Si vous voulez que vos utilisateurs puissent passer une question, vous pouvez toujours créer une réponse « Ne se prononce pas »

Vous pouvez créer des questions sur le panneau d’administration. Vous devez spécifier :

• a un vote lié

• un texte, qui est la question

Optionnellement, vous pouvez ajouter :

• des traductions pour certains champs (voir la section correspondante)

Une question doit être liée à un unique vote.

Avertissement

C’est une mauvaise idée de changer le vote d’une question après (après que vote ait commençé pour être précis). Vous aurez des mauvais résultats si vous le faites.

Questions

Pour chaque question, vous pouvez créer un nombre illimité de réponses. Les votants pourront selectionner une seule réponse par question.

Vous pouvez créer des réponses sur le panneau d’aministration. Il faut spécifier :

• la question liée

• la réponse

Optionnellement, vous pouvez ajouter :

• des traductions pour certains champs (voir le paragraphe correspondant).

Une réponse doit être liée à une unique question.

Avertissement

C’est une mauvaise idée de changer une question ou une réponse après coup (après que le vote ait commencé pour être précis). Vous aurez des faux résultats si vous le faites.

Documents

Les documents sont des fichiers pour aider les personnes à votes. Ils sont affichés sur la page de vote.

Pour chaque vote, il est possible de lier u nombre illimité de documents. Un document lui est lié à un unique vote.

Vous pouvez créer les documents sur le panneau d’administration. Il faut spécifier :

• un vote

• un nom

• un fichier

Optionnellement, vous pouvez ajouter :

• des traductions pour certains champs (voir la section correspondante)

Être prêt

Un vote ne commençera pas s’il n’est pas prêt. En vérité un vote non prêt ne sera même pas affiché sur la liste des votes disponibles.

Lorsqu’un vote est rendu prêt, il ne doit plus subir aucune modification. L’app empêchera certaines des modifications mais pas toutes.

Lorsqu’un vote a été rendu prêt, il n’est plus possible de revenir en arrière (il faut le supprimer et recommençer).

Pour rendre un vote prêt, il est possible d’utiliser l’action dans lepanneau d’administration ou d’aller sur l’index administratifs des votes.

Voir les résultats

Selon la valeur du paramètre VOTE_SEE_BEFORE_END, il sera possible de voir les résultats en temps réel ou seulement après le vote.

Il est possible de voir les résultats de tous les votes sur la page correspondante.

Seuls les administrateurs peuvent voir les résultats.

Un point sur les traductions

Certains champs peuvent être traduits dans d’autres langues. Par défaut, vous pouvez traduire dans les langues supportées par django-voting-app, soit :

• en (Anglais)

• fr (Français)

Si vous voulez plus (ou moins) de langues, vous pouvez modifier la valeur de MODELTRANSLATION_LANGUAGES.

Les champs suivants peuvent être traduits :

Modèle	Champs traduisibles
Vote	nom, description
Question	texte
Réponse	réponse
Document	nom, document

Création dynamique de votes

En plus de la documentation précédente, il est possible depuis la version 1.3.0 de créer un vote, les questions, les répones et les documents avec un unique formulaire.

Cette page est accessible seulement par des admins. Les remarques sont les mêmes que précedemment.

Avertissement

Cette fonctionnalité est marquée comme expérimentale sur les versions 1.3.0 et suivantes.