Kiterjesztés:Thanks

From mediawiki.org
This page is a translated version of the page Extension:Thanks and the translation is 67% complete.
Ezt a kiterjesztést a MediaWiki 1.40 és afölötti verziói már tartalmazzák, így nem kell újra letöltened. Az útmutató egyéb utasításait azonban továbbra is követned kell.
MediaWiki-kiterjesztések kézikönyve
Thanks
Kiadási állapot: stabil
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.42
Licenc MIT License
Letöltés
  • $wgThanksAllowedLogTypes
  • $wgThanksConfirmationRequired
  • $wgThanksLogging
  • $wgThanksSendToBots
Quarterly downloads 47 (Ranked 100th)
Public wikis using 2,442 (Ranked 193rd)
Fordítsd le a(z) Thanks kiterjesztést, ha elérhető a translatewiki.net oldalon
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 az alábbi helyeken 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!

Telepítés

A Thankshez szükséges az Echo kiterjesztés telepítése.
  • Töltsd le a kiterjesztés fájljait, és mentsd el az extensions/ mappán belüli Thanks könyvtárba.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Thanks
  • Add hozzá az alábbi kódot a LocalSettings.php fájlod aljára:
    wfLoadExtension( 'Thanks' );
    
  • Ha szükséges, állítsd be igényeid szerint.
  • Az új felületet a laptörténetben próbálhatod ki.
  • Yes Kész – A Special:Version oldalon ellenőrizheted, hogy a kiterjesztés ténylegesen feltelepült-e.

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 is available.

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

SQL-dokumentáció

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 of the logging_logindex table. In order to quickly search for all the thanks a user sent the logging_userindex provides the correct index.


Lásd még