Jump to content

Rozšíření:Thanks

From mediawiki.org
This page is a translated version of the page Extension:Thanks and the translation is 100% complete.
This extension comes with MediaWiki 1.40 and above. To znamená, že jej nemusíte stahovat samostatně. Musíte se nicméně stále řídit pokyny k jeho použití.
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
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í.
MediaWiki >= 1.43
Licence Licence MIT
Stáhnout
  • $wgThanksAllowedLogTypes
  • $wgThanksConfirmationRequired
  • $wgThanksLogging
  • $wgThanksSendToBots
Čtvrtletní stahování 23 (Ranked 112nd)
Veřejné wiki používající rozšíření 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.

Example of a 'thanks' notification

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".
  • Yes 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

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

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