Guide d’administration¶
Cette documentation couvre l’administration de l’application par les administrateurs.
Créer un compte administrateur¶
Il est conseillé de créer un compte dédié à l’administration, qui doit être utilisé avec la plus grande parcimonie.
Sur le serveur de production :
$ ./venv/bin/python manage.py createsuperuser
Adresse mail: admin@example.org
Password: •••••••••••••
Password (again): •••••••••••••
Superuser created successfully.
Utilisation du compte administrateur¶
L’accès à l’administration se fait à l’emplacement /admin.
Une fois connecté avec le compte administrateur, le CMS Wagtail est pleinement utilisable.
Note
À partir d’ici, nous recommandons fortement de découvrir la documentation de Wagtail avant de poursuivre.
Spécificités CMS de GvoT par rapport à Wagtail¶
Blocs éditoriaux¶
Les pages de base de GvoT tirent parti des streamfields pour leur contenu principal.
Vous pouvez dans toute page et dans tous scrutins ajouter les blocs éditoriaux suivants : titre, paragraphe, bouton, image, contenu embarqué.
Ces pages doivent vous permettre de publier tout contenu utile au tour du service : présentation, aide, accès à l’assistance, etc.
Gestion des scrutins dans GvoT¶
Ajout d’un index des scrutins¶
Avant de pouvoir ajouter des scrutins dans GvoT vous allez devoir ajouter une page de type « Liste des scrutins ». Cette manipulation sert simplement à définir le point d’ancrage pour les scrutin, dans l’arbre des page de Wagtail.
Il suffit de choisir un emplacement dans les pages, d’ajouter une page, choisir le bon type, donner un titre et publier.
Ajout d’un scrutin¶
Vous pouvez ajouter un scrutin via la liste des pages (dans le contexte de la « Liste des scrutins »), ou directement depuis le panel « Scrutins ».
Un scrutin possède de nombreux attributs dont les principaux sont dans l’onglet « détail ». Ces attributs sont documentés dans l’interface.
Le questionnaire du scrutin est paramétrable dans l’onglet « Questionnaire ».
Des détails techniques restent paramétrables dans les onglets « Promotion » et « Paramètres ».
Une fois le scrutin créé, des modèles de courriels sont créés et assignés au scrutin. Il est possible de les gérer dans le panel « Modèles de courriels ».
Ajout des pouvoirs¶
Un pouvoir est un droit de vote, pondéré, associé à un scrutin. Pour des raisons d’organisation on y adjoint les noms, prénom (ou bien nom du collectif, le cas échéant) et moyens de contact des participants.
Vous pouvez ajouter un pouvoir directement depuis le panel « Pouvoirs ».
Il est possible pour chaque pouvoir de définir des champs personnalisés. Ces champs sont exposés dans les modèles de courriel.
Note
La pondération défini le nombre de « bulletins » dont le votant dispose. Une personne votant une seule fois avec une pondération de 3 engendrera 3 bulletins au dépouillement. Une personne votant avec une pondération à zéro n’engendre aucun bulletin au dépouillement (utile pour les démonstrations).
Importation des pouvoirs¶
Vous pouvez démarrer une importation de pouvoirs, directement depuis le panel « Pouvoirs ».
Le format d’entrée doit être un fichier « CSV » dans un codage utf-8 ;
séparateur : « , » ; délimiteur de texte : « " » (doubles quotes). Un
exemple est proposé au téléchargement.
Les colonnes attendues sont : « nom », « prenom », « collectif » « courriel » et « ponderation ».
Les colonnes « nom », « prenom » et « collectif » ne peuvent être vides toutes à la fois. Dit autrement le pouvoir doit au moins désigner un nom, un prénom ou un nom de collectif.
La colonne « courriel » ne peut être vide. Plusieurs colonnes « courriel » peuvent être présentes.
Une pondération absente sera interprétée à la valeur « 1 ».
Une fois votre fichier téléversé, les entrées du fichier vont être validées unes à unes et les erreurs ou les alertes vous seront signalées. Une prévisualisation de l’importation vous sera également présentée.
C’est seulement après avoir validé la prévisualisation que l’import sera effectué.
Champs personnalisés¶
Si des colonnes supplémentaires existent dans le CSV à importer, celles-ci définissent des champs personnalisés dans les pouvoirs.
Modèles de courriels¶
Vous pouvez personnaliser vos modèles d’emails et en définir de nouveaux via le panel « Modèles de courriels ». Un modèle doit avoir un nom, être lié à un scrutin, et posséder un sujet et un contenu texte. Il est aussi possible d’associer un contenu HTML qui sera présenté au format multipart/alternative.
Syntaxe des modèles¶
Les différents champs qui composent le courriel peuvent tirer parti du moteur de gabarit de django. Sa documentation est accessible ici : https://docs.djangoproject.com/fr/3.0/ref/templates/language/
Le contexte des gabarits est notamment chargé avec les variables suivantes :
├── pouvoir
│ ├── uuid
│ ├── collectif
│ ├── nom
│ ├── ponderation
│ ├── prenom
│ ├── uri
│ ├── courriels.0
│ ├── courriels.1
│ ├── courriels.2
│ ├── ...
│ ├── champ_perso_1
│ ├── champ_perso_2
│ ├── champ_perso_3
│ ├── ...
│ └── scrutin
│ ├── id
│ ├── action
│ ├── confirmation
│ ├── first_published_at
│ ├── from_address
│ ├── go_live_at
│ ├── introduction
│ ├── last_published_at
│ ├── latest_revision_created_at
│ ├── live
│ ├── ouvert
│ ├── path
│ ├── pondere
│ ├── peremption
│ ├── prescription
│ ├── search_description
│ ├── seo_title
│ ├── slug
│ ├── subject
│ ├── title
│ ├── to_address
│ └── url_path
├── request
│ └── baseurl
└── settings
└── assistance
Champs personnalisés¶
Les champs personnalisés sont nommés à partir de l’intitulé. Celui-ci est transformé en minuscule, avec uniquement des caractères alphanumériques, et les mots sont séparés par des « _ ».
Par exemple :
« Téléphone » deviendra «
téléphone» ;« Téléphone mobile » deviendra «
téléphone_mobile» ;« Téléphone mobile + fixe » deviendra «
téléphone_mobile_fixe».
Liens HTML dans les modèles¶
Il est possible de créer un lien dont le texte ou la cible sera engendré par
le moteur de gabarit. Il faut pour cela passer par un « lien externe » et
renseigner un chemin d’uri relatif commençant par /.
Confirmations de votes¶
GvoT réserve pour chaque scrutin un modèle de courriel servant à la confirmation des votes auprès des participants. Ce modèle est éditable et peut être configuré dans l’onglet « Paramètres » du scrutin. Il est possible également de le supprimer ou le déconfigurer pour que les participants ne recoivent pas de confirmation.
Expédition d’un courriel¶
Vous pouvez envoyer un courriel à un participant, directement depuis le panel « Pouvoirs ».
Une fois les modalités d’envoi définies, une confirmation avec prévisualisation du mailing vous sera présentée.
C’est seulement après avoir validé la prévisualisation que l’expédition sera programmée.
Expédition d’un mailing¶
Vous pouvez démarrer un mailing d’annonce, directement depuis le panel « Pouvoirs ».
Il est possible de filtrer les destinataires concernés selon plusieurs critères : ayant voté ou non, ayant tel attribut défini ou non, à quelle valeur, etc.
Une fois les modalités d’envoi définies, une confirmation avec prévisualisation du mailing et de ses destinataires vous sera présentée.
Note
La prévisualisation nécessite que vous ayez renseigné les champs « prénom » et « nom » de votre profil d’utilisateur dans l’interface.
C’est seulement après avoir validé la prévisualisation que l’expédition sera programmée.