Extension:WikiLove/nl

WikiLove (WikiWaardering) is een extensie die ontworpen is om het verspreiden van WikiLove te promoten binnen Wikipedia en mogelijk ook andere wiki's. Het maakt het mogelijk om met een paar eenvoudige klikken op wat knoppen awards, giften en uitnodigen te doen op gebruikersoverlegpagina's.

Installatie
Als u de ingebouwde awards wilt gebruiken, dan moet u InstantCommons hebben ingeschakeld. Dan kan door aan het bestand LocalSettings.php toe te voegen:

De extensie zou nu actief moeten zijn. Ga naar de tab Bewerken in uw voorkeuren om de interface aan te zetten

Er zijn nog meer configuratie-opties die op die manier kunnen worden gezet:


 * - de extensie voor alle gebruikers inschakelen, overschrijft de gebruikersvoorkeur (Standaardwaarde: false)
 * NB: u kunt de instelling ook standaard inschakelen en het aan de gebruiker overlaten om het uit te zetten (opt-out), dat doet u met:




 * - een icoon gebruiken voor skins die dat ondersteunen (bijv. Vector) (standaardwaarde: true)
 * - logging inschakelen van gebruik WikiLove (standaardwaarde: false); dit maakt automatisch een database tabel  aan, deze kunt u gebruiken voor statistieken

Gebruik
Om in uw account in te stellen om WikiLove (WikiWaardering) te gebruiken gaat u naar de tab Bewerken in uw voorkeuren en schakelt WikiLove in onder "Labs features" (of in sommige versies onder "Algemene opties"). In September 2022 this displays as "Enable showing appreciation for other users with the WikiLove tab".

Om het te gebruiken, ga naar een gebruikersoverlegpagina (niet van uzelf) en klik op het hartje. Volg dan de aanwijzingen.



Verdere configuratie
Om te zien hoe u WikiLove voor uzelf kunt aanpassen (dus niet voor de hele wiki): gebruikersdocumentatie.

U kunt de optie aanpassen op uw eigen wiki door het wijzigen van de pagina MediaWiki:WikiLove.js. Dit gaat hetzelfde als de interne opties:. Wat voorbeelden van een configuratie:


 * Wikipedia
 * sq:MediaWiki:WikiLove.js (vervangt de gehele WikiLove configuratie)
 * pt:MediaWiki:WikiLove.js (vervangt de gehele WikiLove configuratie)
 * ml:MediaWiki:WikiLove.js
 * en:MediaWiki:WikiLove.js
 * Wikimedia Commons

De opties bovenaan de zijn wat standaardinstellingen. Als u bepaalde eigenschappen van (sub)types weglaat dan worden deze gebruikt. Dan volgt de lijst met types. Elk type kan  (verplichte) en   (optionele) eigenschappen hebben. Een type kan een aantal subtypes hebben, als er geen subtypes zijn dan krijgt het type de mogelijke aanvullende eigenschappen.

Als er subtypes zijn, dan staan ze in een objectlijst. Het type kan optioneel de eigenschap  hebben, dat is dan het label boven de dropdown. Elk subtype kan de volgende eigenschappen hebben:


 * - naam in de dropdown
 * - Beschrijving van het subtype
 * - Kopregel van het toegevoegde bericht, het deel dat staat tussen
 * - Titel van de berichtenbox
 * - Tekst van de berichtenbox (details staan hieronder)
 * - Afbeelding van de berichtenbox


 * - Galerie voor het selecteren van een afbeelding
 * - Lijst met velden die de gebruiker kan aanpassen, ze kunnen deze waarden bevatten:
 * - Afbeeldingsgrootte (bijv. )
 * - Achtergrondkleur (iedere CSS geldige kleur, bijv.  of  )
 * - Kleur rand (gelijk)

Als er geen subtypes gebruikt worden, deze opties (behalve de eerste twee) worden dan aan het type toegekend.

