Extension:Thanks/nl

This page is a translated version of the page Extension:Thanks and the translation is 100% complete.
MediaWiki Handleiding extensies
OOjs UI icon advanced-invert.svg
Thanks
Release status: stabiel
History-Thank-Link-Mockup1.png
Implementatie Gebruikersinterface
Beschrijving Laat gebruikers andere gebruikers bedanken voor een bewerking, ...
Auteur(s)
Laatste versie 1.2.0 (Voortdurend updates)
Compatibiliteit beleid Snapshots releases samen met MediaWiki. Master is niet achterwaarts compatibel.
MediaWiki 1.31+
PHP 5.4+
Licentie MIT Licentie
Download
  • $wgThanksAllowedLogTypes
  • $wgThanksConfirmationRequired
  • $wgThanksLogging
  • $wgThanksSendToBots
Downloads kwartaal 97 (Ranked 91st)
Publieke wiki's die het gebruiken 272 (Ranked 374th)
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.

Example of a 'thanks' notification

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.

Download

De extensie kan direct uit Git worden opgehaald [?]:

  • Code bekijken
  • Enkele extensies hebben een tag voor een stabiele release.
  • Elke branch is geassocieerd met een MediaWiki release. Er is ook een "master" branch die de meest recente alpha versie bevat. (Daar kan een alpha versie van MediaWiki bij nodig zijn).

Pak het snapshot en plaats het in de map extensions/Thanks/ van uw MediaWiki installatie.

Als u met Git vertrouwd ben en shell-toegang hebt op uw server, dan kun u ook de extensie als volgt ophalen:

cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Thanks.git

Installatie

De extensie Thanks heeft als vereiste dat de extensie Echo al 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

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.

Documentatie over loggen

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.

Flow bedankjes

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

Zie ook