Extension:Thanks/nl

Deze extensie is meegeleverd met MediaWiki 1.40 en nieuwer. Het is dus niet nodig om deze opnieuw te downloaden. De andere instructies hier beneden moeten nog wel gevolgd worden.

MediaWiki Handleiding extensies

Thanks Release status: stabiel
Implementatie	Gebruikersinterface
Beschrijving	Laat gebruikers andere gebruikers bedanken voor een bewerking, ...
Auteur(s)	Ryan Kaldari Benjamin Chen Wctaiwan
Laatste versie	1.2.0 (Voortdurend updates)
Compatibiliteit beleid	Snapshots releases samen met MediaWiki. Master is niet achterwaarts compatibel.
MediaWiki	>= 1.42
Licentie	MIT Licentie
Download	Extensie downloaden Git [?]: Download Git master blader door de repository (Phabricator · GitHub) commitgeschiedenis repository beheerders (GitHub) code review
Parameters $wgThanksAllowedLogTypes $wgThanksConfirmationRequired $wgThanksLogging $wgThanksSendToBots
Gebruikte hooks ApiMain::moduleManager BeforeCreateEchoEvent BeforePageDisplay BeforeSpecialMobileDiffDisplay DiffTools DifferenceEngineViewHeader EchoGetBundleRules GetAllBlockActions GetLogTypesOnUser HistoryTools LocalUserCreated LogEventsListLineEnding PageHistoryBeforeList
Downloads kwartaal	48 (Ranked 93rd)
Publieke wiki's die het gebruiken	2,442 (Ranked 193rd)
Vertaal de Thanks extensie indien beschikbaar op translatewiki.net
Vagrant rol	echo
Problemen	Open taken · Rapporteer een bug

De extensie Thanks voegt een snelle manier toe om positieve feedback te geven bij productieve bijdragen aan de MediaWiki websites. Het staat gebruikers toe om iemand publiekelijk te bedanken met een melding (via Echo ) to voor diens individuele bewerkingen en enkele gelogde acties.

De specifieke revisie waarvoor het bedanken is wordt niet opgeslagen in de openbare log. Alleen het tijdstempel, gever en ontvanger worden gelogd.

Een 'bedank' link wordt op de volgende plaatsen toegevoegd:

