Extension:TranslationNotifications

Manuel des extensions MediaWiki

TranslationNotifications État de la version : stable
Implémentation	Page spéciale , Notifier
Description	Permet aux traducteurs de s'enregistrer pour recevoir les notifications de traduction
Auteur(s)	Jon Harald Soby, Amir Aharoni, Santhosh Thottingal, Niklas Laxström, Siebrand Mazeland
Dernière version	Mises à jour constantes
MediaWiki	1.34+
Modifie la base de données	Non
Composer	mediawiki/translation-notifications
Licence	Licence publique générale GNU v2.0 ou supérieur
Téléchargement	Télécharger l'extension Git [?]: Télécharger la branche master de Git parcourir le dépôt (GitHub) historique des validations (commits) contributeurs du dépôt (GitHub) relecture du code
Exemple	translatewiki.net
Paramètres $wgTranslationNotificationsAlwaysHttpsInEmail $wgTranslationNotificationsSignupLegalMessage $wgTranslationNotificationsContactMethods
Accroches utilisées GetPreferences
Traduire l’extension TranslationNotifications sur translatewiki.net si elle y est disponible
Vérifier la matrice des utilisations et des versions.
Problèmes	Tâches ouvertes · Signaler un bogue

L'extension TranslationNotifications fournit un moyen de gérer la communication avec les traducteurs sur un wiki qui utilise l'extension Translate .

Cette extension comporte deux parties principales:

Pour les traducteurs

un formulaire où les traducteurs signent eux-mêmes pour recevoir les notifications. Ils peuvent indiquer les langues dans lesquelles ils traduisent et donner leur méthode préférée pour être contacté ainsi que la fréquence, incluant les options de résumé.

Pour les administrateurs de traductions

un formulaire existe pour envoyer les demandes de traduction de pages . La notification sera délivrée à tous les traducteurs qui satisfont à la sélection, soit immédiatement soit ultérieurement, regroupée dans un courriel global.

• 

  Formulaire d'abonnement

• 

  Formulaire de notification

Prérequis

L'extension n'est utile que si l'extension Translate est installée et configurée. Il utilise l'extension MassMessage pour laisser des messages sur les pages de discussion de l'utilisateur, de sorte que l'extension doit également être installée.

Instructions de téléchargement

Cette extension peut être récupérée directement depuis Git ^[?]:

• Naviguer dans le code
• Certaines extensions étiquettent les versions stables.
  • Naviguer dans les Étiquettes
  • Sélectionner l'étiquette
  • Cliquer sur snapshot (instantané)
• Chaque branche correspond à une version antérieure de MediaWiki. Il y a aussi une branche master (maître) qui contient la dernière version alpha (elle peut nécessiter une version alpha de MediaWiki)
  • Naviguer dans les branches
  • Sélectionnez le nom d'une branche
  • Cliquez sur « Continuer »

Décompressez l'instantané et placez-le dans le répertoire extensions/TranslationNotifications/ de votre installation MediaWiki.

Si vous êtes familier de Git et si vous avez un accès au shell de votre serveur, vous pouvez aussi obtenir l'extension de la manière suivante:

cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/TranslationNotifications.git

Installation

• Téléchargez et placez le(s) fichiers (s) dans un répertoire appelé TranslationNotifications dans votre dossier extensions/.
• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :

  wfLoadExtension( 'TranslationNotifications' );
  

• Configurer selon vos besoins.
•  Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Configuration

Les paramètres de configuration suivants sont utilisés :

$wgTranslationNotificationsContactMethods configure les méthodes de contact activées. Voici les valeurs par défaut :

$wgTranslationNotificationsContactMethods = [
	'email' => true,
	'talkpage' => true,
	'talkpage-elsewhere' => false,
];

Pages spéciales

Special:TranslatorSignup

Une page spéciale où les traducteurs peuvent s'enregistrer. Exemple: Special:TranslatorSignup sur le wiki Meta de Wikimedia. Les utilisateurs peuvent initialiser leurs préférences de langues (première, seconde et troisième langue) et la méthode de contact comme le courriel ou les notifications concernant la page de discussion. Il est aussi possible de demander d'être notifié sur une page de discussion d'un wiki différent dans la famille de wikis basée sur le même CentralAuth. Ils peuvent également choisir la fréquence des notifications : toujours (dès qu'il y a quelque chose à traduire), ou sur la base d'un rapport hebdomadaire ou mensuel. L'option courriel n'est disponible que pour les utilisateurs ayant confirmé leur adresse courriel.

Dans le cas où vous avez activé les notifications par courriel pour les modifications de la page de discussion utilisateur du wiki de votre choix, vous les recevrez aussi pour les notifications de traduction, aussi c'est peut-être mieux de choisir la méthode 'seulement par courriel' pour éviter de dupliquer les messages.

Special:NotifyTranslators

Cette page est disponible pour les administrateurs de traductions. Ils l'utilisent pour notifier la disponibilité d'une page à traduire (les notifications pour les autres groupes de messages ne sont pas supportées). Ils peuvent optionnellement définir une date de fin et une priorité et ajouter un message personnalisé. Ils peuvent aussi envoyer la notification à uniquement des traducteurs de langues particulières. Si aucune langue n'est définie, tous les traducteurs qui se sont abonnés recevront la notification.

Les droits utilisateur nécessaires pour agir sur cette page sont 'translate-manage' (gestion des traductions). Par exemple, pour autoriser tous les administrateurs à utiliser cette page, ajoutez la ligne suivante à votre fichier LocalSettings.php :

$wgGroupPermissions['sysop']['translate-manage'] = true;

Configuration des notifications

Les notifications - courriel, courriels de résumé, notifications des pages de discussion - sont réalisées avec l'aide de la file des tâches. Vous devez configurer le temps d'éxécution de la file des tâches comme indiqué dans le manuel de la file des tâches.

Le script DigestEmailer doit être configuré en utilisant une tâche de type cron . Par exemple, il peut être programmé pour s'exécuter tous les dimanches à 10 heures en utilisant une entrée dans la crontab ainsi:

0 10 * * 7 /usr/bin/php /www/wiki/extensions/TranslationNotifications/scripts/DigestEmailer.php 2>&1 > /var/log/digestEmail.log

Le script ne va pas se mettre à envoyer les courriels immédiatement. Il commence par mettre les tâches de courriel dans la file des tâches MediaWiki. Les courriels seront envoyés en fonction de la configuration de l'ordonnancement de la file des tâches.