Rozšíření:Thanks
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) |
|
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.43 |
Licence | Licence MIT |
Zdrojový kód | |
|
|
Čtvrtletní stahování | 31 (Ranked 105th) |
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
- Stáhněte soubor/y a vložte je do adresáře pojmenovaného
Thanks
ve vaší složceextensions/
.
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:
$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 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, nebolog
)log
- ID protokolu, za které byste chtěli někomu poděkovat (je vyžadováno buď toto, neborev
)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í
- Rozšíření:Echo - Poskytuje systém upozornění
Toto rozšíření se používá na jednom nebo více projektech Wikimedie. Pravděpodobně to znamená, že rozšíření je stabilní a funguje dostatečně dobře, aby jej mohly používat weby s tak vysokou návštěvností. Vyhledejte tento název rozšíření v konfiguračních souborech CommonSettings.php a InitialiseSettings.php Wikimedie, abyste viděli, kde je nainstalováno. Úplný seznam rozšíření nainstalovaných na konkrétní wiki lze vidět na stránce wiki Special:Version. |
Toto rozšíření je zahrnuto v následujících wiki farmách/hostitelích a/nebo balíčcích: Toto není autoritativní seznam. Některé wiki farmy/hostitelé a/nebo balíčky mohou toto rozšíření obsahovat, i když zde nejsou uvedeny. Pro potvrzení se vždy obraťte na své wiki farmy/hostitele nebo balíček. |