Extension:TranslationNotifications/cs

Příručka k rozšířením MediaWiki

TranslationNotifications Stav rozšíření: stabilní
Implementace	Speciální stránka , Oznámení
Popis	Umožňuje překladatelům přihlásit se k odběru oznámení o překladu
Autoři	Jon Harald Soby, Amir Aharoni, Santhosh Thottingal, Niklas Laxström, Siebrand Mazeland
Nejnovější verze	Průběžně aktualizováno
MediaWiki	1.34+
Změny v databázi	Ne
Parametry $wgTranslationNotificationsAlwaysHttpsInEmail $wgTranslationNotificationsSignupLegalMessage $wgTranslationNotificationsContactMethods
Použité háčky (hooks) GetPreferences
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (Phabricator · GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball
Příklad	translatewiki.net
Přeložte rozšíření TranslationNotifications, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření TranslationNotifications poskytuje způsob, jak spravovat komunikaci s překladateli na wiki, která používá rozšíření Translate.

Rozšíření má dvě hlavní části:

Pro překladatele

Formulář, kde se překladatelé přihlašují k odběru oznámení. Mohou uvést jazyky, do kterých mohou překládat, a preferované kontaktní metody a frekvenci, včetně možností přehledu.

Pro manažery překladů

Formulář pro zasílání žádostí o překlad stránky. Oznámení bude doručeno všem překladatelům splňujícím podmínky buď okamžitě, nebo později v souhrnném e-mailu.

• 
  Přihlašovací formulář
• 
  Oznamovací formulář

Předpoklady

Rozšíření je užitečné pouze v případě, že je nainstalováno a nakonfigurováno rozšíření Translate. Používá rozšíření MassMessage k zanechání zpráv na diskusních stránkách uživatele, takže toto rozšíření by mělo být také nainstalováno.

Instalace

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného TranslationNotifications ve vaší složce extensions/.
  Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:

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

• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( 'TranslationNotifications' );
  

• Configure as required.
• Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Configuration

The following configuration variables are used:

$wgTranslationNotificationsContactMethods configures which contact methods are enabled. These are the default values:

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

Special pages

Special:TranslatorSignup

A special page where translators can sign up. Example: Special:TranslatorSignup on Wikimedia's Meta-wiki. Users can set their language preferences (first, second and third language) and the contact method such as email or talk page notifications. It's also possible to ask to be notified on a talk page on a different wiki in the same CentralAuth-based wiki family. They can also choose the frequency of notifications: always (every time there is something to translate), weekly digest or monthly digest. The email option will be available only for users who confirmed their email address.

In the case you have enabled email notification for user talk edits in the wiki of choice, you'll get it also for translation notifications, so it's probably better to select only email as method, to avoid duplicate messages.

Special:NotifyTranslators

This page is available for translation managers. They use it to notify about the availability of a translatable page (notifications for other message groups are not supported). They can optionally set a deadline and a priority, and add a custom message. They can also send the notification only to translators to particular languages. If no languages are set, all the translators who signed up will receive the notification.

The user right required to operate this page is 'translate-manage'. For example, to allow all sysops to use this page, add the following line to your LocalSettings.php file:

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

Notification configuration

The notifications - email, digest emails, talk page notifications - are done with the help of the Job Queue. You need to configure the job queue execution time as explained in the Job queue manual.

The DigestEmailer script needs to be configured using a cron job. For example, it can be scheduled to run on every Sunday 10AM using a crontab entry like the following one:

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

The script will not start sending emails immediately. It starts inserting email jobs to the MediaWiki job queue. Depending on the configured job queue scheduling, the mails will be sent out.

Footnotes