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

To make it easy for the user to select images, you can create a gallery with predefined images. For this, create a  property, which has the following properties:


 * - An array of image names
 * - Maximum width of the images in the gallery (in pixels); for 3 images  is recommended
 * - Maximum height of the images in the gallery (in pixels)
 * - Number of random images to show (optional); if omitted all images are shown

You can use images from Wikimedia Commons, as the default awards do. Like mentioned before, you have to enable InstantCommons for this.

Removing WikiLove types
If you just want to remove some of the default WikiLove types, you can delete them from the $.wikiLoveOptions object. Here are some examples that you could use in your wiki's MediaWiki:WikiLove.js page:

Adding new WikiLove types
Here's an example of adding a new puppy type:

Here's an example of adding a new hedgehog type with a gallery of images to choose from:

Here's an example of adding a new falafel subtype under the existing food type:

Glitches and problems
If the talk page you are attempting to edit contains a word that has been subsequently added to Special:SpamRegex, attempts to use the interface to add a barnstar or other award will fail. This is because the page cannot be edited, as it contains a forbidden word. Removing the word from the page or from the filter will fix the problem.

API documentation
WikiLove uses a special wikilove API to post messages to users' talk pages. The API is basically just a thin wrapper around some existing APIs. If the user's talk page is a Wikitext page, it uses the API. If it's a Flow page, it uses the API. And if it's a LiquidThreads page, it uses the API.

In order to call the API, use the parameter.

Parameters:


 * Title of the user or user talk page to send WikiLove to (required)
 * Title of the user or user talk page to send WikiLove to (required)


 * Raw wikitext to add in the new section (required)
 * Raw wikitext to add in the new section (required)


 * Actual message the user has entered, for logging purposes (doesn't include the image and HTML formatting)
 * Actual message the user has entered, for logging purposes (doesn't include the image and HTML formatting)


 * Edit token. You can get one of these through prop=info (required)
 * Edit token. You can get one of these through prop=info (required)


 * Subject header of the new page section (required)
 * Subject header of the new page section (required)


 * Type of WikiLove (for statistics); this corresponds with a type selected in the left menu, and optionally a subtype after that (e.g. "barnstar-normal" or "kitten") (optional)
 * Type of WikiLove (for statistics); this corresponds with a type selected in the left menu, and optionally a subtype after that (e.g. "barnstar-normal" or "kitten") (optional)


 * Content of the optional email message to send to the user
 * Content of the optional email message to send to the user

Voorbeeld:

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

Design for version 1.0


This document describes the design and behavior of the WikiLove system of positive feedback for Wikipedia. This tool is designed to promote the spread of WikiLove within Wikipedia. Specifically, it makes adding awards and gifts to user talk pages as simple as clicking a few buttons.

Rationale
Wikipedia, as a community, has several mechanisms for indicating displeasure or to provide negative feedback to its users. Certain gadgets, such as Twinkle, are heavily engineered towards warning, blocking, and reverting.

Since Wikipedia is in need of positive reinforcement, especially for new users, a system designed specifically and only towards positive feedback is desired.

Use of whimsical style
The system has a heavy style of "whimsy" to its design. This is intentional and is intended to align closer to the expectations of users of modern websites. Further, the entire principle of "awards" is in and of itself whimsical (e.g., cookies and kittens).

This style may be abandoned based on user feedback.

Note on nomenclature
Some template types, such as welcome templates, are not technically "awards".

This document uses the term award interchangeably with template. Since the system is user-focused, and not intended directly for power-users, user-facing nomenclature has been used.

Dialog behavior
The WikiLove dialog is modal. Initiating it (from anywhere) will cause it to appear over the text of the page. It can be dismissed with a simple click.

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.

Email notification
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.

Site configuration
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.

Future thinking
Phase two of this project could result in "Send WikiLove" links being dynamically added to signatures on talk pages. This would allow for WikiLove to be sent in a much easier manner, directly from other talk pages.



Zie ook

 * - Original design document
 * - lighter-weight thanking for edits using Echo
 * GiveCredit - MeatBall Wiki