In de  en   velden (en ook in de , eerder genoemd), kunt u een aantal placeholders gebruiken, die variabelen worden dan automatisch in de tekst vervangen:
 * $1 - Bericht
 * $2 - Titel
 * $3 - Naam afbeelding
 * $4 - Grootte afbeelding
 * $5 - Achtergrondkleur
 * $6 - Rand kleur
 * $7 - Gebruikersnaam ontvanger

Om het selecteren van afbeeldingen door de gever eenvoudiger te maken, kunt u een galerie aanmaken met al gedefinieerde afbeeldingen. Maal een property (eigenschap)  aam met de volgende eigenschappen:


 * - Een lijst (array) met namen van afbeeldingen
 * - Maximale wijdte van de afbeeldingen in de galerie (in pixels); bij 3 afbeelding wordt  aanbevolen
 * - maximale hoogte van de afbeeldingen in de galerie
 * - Aantal willekeurig te tonen afbeeldingen (optioneel); standaard worden alle hier beschikbare afbeeldingen getoond

U kunt afbeeldingen van Wikimedia Commons gebruiken, dat wordt gedaan voor de standaard awards. U dient hiervoor dus wel InstantCommons in te schakelen.



WikiLove type verwijderen
Als u een standaardtype van WikiLove wilt verwijderen, dan kunt u ze verwijderen in het $.wikiLoveOptions object. Wat voorbeelden voor gebruik op uw MediaWiki:WikiLove.js pagina van uw wiki:



WikiLove type toevoegen
Nu een voorbeeld met het toevoegen van een type 'Puppy':

Een voorbeeld met een nieuw type met een galerie met afbeeldingen:

Nu een nieuw subtype 'falafel' van het bestaande type 'food':



Problemen
Als de te bewerken overlegpagina een woord bevat dat op de Special:SpamRegex staat, dan er geen ster of een andere award worden toegevoegd. Een pagina met een verboden woord kan niet bewerkt worden, het woord moet eerst verwijderd worden van de pagina (of uit die lijst). Het woord zal pas toegevoegd zijn aan de lijst nadat het op deze pagina is gezet.



API documentatie
Wikiwaardering gebruikt een eigen API om een bericht op een gebruikersoverlegpagina te plaatsen. Deze API is eigenlijk een wrapper (schil) die bestaande API's gebruikt. Als de pagina een Wikitext pagina is, dan wordt de API gebruikt. Als het een 'flow' pagina is, dan wordt de API gebruikt. Als het een LiquidThreads pagina is, dan wordt de API gebruikt.

Gebruik de parameter  om de API aan te roepen.

Parameters:


 * Naam van de gebruiker of de titel van de gebruikersoverlegpagina die de ontvanger van de waardering is (verplicht)
 * Naam van de gebruiker of de titel van de gebruikersoverlegpagina die de ontvanger van de waardering is (verplicht)


 * Ruwe wikitext in de toe te voegen sectie (verplicht)
 * Ruwe wikitext in de toe te voegen sectie (verplicht)


 * De tekst die gebruiker heeft ingevoerd, dit is voor de logging bedoeld (exclusief de afbeelding en zonder HTML-opmaak)
 * De tekst die gebruiker heeft ingevoerd, dit is voor de logging bedoeld (exclusief de afbeelding en zonder HTML-opmaak)


 * U kunt een Edit token krijgen met prop=info (verplicht)
 * U kunt een Edit token krijgen met prop=info (verplicht)


 * Kop van de nieuwe sectie met het onderwerp (verplicht)
 * Kop van de nieuwe sectie met het onderwerp (verplicht)


 * Het type (voor de statistieken); dit komt overeen met het geselecteerde type met eventueel dus het subtype als dat er is (bijv: "barnstar-normal" of "kitten") (optioneel)
 * Het type (voor de statistieken); dit komt overeen met het geselecteerde type met eventueel dus het subtype als dat er is (bijv: "barnstar-normal" of "kitten") (optioneel)


 * Inhoud van het optionele e-mailbericht dat naar de gebruiker is verzonden
 * Inhoud van het optionele e-mailbericht dat naar de gebruiker is verzonden

Voorbeeld:

