Extension:Thanks

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

Thanks Stav rozšíření: stabilní
Implementace	Uživatelské rozhraní
Popis	Umožňuje uživatelům poděkovat ostatním uživatelům za jednotlivé úpravy atd.
Autoři	Ryan Kaldari Benjamin Chen Wctaiwan
Nejnovější verze	1.2.0 (Průběžně aktualizováno)
Zásady kompatibility	Vydání snímků současně s MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
Parametry $wgThanksAllowedLogTypes $wgThanksConfirmationRequired $wgThanksLogging $wgThanksSendToBots
Použité háčky (hooks) ApiMain::moduleManager BeforeCreateEchoEvent BeforePageDisplay ChangesListInitRows DiffTools DifferenceEngineViewHeader EchoGetBundleRules GetAllBlockActions GetLogTypesOnUser HistoryTools LocalUserCreated LogEventsListLineEnding PageHistoryBeforeList PageHistoryPager::doBatchLookups
Licence	Licence MIT
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řeložte rozšíření Thanks, používá-li lokalizaci z translatewiki.net
Vagrant role	echo
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření Thanks přidává rychlý způsob, jak poskytnout pozitivní zpětnou vazbu pro produktivní příspěvky na stránky MediaWiki. Umožňuje uživatelům posílat veřejná oznámení s poděkováním (prostřednictvím Echo ) ostatním uživatelům za jejich individuální úpravy a některé zaznamenané akce.

Odkaz s 'poděkováním' je přidán na následující místa:

