Extension:Email Authorization

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:Email Authorization and the translation is 100% complete.
MediaWiki Stakeholders' Group Logo.svg This extension is maintained by a member of the Groupe des acteurs de MediaWiki .
PluggableAuth Icon.svg This extension requires the PluggableAuth extension to be installed first.
Manuel des extensions MediaWiki
OOjs UI icon advanced-invert.svg
Email Authorization
État de la version : stable
Implémentation Droits utilisateur
Description Implémente l'accroche PluggableAuth PluggableAuthUserAuthorization pour fournir une autorisation à l'aide d'une liste d'adresses e-mail autorisées.
Auteur(s) Cindy Cicalese
Dernière version 1.5 (2019-11-14)
Politique de compatibilité Le master conserve la compatibilité arrière.
MediaWiki 1.27+
PHP 5.5+
Modifie la base
de données
Oui
Licence Licence MIT
Téléchargement
  • $wgEmailAuthorization_RequestFields
  • $wgEmailAuthorization_EnableRequests
emailauthorizationconfig
Traduire l’extension Email Authorization sur translatewiki.net

Vérifier la matrice des utilisations et des versions.

Problèmes Tâches ouvertes · Signaler un bogue

L'extension Email Authorization implémente l'accroche PluggableAuth PluggableAuthUserAuthorization pour fournir une autorisation en utilisant une liste d'adresses e-mail autorisées. Il fournit une page spéciale, Special:EmailAuthorizationConfig, qu'un administrateur peut utiliser pour ajouter et supprimer des adresses e-mail et des domaines de messagerie de la liste d'autorisation.

This extension does not currently work with PostgreSQL.

Installation

Cette extension nécessite PluggableAuth qui doit être installée en premier.
  • Téléchargez et placez le(s) fichiers (s) dans un répertoire appelé EmailAuthorization dans votre dossier extensions/.
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :
    wfLoadExtension( 'EmailAuthorization' );
    
  • Exécutez le script de mise à jour qui va créer automatiquement les tables de base de données dont cette extension a besoin.
  • Configuration requise
  • Yes Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Configuration

Drapeau Par défaut Description
$wgEmailAuthorization_EnableRequests false Indique si une page spéciale (Special:EmailAuthorizationRequest) sera disponible pour les comptes à demander. Si elle est activée, cette page contiendra un formulaire utilisé pour demander un compte. Par défaut, ce formulaire contiendra un seul champ: l'adresse e-mail. Des champs supplémentaires peuvent être spécifiés par $wgEmailAuthorization_RequestFields. De plus, si la valeur est vrai, une page spéciale (Special:EmailAuthorizationApprove) sera disponible pour les utilisateurs du groupe bureaucrat pour approuver les comptes.
$wgEmailAuthorization_RequestFields [] Un tableau de champs supplémentaires pour le formulaire de demande. La définition de chaque champ est elle-même un tableau avec les champs possibles suivants:
  • label - le libellé du champ (chaîne); doit être présent
  • mandatory - s'il est présent et vrai, ce champ est obligatoire
  • values - une liste de chaînes séparées par des virgules qui sont les valeurs possibles de ce champ; le champ sera une liste déroulante
  • rows - s'il est présent, le nombre de lignes dans la zone de texte pour ce champ
  • columns - s'il est présent, le nombre de colonnes dans le champ de texte ou la zone de texte pour ce champ (par défaut: 50)

Les trois derniers paramètres (values, rows et columns) sont utilisés pour décider comment afficher le champ. Si values est présent, une liste déroulante sera affichée et toutes les valeurs de rows et columns seront ignorées. SI values n'est pas présent mias si rows est présent, une zone de texte avec une taille specifié est affiché, avec columns (par défaut à 50 s'il n'est pas présent) Si columns est présent, un champ texte avec la taille spécifiée est affiché S'il n'est pas présent, un champ de texte de 50 colonnes est affiché.

Quel que soit le contenu de ce tableau, un champ d'adresse e-mail sera présent comme premier champ.

Par exemple,

$wgEmailAuthorization_RequestFields = [
  [
    'label' => 'Organization',
    'mandatory' => true
  ],
  [
    'label' => 'Extra Information',
    'rows' => 4,
    'columns' => 60
  ],
  [
    'label' => 'Animals',
    'values' => [ 'dog', 'cat' ]
  ]
];

afficherait un champ de texte obligatoire (Organisation) avec 50 colonnes, une zone de texte avec 4 lignes et 60 colonnes (Informations supplémentaires) et une liste déroulante pour choisir entre dog et cat (Animaux).

Les utilisateurs qui devraient être en mesure d'ajouter et de révoquer des adresses e-mail et des domaines de messagerie sur la page Special:EmailAuthorizationConfig doivent avoir le droit de emailauthorizationconfig. Par exemple :

$wgGroupPermissions['bureaucrat']['emailauthorizationconfig'] = true;
Comme cette extension dépend de l'adresse e-mail de l'utilisateur pour effectuer l'autorisation, vous devez empêcher l'utilisateur de la modifier avec la configuration suivante :
$wgPluggableAuth_EnableLocalProperties = false;

Accroches

Cette extension fournit les crochets suivants aux autres extensions :

  • EmailAuthorizationAdd et EmailAuthorizationRevoke prennent un seul paramètre : une adresse de courriel ou un domaine de courriel (p. ex. @ suivi du domaine).
  • EmailAuthorizationRequest prend les paramètres suivants : une adresse e-mail et un tableau de champs de formulaire codés en JSON.
  • EmailAuthorizationApprove et EmailAuthorizationReject prennent les paramètres suivants : une adresse e-mail, un tableau de champs de formulaire codés en JSON et l'objet User de la bureaucrate approuvant/rejetant la demande de compte.

Historique des versions

Version 1.5
  • Ajustement et minuscules emails avant de les ajouter
Version 1.4
  • Ajout de PHPCS et correction automatique de certains reniflements trouvés avec PHPCBF
Version 1.3
  • Ajout de la fonctionnalité de demande de compte optionnelle contrôlée par $wgEmailAuthorization_EnableRequests
    • Special:EmailAuthorizationRequest
    • Special:EmailAuthorizationApprove
Version 1.2
  • Change message prefix to prevent collisions with other extensions
  • Formatage en bloc
  • Renommé de Special:ConfigEmailAuthorization à Special:EmailAuthorizationConfig
Version 1.1
  • Correction du bogue : l'ajout d'une adresse de messagerie qui existait déjà a levé une exception
  • Les adresses e-mail et les domaines entrés dans Special:ConfigEmailAuthorization sont maintenant validés
  • Ajout de messages de droits manquants
Version 1.0
  • Version initiale

Voir aussi