api.php?action=wikilove&title=User:Dummy&text=Love&subject=Hi&token=%2B\



Ontwerp versie 1.0


Dit document beschrijft het ontwerp en het gedrag van het WikiLove systeem voor een positieve feedback. Dit is een manier om het werken in Wikipedia of een ander WikiMedia wiki te promoten. Er worden awards toegevoegd aan gebruikersoverlegpagina's.

Motivering
Een gemeenschap als Wikipedia heeft meerdere mechanismes om het onplezierig werken of het geven van afbraak feedback naar gebruikers, te herkennen. Bepaalde gadgets, zoals Twinkle, zijn gemaakt voor het waarschuwen, blokkeren en terugdraaien

Omdat iedereen een positieve versterking wil, vooral richting nieuwe gebruikers, is er een systeem gemaakt dat bedoeld is voor het geven van positieve feedback, niet alleen voor nieuwkomers maar ook bij opgevallen prestaties.



Gebruik van de stijl whimsical
Het systeem heeft opzettelijk een nogal "speelse en vrolijke" stijl, dat sluit goed aan op de verwachtingen van gebruikers bij een moderne website. Ook het principe van waarderingen is dat al met (sterren, taarten, ...).

Of wij de stijl gaan aanpassen hangt van de feedback van gebruikers af.



Naamgeving
Enkele sjabloontypes zoals die voor het verwelkomen zijn natuurlijk niet echt beloningen maar wel een belangrijke vorm van aandacht.

In dit document worden award en sjabloon wat door elkaar gebruikt. Het systeem is gericht op de gebruiker en niet zo zeer voor techneuten, er wordt spreektaal gebruikt.

Proces


Dialogen
De dialoog in deze extensie is modal. Bij aanroep, waarvandaan dan ook, wordt het getoond over de pagina heen. U kunt het met een klik wegklikken.

Het WikiLove systeem vereist JavaScript.

The user will initially be presented with a short set of easy-to-understand instructions and a list of available award categories.

Upon selecting an award type, the user is presented with a section in which they can add details to the award (such as a short message).

Note that some award categories (e.g., "cookie") will not have a secondary award creation step and will go directly to "Preview".

The user then clicks the "preview" button, which will load a preview of the award so that they may see how it will look on the user's talk page.

Once the user is satisfied, they may click the "Send WikiLove" button. At this time, AJAX calls to the server API will be fired, adding the template to the user's talk page.



E-mailnotificatie
Since most new users are unlikely to be aware that they even have talk pages, they may not be aware that they have received the WikiLove in question.

Accordingly, the server will email the recipient (if they have provided an email address) informing them of the WikiLove as well as short instructions on how to access their talk page.



Website configuratie
Initially, the awards that can be given are to be defined in the gadget itself. If this system is elevated to an extension, then the names of the awards and the templates should be defined in the site's LocalSettings.php.

Alternatively, such information can be stored in the database. An administration console would be required to add or subtract available awards and award categories.



Data opslag
For statistics gathering purposes, every time an award is given, data is tracked and stored in the database. A simple table, written to via the API, is all that need be required:


 * From User - The username of the person who is giving the award
 * To User - The username of the person receiving the award
 * Template - the name of the template awarded
 * Timestamp - when the award was given
 * Award Text - Optional; this would be the text of the award

Special:WikiLoveStatistics
In the future, it should be possible to create a page, Special:WikiLoveStatistics, that could be used to see how often the system is used as well as providing insight into who gives the most love, what awards are most popular, and who receives the most awards.

This will help to provide a global overview of community health. The more awards given, the healthier the community.



Toekomstplannen
Fase twee van dit project zou het kunnen zijn dat een "Send WikiLove" link automatisch wordt toegevoegd aan de ondertekeningen op de overlegpagina's. Hierdoor zou WikiLove gemakkelijk kunne worden verzonden, direct vanaf andere overlegpagina's.



Zie ook

 * - Origineel ontwerp
 * - lighter-weight thanking for edits using Echo
 * GiveCredit - MeatBall Wiki