Rozšíření:Thanks

Toto rozšíření je součástí MediaWiki verze 1.40 a vyšších. To znamená, že jej nemusíte stahovat samostatně. Musíte se nicméně stále řídit pokyny k jeho použití.

Základní informace k tomuto rozšíření MediaWiki

Thanks Stav rozšíření: stabilní
Zavádění	Uživatelské rozhraní
Popis	Umožňuje uživatelům poděkovat ostatním uživatelům za jednotlivé úpravy atd.
Napsal(i)	Ryan Kaldari Benjamin Chen Wctaiwan
Nejnovější verze	1.2.0 (Průběžně aktualizováno)
Zásady kompatibility	Vydání snímků následuje MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
MediaWiki	>= 1.42
Licence	Licence MIT
Zdrojový kód	Stáhněte si rozšíření Git [?]: stáhněte si Git master procházení úložiště (Phabricator · GitHub) zobrazení historie přispěvatelé repozitáře (GitHub) kontrola kódu
Parametry $wgThanksAllowedLogTypes $wgThanksConfirmationRequired $wgThanksLogging $wgThanksSendToBots
Použité háčky (hooks) ApiMain::moduleManager BeforeCreateEchoEvent BeforePageDisplay BeforeSpecialMobileDiffDisplay DiffTools DifferenceEngineViewHeader EchoGetBundleRules GetAllBlockActions GetLogTypesOnUser HistoryTools LocalUserCreated LogEventsListLineEnding PageHistoryBeforeList
Čtvrtletní stahování	47 (Ranked 99th)
Používání veřejných wikin	2,442 (Ranked 193rd)
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.

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…

Instalace

Thanks jako předpoklad vyžaduje instalaci rozšířwní Echo.

• 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 akci Historie stránky a zobrazte nové rozhraní "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 "Speciálního protokolu" (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ým lze poděkovat ze Special:Log:

$wgThanksLogTypeWhitelist = [
	"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 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í $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

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 logging 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:Wikipedia: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í
• Extension:Echo - Poskytuje systém upozornění