Extension:Thanks/nl

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 ) 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.

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

'Thank' acties loggen op "Special&#58;Log" (standaard ingeschakeld)

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

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

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  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
De extensie bevat een API voor het versturen van de bedankjes. Deze API heeft bij de aanroep een parameter.

Parameters:


 * - De revisie-ID waarvoor het bedankje is. Dit of  is verplicht.
 * - De log-ID waar het bedankje voor is. Dit of  is verplicht.
 * - 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)
 * - 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 te mogen versturen is alleen het "Basisrecht" nodig. Een voorbeeld in python staat hier.



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

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

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



Fouten en waarschuwingen


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  voor de ontvanger en   voor de gever.

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

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



Zie ook

 * w:Wikipedia:Notifications/Thanks - Informatie op de Engelse Wikipedia over het gebruik van deze extensie
 * - Beginvoorstel functie (voor de extensie Echo)
 * - Een andere extensie voor het bedanken
 * - Wordt door het notificatie systeem gebruikt