Extension:Thanks/cs

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 ) ostatním uživatelům za jejich individuální úpravy a některé zaznamenané akce.

Konkrétní revize, za kterou se "děkuje", není uložena v tabulce veřejného protokolování. Veřejně je protokolováno pouze časové razítko, odesílatel a příjemce.

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
 * pro Flow komentáře na ploše, pokud je Flow nainstalován.

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…

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

Zaznamenat akce s poděkováním do "Speciálního protokolu" (ve výchozím nastavení povoleno)

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

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

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 Echo extension (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í.



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
Rozšíření Thanks obsahuje API pro zasílání poděkování. K volání API použijte parametr.

Parametry:


 * - ID revize, za kterou byste chtěli někomu poděkovat (je vyžadováno buď toto, nebo )
 * - ID protokolu, za které byste chtěli někomu poděkovat (je vyžadováno buď toto, nebo )
 * - 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é)
 * - 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, je vyžadováno pouze "základní" udělení povolení. Příklad pythonu je k dispozici.



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

Parametry:
 * - UUID komentář, s kterým se má poslat poděkování (povinné)
 * - 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í


Dokumentace k SQL
Pochopení toho, kdo komu děkoval z protokolů, vyžaduje určité porozumění sloupcům. V tabulce logging představuje  příjemce a   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:

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



Související odkazy

 * w:Wikipedia:Notifications/Thanks - Informace o použití tohoto rozšíření na anglické Wikipedii
 * - Původní návrh funkce (pro rozšíření Echo)
 * - Další rozšíření pro zasílání poděkování
 * - Poskytuje systém upozornění