Skip to content

Commit

Permalink
Correction de la documentation sur les membres (#4147)
Browse files Browse the repository at this point in the history
* Correction de l'orthographe de la doc sur les membres

* Nouvelle orthographe

* Une correction en plus
  • Loading branch information
Guillaume authored and pierre-24 committed Jan 15, 2017
1 parent 7d66a6c commit 3de5950
Showing 1 changed file with 36 additions and 36 deletions.
72 changes: 36 additions & 36 deletions doc/source/back-end/member.rst
Expand Up @@ -7,7 +7,7 @@ Inscription

L'inscription d'un membre se déroule en deux phases :

- Le membre crée son compte et fournit un pseudo, un mot de passe et une adresse mail valide.
- Le membre crée son compte en fournissant un pseudo, un mot de passe et une adresse mail valide.
- Un mail de confirmation est envoyé avec un jeton qui permettra d'activer le compte.

.. attention::
Expand All @@ -19,7 +19,7 @@ L'inscription d'un membre se déroule en deux phases :
Désinscription
==============

L'inscription se fait via l'interface utilisateur.
La désinscription se fait via l'interface utilisateur.

- Le lien de désinscription est accessible via paramètres (``/membres/parametres/profil/``) puis “Se désinscrire” dans la barre
latérale (``/membres/desinscrire/avertissement/``) :
Expand All @@ -29,7 +29,7 @@ L'inscription se fait via l'interface utilisateur.

Position du lien de désinscription dans les paramètres du membre (``/membres/parametres/profil/``)

- Le lien mène alors vers une page expliquant les conséquences de sa désinscription. Il peut alors poursuivre via un bouton en bas de celle-ci :
- Le lien mène alors vers une page expliquant les conséquences de sa désinscription. Il peut alors poursuivre via un bouton en bas de celle-ci :

.. figure:: ../images/member/desinscription-2.png
:align: center
Expand All @@ -45,9 +45,9 @@ L'inscription se fait via l'interface utilisateur.
La dernière étape


Le clic sur "me désinscrire" entraîne alors une série d'action (qui sont **irréversibles**) :
Le clic sur "Me désinscrire" entraîne alors une série d'action (qui sont **irréversibles**) :

- Suppression du profil, libèrant le pseudo et l’adresse courriel pour les futures inscriptions ;
- Suppression du profil, libérant le pseudo et l’adresse courriel pour les futures inscriptions ;
- Le membre est déconnecté ;
- Les données du membre sont anonymisées :

Expand All @@ -60,7 +60,7 @@ Le clic sur "me désinscrire" entraîne alors une série d'action (qui sont **ir

- si le tutoriel/article a été écrit par plusieurs personnes : le membre est retiré de la liste des auteurs ;
- si le tutoriel/article est *publié*, il passe sur le compte “external”. Une demande expresse sera nécessaire au retrait complet de ces contenus ;
- si le tutoriel/article n’est pas publié (brouillon, bêta, validation) il est supprimé, ainsi que la galerie qui lui est associée.
- si le tutoriel/article n’est pas publié (brouillon, bêta, validation), il est supprimé, ainsi que la galerie qui lui est associée.

.. _galeries: ../gallery/gallery.html
.. _articles: ../article/article.html
Expand All @@ -70,17 +70,17 @@ Le clic sur "me désinscrire" entraîne alors une série d'action (qui sont **ir
Les membres dans les environnement de test et de développement
==============================================================

Afin de faciliter les procédures de tests en local, 7 utilisateurs ont été créés via la fixture ``users.yaml`` (utilisateur/mot de passe):
Afin de faciliter les procédures de test en local, 7 utilisateurs ont été créés via la fixture ``users.yaml`` (utilisateur/mot de passe):

- user/user : Utilisateur normal
- staff/staff : Utilisateur avec les droits d'un staff
- admin/admin : Utilisateur avec les droits d'un staff et d'un admin
- anonymous/anonymous : Utilisateur qui permet l'anonymisation des messages sur les forums, dans les commentaires d'articles et de tutoriels ainsi que dans les MPs
- external/external : Utilisateur qui permet de récupérer les tutoriels d'anciens membres et/ou de publier des tutoriels externes.
- ïtrema/ïtrema : Utilisateur de test supplémentaire sans droit
- decal/decal: le compte qui possède un identifiant ``Profile`` différent de l'identifiant ``user`` pour permettre de tester des cas ou ces id sont différents
- user/user : utilisateur normal
- staff/staff : utilisateur avec les droits d'un staff
- admin/admin : utilisateur avec les droits d'un staff et d'un admin
- anonymous/anonymous : utilisateur qui permet l'anonymisation des messages sur les forums, dans les commentaires d'articles et de tutoriels ainsi que dans les MP
- external/external : utilisateur qui permet de récupérer les tutoriels d'anciens membres et/ou de publier des tutoriels externes.
- ïtrema/ïtrema : utilisateur de test supplémentaire sans droit
- decal/decal: un compte qui possède un identifiant ``Profile`` différent de l'identifiant ``user`` pour permettre de tester le cas ces identifiants sont différents

Pour que ces membres soient ajoutés à la base de données, il est donc nécéssaire d'exécuter la commande, suivante, à la racine du site
Pour que ces membres soient ajoutés à la base de données, il est donc nécéssaire d'exécuter la commande suivante, à la racine du site :

.. sourcecode:: bash

Expand All @@ -101,57 +101,57 @@ pour changer le nom d'utilisateur (*username*) de ces comptes, agissez sur les c
anonymous_account = "anonymous"
external_account = "external"

Bien entendu, les comptes correspondants doivent exister dans la base de donnée.
Bien entendu, les comptes correspondants doivent exister dans la base de données.

L'interface de promotion
------------------------

Afin de pouvoir gérer les membres directement depuis le site (c'est à dire sans avoir besoin de passer par l'interface d'administration de Django), une interface de promotion a été développée.
Cette interface permet de :
1. Ajouter/Supprimer un membre dans un/des groupe(s)
2. Ajouter/Supprimer le statut super-utilisateur à un membre
3. (Dés)activer un compte
Afin de pouvoir gérer les membres directement depuis le site (c'est-à-dire sans avoir besoin de passer par l'interface d'administration de Django), une interface de promotion a été développée. Elle est accessible aux membres ayant le statut de super-utilisateur via un lien présent sur tous les profils.
Cette interface permet :
1. D'ajouter/supprimer un membre dans un/des groupe(s)
2. D'ajouter/supprimer le statut de super-utilisateur à un membre
3. De (dés)activer un compte

Le premier point permet notamment de passer un membre dans le groupe staff ou développeur. Si d'autres groupes voient le jour (valido ?) alors il sera possible ici aussi de le changer.
Le second point permet de donner accès au membre à l'interface Django et à cette interface de promotion.
Le premier point permet notamment de passer un membre dans le groupe staff ou développeur. Si d'autres groupes venaient à voir le jour (validateur par exemple), alors il sera possible ici aussi de le changer.
Le second point permet de donner toutes les permissions à l'utilisateur, notamment l'accès à cette interface de promotion.
Enfin, le dernier point concerne simplement l'activation du compte (normalement faite par le membre à l'inscription).

Elle est géré par le formulaire `PromoteMemberForm` présent dans le fichier `zds/member/forms.py`.
Elle est ensuite visible via le template `member/settings/promote.html` qui peut-être accédé en tant que super-utilisateur via le profil de n'importe quel membre.
Elle est gérée par le formulaire `PromoteMemberForm` présent dans le fichier `zds/member/forms.py`.
Elle est ensuite visible via le template `member/settings/promote.html`.

L'interface de karma
--------------------

Pour pouvoir communiquer entre modérateur, il est utile d'avoir un outil de suivi sur les membres. Ce dernier prend forme via la gestion du "karma" d'un membre. Le karma est une valeur numérique pouvant aller de -100 à +100. Cette valeur peut-être modifié via l'ajout de bonus/malus par les modérateurs. Chaque modification du karma doit s'accompagner d'un commentaire, mais un commentaire n'entraine pas forcément une modification du karma (0 point de bonus/malus).
Pour pouvoir communiquer entre modérateurs, il est utile d'avoir un outil de suivi sur les membres. Ce dernier prend forme via la gestion du "karma" d'un membre. Le karma est une valeur numérique pouvant aller de -100 à +100. Cette valeur peut-être modifiée via l'ajout de bonus/malus par les modérateurs. Chaque modification du karma doit s'accompagner d'un commentaire, mais un commentaire n'entraîne pas forcément une modification du karma (0 point de bonus/malus).

Cet outil à deux rôles. Permettre d'identifier les membres *perturbateurs* mais aussi les membres *moteurs* qui pourrait faire l'objet d'un article ou d'une mise en avant de leurs projets.

Pour modifier le karma d'un membre, il faut donc être modérateur sur le site. Sur la fiche profil d'un membre apparait alors un formulaire pour ajouter un bonus/malus et une liste des modifications précédentes montrant l'impact (+/-), le message, l'auteur du bonus/malus et la date d'effet de ce dernier.
Pour modifier le karma d'un membre, il faut donc être modérateur sur le site. Sur le profil d'un membre apparaît alors un formulaire pour ajouter un bonus/malus et la liste des modifications précédentes montrant l'impact (+/-), le message, l'auteur du bonus/malus et la date d'effet de ce dernier.

Lorsqu'un membre change de pseudo, une note de karma (de 0 point) est automatiquement ajouté au profil en faisant mention de l'ancien et du nouveau pseudo du membre (afin de garder une tracabilité pour les membres du staff).
Lorsqu'un membre change de pseudo, une note de karma (de 0 point) est automatiquement ajoutée à son profil en faisant mention de son ancien et de son nouveau pseudo (afin de garder une tracabilité pour les membres du staff).

L'interface de réinitialisation de mot de passe
-----------------------------------------------

Quand le membre du site oublie son mot de passe, il peut le réinitialiser. L'ancien mot de passe est supprimé et l'utilisateur peut en choisir un nouveau.
Quand un membre du site oublie son mot de passe, il peut le réinitialiser. L'ancien mot de passe est supprimé et l'utilisateur peut en choisir un nouveau.
Pour cela, il se rend sur la page de réinitialisation de mot de passe (``membres/reinitialisation/``) à partir de la page de connexion.

.. figure:: ../images/member/reinitialisation-mot-de-passe-1.png

Sur cette page l'utilisateur, doit rentrer son nom d'utilisateur ou son adresse de courriel. Pour cela, il clique sur le lien pour que le formullaire apparaisse.
Quand l'utilisateur clique sur le bouton de validation, un jeton est généré aléatoirement et est stocké dans une base de données.
Sur cette page, l'utilisateur doit rentrer son pseudo ou l'adresse de courriel associée à son compte.
Quand l'utilisateur clique sur le bouton de validation, un jeton est généré aléatoirement et est stocké dans la base de données.

Un message est envoyé à l'adresse de courriel de l'utilisateur. Ce courriel contient un lien de réinitialisation. Ce lien contient un paramètre, le jeton de réinitialisation et dirige l'utilisateur vers l'adresse ``membres/new_password/``.
Un message est envoyé à l'adresse de courriel de l'utilisateur. Ce courriel contient un lien de réinitialisation. Ce lien contient en paramètre le jeton de réinitialisation et dirige l'utilisateur vers l'adresse ``membres/new_password/``.

.. figure:: ../images/member/reinitialisation-mot-de-passe-2.png

Cette page permet de changer le mot de passe de l'utilisateur. L'utilisateur remplit le formulaire et clique sur le bouton de validation.
Si le mot de passe et le champ confirmation correspondent et que le mot de passe respecte les règles métiers, le mot de passe est changé.
Le systéme affiche un message de confirmation du changement du mot de passe.
Si le mot de passe et le champ de confirmation correspondent et que le mot de passe respecte les règles métiers, le mot de passe est changé.
Le système affiche un message de confirmation du changement de mot de passe.

.. attention::

- Il n'existe aucune restriction sur le nombre de demande de réinitialisation
- Il n'existe aucune restriction sur le nombre de demande de réinitialisation.
- Un utilisateur peut avoir le même nom d'utilisateur que l'adresse email de quelqu'un d'autre. Exemple:

================ =======================
Expand All @@ -164,4 +164,4 @@ Le systéme affiche un message de confirmation du changement du mot de passe.

- Le mot de passe doit faire au moins 6 caractères.
- Le lien est valable une heure. Si l'utilisateur ne clique pas sur le lien dans le temps imparti, un message d'erreur est affiché.
- Le jeton de réinitialisation de mot de passe n'est valide qu'une seule fois. Si l'utilisateur tente de changer son mot de passe avec le même jeton, une page 404 est affiché à l'utilisateur.
- Le jeton de réinitialisation de mot de passe n'est valide qu'une seule fois. Si l'utilisateur tente de changer son mot de passe avec le même jeton, une page 404 lui est affichée.

0 comments on commit 3de5950

Please sign in to comment.