Kiterjesztés:Thanks

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:Thanks and the translation is 70% complete.
MediaWiki-kiterjesztések kézikönyve
OOjs UI icon advanced-invert.svg
Thanks
Kiadási állapot: stabil
History-Thank-Link-Mockup1.png
Megvalósítás Felhasználói felület
Leírás Lehetővé teszi a szerkesztések és más műveletek megköszönését
Szerző(k)
Legfrissebb verzió 1.2.0 (Continuous updates)
Kompatibilitási irányelv Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki 1.31+
PHP 5.4+
Licenc MIT License
Letöltés
  • $wgThanksAllowedLogTypes
  • $wgThanksConfirmationRequired
  • $wgThanksLogging
  • $wgThanksSendToBots
Fordítsd le a(z) Thanks kiterjesztést, ha elérhető a translatewiki.net oldalon

Használati és verziómátrix

Vagrant-szerep echo
Problémák Nyitott feladatok · Hibajelentés

A Thanks kiterjesztés lehetővé teszi a pozitív visszajelzéseket a MediaWiki-oldalakon. Az Echo kiterjesztésen keresztül más felhasználók szerkesztései és más műveletei „megköszönhetőek”.

A köszönési napló a lapváltozatot nem, csak az időbélyeget, valamint a küldő és a fogadó nevét tárolja.

A „köszönet” hivatkozás négy helyen jelenik meg:

  • a laptörténetekben és a változatok összehasonlításakor a „visszavonás” gomb mellett
  • a Speciális:Rendszernaplók egyes bejegyzéseinél (lásd alább a #Beállítás szakaszt)
  • ha telepítve van, a Flow-megbeszélések hozzászólásainál.

A kiterjesztés a köszönethez API-t is biztosít.

Ha nem szeretnél köszönetet kapni, a beállításaidban letilthatod.

Example of a 'thanks' notification

Ha kipróbáltad a kiterjesztést, örömmel vesszük visszajelzéseidet a vitalapon!

Reméljük, hogy a kiterjesztéssel egyszerűsödik egymás munkájának elismerése – ez főleg az új szerkesztők első lépéseinél hasznos. Az értesítést szándékosan egyszerűsítettük le, így együtt fejleszthetjük. Jó szórakozást!

Letöltés

Ez a kiterjesztés elérhető közvetlenül Gitről [?]:

  • Böngészd a forrást
  • Bizonyos kiterjesztések rendelkeznek címkékkel a stabil kiadásokhoz.
  • Minden ág egy adott MediaWiki-kiadáshoz tartozik. Van egy „master” ág is, ami a legfrissebb alfaverziót tartalmazza (igényelheti a MediaWiki egy alfaverzióját).

Bontsd ki a letöltött fájlt a MediaWiki-telepítésed extensions/Thanks/ könyvtárába.

Ha ismered a gitet és van shell-hozzáférésed a szerverhez, így is beszerezheted a kiterjesztést:

cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Thanks.git

Telepítés

A Thankshez szükséges az Echo kiterjesztés telepítése.

A MediaWiki 1.26-es vagy korábbi verziói felhasználóinak:

A fenti útmutató a kiterjesztés új, wfLoadExtension() kóddal való telepítését írja le. Ha korábbi (MediaWiki 1.26 vagy régebbi) verzióra szeretnéd feltelepíteni a kiterjesztést, a wfLoadExtension( 'Thanks' ); helyett az alábbi kódot kell használnod:

require_once "$IP/extensions/Thanks/Thanks.php";

Beállítás

Engedélyezés a botos szerkesztésekhez (alapértelmezésben kikapcsolva)

$wgThanksSendToBots = false;

Engedélyezés a naplózott műveletekhez (alapértelmezésben bekapcsolva)

$wgThanksLogging = true;

Szükséges-e megerősítés a köszönet küldése előtt (alapértelmezésben bekapcsolva)

$wgThanksConfirmationRequired = true;

A Speciális:Rendszernapló felületén megköszönhető műveletek beállítása:

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

Használat

To thank another user, go to the History tab of any page. Next to each revision will be a 'thank' link. Click the link to send thanks to that user. This link is also available in the diff view, on some entries in Special:Log, and below comments on Flow boards if Flow is installed.

When the thank link is clicked, the recipient will receive a notification with your thanks via the Echo extension (unless they have opted out of receiving thanks notifications). A record of the action is also recorded as a log entry at Special:Log/thanks.

If the wiki is using memcached, a rate limit is imposed of no more than 10 thanks per minute per user. The limit can be configured with $wgRateLimits ['thanks-notification'].

A köszönet letiltása

Ha nem szeretnél köszönetet kapni, a beállításaidnál kikapcsolhatod a funkciót, amit a beállításaid Értesítések fülén tehetsz meg. Ezzel csak az értesítést kapcsolod ki, a szerkesztéseidet mások továbbra is megköszönhetik.

API-dokumentáció

A Thanks kiterjesztés a köszönet küldéséhez API-t is biztosít, melynek meghívásához az action=thank paraméter használható.

Paraméterek:

  • rev - The revision ID you would like to thank someone for (either this or log is required)
  • log - The log ID you would like to thank someone for (either this or rev is required)
  • source - Source of the thank event. This is a short string that identifies where the thanks was sent from. For example, if the thanks was sent from Huggle, the value could be 'huggle'. (optional)
  • token - Edit token (a.k.a. csrf token). You can get one of these through the tokens API. (required)

Example:

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

To send thanks via OAuth only the "Basic" grant permission is required. A python example can be found here.

A naplózás leírása

A naplók elemzéséhez az oszlopok jelentésének megértése szükséges. A logging táblában a log_title a fogadót, a log_user_text pedig a küldőt rögzíti.

Az alábbi SQL-lekérdezéssel egy adott intervallumban kinyerhetők az adott szerkesztő által kapott köszönetek:

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

Notice also that the logging table is not selected from directly, but on Wikimedia servers we take advantage the logging_logindex table. In order to quickly search for all the thanks a user sent the logging_userindex provides the correct index.

Flow Thanks

There is a separate API for sending Thanks for comments on Flow boards. To call the API, use action=flowthank.

Parameters:

  • postid - The UUID of the comment for which to send thanks (required)
  • token - Edit token. You can get one of these through prop=info. (required)

Példa:

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

Hibaüzenetek és figyelmeztetések

Üzenet Jelentés
invalidrecipient Nem található érvényes címzett
Botoknak nem lehet köszönetet küldeni
Nem küldhetsz köszönetet saját magadnak

Lásd még