• naast de link 'ongedaan maken' in de geschiedenis en de verschillenweergave
• bij sommige logrecords op Special:Log (#Configuratie)
• bij Flow board commentaar als Flow is geïnstalleerd.

Het heeft ook een API voor het sturen van bedankjes.

Als u niet wil worden bedankt, dan kunt u deze melding in uw voorkeuren uitschakelen. Zie hieronder.

Nadat u het heeft gebruikt, horen we graag uw feedback over deze functie op de overlegpagina.

Wij hopen dat de melding over het bedanken het eenvoudiger maakt om anderen voor hun werk te bedanken, vooral voor nieuwe gebruikers kan het een aanmoediging zijn bij hun eerste ervaringen op de wiki.

Installatie

De extensie Thanks heeft als vereiste dat de extensie Echo al geïnstalleerd is.

• Download en plaats de bestanden in de map Thanks in de map extensions/.
  Ontwikkelaars en bijdragers van code moeten in plaats daarvan de extensie van Git installeren, met behulp van:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Thanks
• Voeg de volgende code onderaan het bestand LocalSettings.php toe:

  wfLoadExtension( 'Thanks' );
  

• U kunt de extensie naar uw voorkeuren instellen.
• Ga naar de geschiedenis van een pagina en merk de nieuwe interface van het bedanken op.
•  Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.

Configuratie

Inschakelen van de interface voor bot-bewerkingen (standaard uitgeschakeld)

$wgThanksSendToBots = false;

'Thank' acties loggen op "Special:Log" (standaard ingeschakeld)

$wgThanksLogging = true;

Geeft aan of er een bevestiging nodig is voor het versturen van een bedankje (standaard ingeschakeld)

$wgThanksConfirmationRequired = true;

Log types van de acties waarvoor een bedankje kan worden verstuurd, zie Special:Log:

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

Gebruik

Om een gebruiker voor iets te bedanken, ga naar de tab Geschiedenis weergeven van ene pagina. Naast elke revisie dat een link om die gebruiker te bedanken. In de inleiding hebben we al aangegeven waar die link nog meer zit.

Als op die link wordt geklikt, zal de ontvanger van het bedankje een melding ontvangen van uw gegeven bedankje via de extensie Echo (tenzij diegene zich daarvoor heeft afgemeld). De actie wordt ook gelogd in het Bedankjeslogboek.

Als de wiki memcached gebruikt, dan wordt er een limiet voorgesteld van maximaal 10 bedankjes geven per minuut door een bepaalde gebruiker. Deze 'limiet' kan met $wgRateLimits ['thanks-notification'] worden ingesteld.

Bedankjes voorkomen

Een gebruiker kan zich afmelden voor het krijgen van de meldingen over deze bedankjes, dat gaat via de voorkeuren. Ga naar in uw voorkeuren naar de tab Meldingen. U kunt dus nog wel bedankt worden, maar u krijgt de meldingen niet meer.

API documentatie

thank
Deze module kan niet worden gebruikt als een generator.
Voorvoegsel
Benodigde rechten	geen
Alleen verzenden?	Ja
Gegenereerde help	Huidig

De extensie bevat een API voor het versturen van de bedankjes. Deze API heeft bij de aanroep een parameter action=thank.

Parameters:

• rev - De revisie-ID waarvoor het bedankje is. Dit of log is verplicht.
• log - De log-ID waar het bedankje voor is. Dit of rev is verplicht.
• source - Bron van de gebeurtenis waar het bedanken op slaat. Dit is een korte tekst die de plek aangeeft waar het bedankje is verstuurd. Als dat bijvoorbeeld in Huggle is gedaan, dan kan de waarde 'huggle' zijn. (optioneel)
• token - Edit token (ook wel CSRF token, een controle of een wijziging echt via het normale proces verloopt). U kunt er een ophalen met de tokens API. (verplicht)

Voorbeeld:

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

Om bedankjes via OAuth te mogen versturen is alleen het "Basisrecht" nodig. Een voorbeeld in python staat hier.

Flow bedankjes

flowthank
Deze module kan niet worden gebruikt als een generator.
Voorvoegsel
Benodigde rechten	geen
Alleen verzenden?	Ja
Gegenereerde help	Huidig

Er is een andere API voor het versturen van bedankjes vanaf Flow boards. Bij een aanroep van die API is het parameterdeel action=flowthank.

Parameters:

• postid - De UUID van het commentaar waarvoor wordt bedankt (verplicht)
• token - U kunt een Edit token krijgen met prop=info (verplicht).

Voorbeeld:

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

Fouten en waarschuwingen

Code	Info
invalidrecipient	Geen geldige ontvanger gevonden Bots kunnen geen bedankjes ontvangen U kunt niet uzelf bedanken

Documentatie over SQL

Om in de logs te kunnen lezen wie door wie is bedankt, moet u wat van de kolommen weten. In de tabel logging staat log_title voor de ontvanger en log_user_text voor de gever.

De SQL om op te halen welke bedankjes een bepaald iemand heeft ontvangen binnen een bepaalde periode is:

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

NB: De tabel logging wordt niet direct gebruikt, op Wikimedia servers benutten we het voordeel van de tabel logging_logindex. Om snel alle bedankjes te zoeken die een gebruiker heeft gedaan, is de juiste index logging_userindex.

Zie ook

• w:Wikipedia:Notifications/Thanks - Informatie op de Engelse Wikipedia over het gebruik van deze extensie
• Echo (Notifications)/Feature requirements#Thank_you_notification - Beginvoorstel functie (voor de extensie Echo)
• Extension:WikiLove/nl - Een andere extensie voor het bedanken
• Extension:Echo/nl - Wordt door het notificatie systeem gebruikt