Extensia:Mulțumesc

From mediawiki.org
This page is a translated version of the page Extension:Thanks and the translation is 48% complete.
Outdated translations are marked like this.
This extension comes with MediaWiki 1.40 and above. Thus you do not have to download it again. However, you still need to follow the other instructions provided.
Extensiile pentru MediaWiki
Thanks
Statutul de lansare: stabilă
Implementare User interface
Descriere Permite utilizatorilor să mulțumească altor utilizatori pentru editări individuale
Autor(i)
Versiune recentă 1.2.0 (Continuous updates)
Politica de compatibilitate Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki >= 1.42
Licență MIT License
Descărcare
  • $wgThanksAllowedLogTypes
  • $wgThanksConfirmationRequired
  • $wgThanksLogging
  • $wgThanksSendToBots
Quarterly downloads 61 (Ranked 95th)
Public wikis using 2,442 (Ranked 193rd)
Traduceți extensia Thanks dacă este disponibilă la translatewiki.net
Rolul vagrant echo
Probleme cauzate Sarcini deschise · Raportați probleme

The Thanks extension adds a quick way to give positive feedback for productive contributions to MediaWiki sites. It allows users to send public 'thank you' notifications (via Echo ) to other users for their individual edits and some logged actions.

The specific revision that is being "thanked" for is not stored in the public logging table. Only the timestamp, sender, and recipient, are publicly logged.

A 'thank' link is added in the following places:

  • next to the 'undo' link in history and diff views;
  • to Flow board comments if Flow is installed.

It also provides an API for sending thanks.

Note that if you do not want to be thanked, you can easily disable this notification in your preferences, as described below.

Example of a 'thanks' notification

Odată ce ați avut ocazia să încercați, vă mulțumim pentru feedbackul despre această caracteristică pe această pagină de discuții. (Rețineți că dacă nu doriți să le mulțumiți altora sau să le mulțumiți, puteți dezactiva cu ușurință această notificare în preferințele dvs., așa cum este descris aici.)

Sperăm că notificarea privind mulțumirile va facilita aprecierea muncii celuilalt - și ar trebui să fie deosebit de utilă pentru a încuraja noi utilizatori în timpul primilor pași critici pe Wikipedia. Am ținut intenționat această notificare cât mai simplă posibil, astfel încât să putem evalua și să o îmbunătățim împreună. Bucurați-vă ...

Instalare

Mulțumesc necesită extensia Echo să fie instalată ca prerechizite.
  • Download and move the extracted Thanks folder to your extensions/ directory.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Thanks
  • Adăugați următorul cod în partea de jos a setărilor locale ($LocalSettings):
    wfLoadExtension( 'Thanks' );
    
  • Dacă este necesar, configurați-vă la dispoziția dvs.
  • Mergeți la acțiunea Istoric a unei pagini pentru a vedea noua interfață "Mulțumesc".
  • Yes Realizat – Navigați la Special:Version pe wiki-ul dvs. pentru a verifica dacă extensia a fost instalată cu succes.

Configurare

Activați interfața de mulțumire pentru editările bot (dezactivată în mod implicit)

$wgThanksSendToBots = false;

Activați acțiunile de mulțumire pentru "Special:Log" (activat implicit)

$wgThanksLogging = true;

Dacă este necesară sau nu confirmarea pentru trimiterea mulțumirilor (activată implicit)

$wgThanksConfirmationRequired = true;

Log entry types that can be thanked from Special:Log:

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

Utilizare

Pentru a mulțumi unui alt utilizator, accesați fila Istoric a oricărei pagini. Alături de fiecare revizuire va fi un link 'mulțumesc'. Faceți click pe link pentru a trimite mulțumiri acelui utilizator. Acest link este de asemenea disponibil în vizualizarea dif, și de mai jos comentariile pe panourile Flow dacă Flow este instalat.

Când se face click pe link-ul de mulțumire, destinatarul va primi o notificare cu mulțumirile dvs. prin intermediul extensiei extensie Echo (cu excepția cazului în care au optat să nu primească notificări de mulțumire). O înregistrare a acțiunii este, de asemenea, înregistrată ca intrare în jurnal la Special:Log/thanks.

Dacă wiki utilizează memcached, este impusă o rată de maximum limită de 10 mulțumiri pe minut per utilizator. Limita poate fi configurată cu $wgRateLimits ['thanks-notification'].

Avoiding thanks

To stop getting thanks notifications, you can opt out from them in your notification preferences. Go to the Notifications tab of your preferences. This only prevents you from getting notified, it does not prevent users from thanking you.

Documentare API

Extensia de mulțumiri include un API pentru a trimite mulțumiri. Pentru a apela API, utilizați parametrul action=thank.

Parametri:

  • 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 - Sursa evenimentului de mulțumire. Acesta este un șir scurt care identifică de unde au fost trimise mulțumirile. De exemplu, dacă mulțumirile au fost trimise de la Huggle, valoarea ar putea fi 'huggle'. (opțional)
  • token - Modifică token (a.k.a. csrf token). Puteți obține unul dintre acestea prin API tokens API. (necesar)

Exemplu:

 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.

Mulțumire Flow

Există un API separat pentru a trimite Mulțumesc pentru comentarii pe plăcile Flow. Pentru a apela API, folosiți action=flowthank.

Parametri:

  • postid - UUID-ul comentariului pentru care să trimită mulțumiri (obligatoriu)
  • token - Editați simbolul. Puteți obține unul dintre acestea prin prop=info. (necesar)

Exemplu:

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

Erori și avertismente

Cod Info
invalidrecipient No valid recipient found
Roboților nu li se poate mulțumi
Nu vă puteți mulțumi vouă.

SQL Documentation

Understanding who thanked who from the logs requires some understanding of the columns. Within the logging table, the log_title represents the receiver, and the log_user_text represents the sender.

The following SQL which finds all the thanks a receiver received within a time period illustrates this:

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.


Vezi şi