• vedle odkazu 'zpět' v zobrazení historie a rozdílů;
• u některých záznamů v protokolu Special:Log (viz #Configuration níže); a
• Pokud je nainstalováno rozšíření StructuredDiscussions , do komentářů na fóru Flow.

Poskytuje také API pro zasílání poděkování.

Všimněte si, že pokud nechcete dostávat poděkování, můžete toto upozornění snadno deaktivovat ve svých předvolbách, jak je popsáno níže.

Jakmile budete mít možnost ji vyzkoušet, uvítáme vaši zpětnou vazbu k této funkci na stránce diskuse.

Doufáme, že upozornění na poděkování usnadní vzájemné vyjádření uznání za práci toho druhého – a mělo by být zvláště užitečné pro povzbuzení nových uživatelů během jejich prvních kritických kroků na wiki. Toto upozornění jsme záměrně zachovali co nejjednodušší, abychom jej mohli společně vyhodnotit a vylepšit. Užívat si…

Instalace

Thanks jako předpoklad vyžaduje instalaci Echo .

Toto rozšíření je součástí MediaWiki 1.40 a vyšší. Zbývající konfigurační pokyny je stále nutné dodržovat.

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného Thanks 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/Thanks
  

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

  wfLoadExtension( 'Thanks' );
  

• V případě potřeby nakonfigurujte podle požadavku
• Přejděte na tabulku historie a zobrazte nové rozhraní "Thank" (děkuji).
• Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Konfigurace

Povolit rozhraní Děkuji pro úpravy robotů (ve výchozím nastavení zakázáno)

$wgThanksSendToBots = false;

Zaznamenat akce s poděkováním do Special:Log (ve výchozím nastavení povoleno)

$wgThanksLogging = true;

Zda je nebo není vyžadováno potvrzení pro odeslání poděkování (ve výchozím nastavení povoleno)

$wgThanksConfirmationRequired = true;

Typy záznamů protokolu, kterými lze poděkovat ze Special:Log:

$wgThanksAllowedLogTypes = [
	"contentmodel",
	"delete",
	"import",
	"merge",
	"move",
	"patrol",
	"protect",
	"tag",
	"managetags",
	"rights"
];

Použití

Chcete-li poděkovat jinému uživateli, přejděte na kartu Historie libovolné stránky. Vedle každé revize bude odkaz s poděkováním. Kliknutím na odkaz pošlete poděkování tomuto uživateli. Tento odkaz je také dostupný v zobrazení rozdílů, u některých položek ve Special:Log a pod komentáři na nástěnkách Flow, pokud je Flow nainstalován.

Po kliknutí na odkaz s poděkováním obdrží příjemce oznámení s vaším poděkováním prostřednictvím rozšíření Echo (pokud se neodhlásil z přijímání oznámení s poděkováním). Záznam o akci je také zaznamenán jako položka protokolu na Special:Log/thanks.

Pokud wiki používá memcached, je stanoven limit na maximálně 10 poděkování za minutu na uživatele. Limit lze nakonfigurovat pomocí $wgRateLimits ['thanks-notification'].

Vyhýbání se poděkování

Pokud už nechcete dostávat oznámení o poděkování, můžete se odhlásit v předvolbách oznámení. Přejděte na kartu Oznámení ve svých předvolbách. To vám zabrání pouze v upozornění, nebrání to uživatelům, aby vám poděkovali.

Dokumentace API

thank
Tento modul nelze použít jako zdroj.
Předpona
Požadovaná práva	žádná
Pouze příspěvek?	Ano
Zdroj nápovědy	Aktuální

Rozšíření Thanks obsahuje API pro zasílání poděkování. K volání API použijte parametr action=thank.

Parametry:

• rev - ID revize, za kterou byste chtěli někomu poděkovat (je vyžadováno buď toto, nebo log)
• log - ID protokolu, za které byste chtěli někomu poděkovat (je vyžadováno buď toto, nebo rev)
• source - zdroj děkovné akce. Toto je krátký řetězec, který identifikuje, odkud bylo poděkování odesláno. Například, pokud bylo poděkování odesláno z Huggle, hodnota by mohla být 'huggle'. (volitelné)
• token - upravit token (také znám jako CSRF token). Jeden z nich můžete získat prostřednictvím tokenů API. (požadované)

Příklad:

 api.php?action=thank&rev=16543&token=%2B\

Chcete-li poslat poděkování prostřednictvím OAuth , je vyžadováno pouze "základní" udělení povolení. Příklad pythonu je k dispozici.

Flow Díky

flowthank
Tento modul nelze použít jako zdroj.
Předpona
Požadovaná práva	žádná
Pouze příspěvek?	Ano
Zdroj nápovědy	Aktuální

Existuje samostatné API pro zasílání Děkujeme za komentáře na Flow boardech. K volání API použijte action=flowthank.

Parametry:

• postid - UUID komentář, s kterým se má poslat poděkování (povinné)
• token - upravit token. Jeden z nich můžete získat prostřednictvím prop=info. (požadováno)

Příklad:

 api.php?action=flowthank&postid=abc123&token=%2B\

Chyby a upozornění

Kód	Popis
invalidrecipient	Nebyl nalezen platný příjemce Robotům nelze děkovat Nemůžete děkovat sami sobě.

Dokumentace k SQL

Konkrétní revize, událost nebo akce, za kterou je "poděkováno", se neukládá do tabulky databáze protokolování (a systém tak omezuje, co lze zobrazit, např. u Special:Log/thanks). Protokoluje se pouze časové razítko, odesílatel a příjemce. Pochopení toho, kdo komu děkoval z protokolů, vyžaduje určité porozumění sloupcům. V tabulce logging představuje log_title příjemce a log_user_text představuje odesílatele.

Následující SQL, který najde všechna poděkování, které příjemce obdržel během časového období, to ilustruje:

select log_timestamp as thank_timestamp,
  replace(log_title, '_', ' ') as receiver,
  log_user_text as sender
from logging_logindex
where log_title = :user_name
  and log_action = 'thank'
  and :start_date <= log_timestamp
  and log_timestamp <= :end_date

Všimněte si také, že tabulka the logging table se nevybírá přímo, ale na serverech Wikimedie využíváme výhodu tabulky logging_logindex. logging_userindex poskytuje správný index, aby bylo možné rychle vyhledat všechna poděkování, která uživatel poslal.

Související odkazy

• w:Help:Notifications/Thanks - informace o použití tohoto rozšíření na anglické Wikipedii
• Echo (Notifications)/Feature requirements#Thank_you_notification - původní návrh funkce (pro rozšíření Echo)
• Extension:WikiLove - další rozšíření pro zasílání poděkování
• Rozšíření:Echo - poskytuje systém upozornění