Kiterjesztés:Thanks

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)	Ryan Kaldari Benjamin Chen Wctaiwan
Legfrissebb verzió	1.2.0 (Continuous updates)
Kompatibilitási irányelv	Snapshots releases along with MediaWiki. Master is not backward compatible.
Paraméterek $wgThanksAllowedLogTypes $wgThanksConfirmationRequired $wgThanksLogging $wgThanksSendToBots
Hooks used ApiMain::moduleManager BeforeCreateEchoEvent BeforePageDisplay ChangesListInitRows DiffTools DifferenceEngineViewHeader EchoGetBundleRules GetAllBlockActions GetLogTypesOnUser HistoryTools LocalUserCreated LogEventsListLineEnding PageHistoryBeforeList PageHistoryPager::doBatchLookups
Licence	MIT licenc
Letöltés	Kiterjesztés letöltése Git [?]: tároló böngészése (Phabricator · GitHub) kódellenőrzés verziótörténet Download source tarball
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ö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.

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.

Ezt a kiterjesztést a MediaWiki 1.40 és afölötti verziói már tartalmazzák, így nem kell újra letöltened. The remaining configuration instructions must still be followed.

• 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.
• 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:

$wgThanksAllowedLogTypes = [
	"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ó

thank
E modul nem használható generátorként.
Előtag
Szükséges jogok	nincs
Csak POST?	Igen
Generált segítség	Jelenlegi

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ó. In order to call the API, use the parameter action=thank.

Paraméterek:

Name	Description	Required?
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

flowthank
E modul nem használható generátorként.
Előtag
Szükséges jogok	nincs
Csak POST?	Igen
Generált segítség	Jelenlegi

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

Parameters:

Name	Description	Required?
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 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 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

• w:Help:Notifications/Thanks - Information about the usage of this extension on English Wikipedia
• Echo (Notifications)/Feature requirements#Thank_you_notification - javaslat a bevezetésre az Echo részeként
• Extension:WikiLove - az elismeréshez használható másik kiterjesztés
• Extension:Echo - az értesítési rendszert biztosítja