Manual:Developing extensions/nl



Elke extensie bestaat uit drie onderdelen:


 * 1) Instellen
 * 2) Uitvoering
 * 3) Lokalisatie

Een extensie bestaat minimaal uit drie bestanden, één voor elk onderdeel:


 * MyExtension/extension.json: Bevat de instel-instructies. Het bestand moet "extension.json" heten. (Voor MediaWiki 1.25 zaten de opzet instructies in een  bestand vernoemd naar de extensienaam. Veel extensies hebben 'backwards-compatibility' functies in dit PHP bestand.)
 * MyExtension/MyExtension_body.php: Bevat de uitvoer code voor de extensie. De bestandsnaam MyExtension_body.php is gebruikelijk maar niet verplicht. als je extensie complex is en meerdere PHP bestanden bevat, dan word je aangeraden om de bestanden in een subfolder genaamd  te plaatsen (alhoewel de BoilerPlate-extensie en de voorbeeldextensie deze regel niet volgen). Bijvoorbeeld, bekijk de  extensie.
 * MyExtension/i18n/*.json: Bevat lokalisatie informatie voor de extensie.

Als je een extensie ontwikkelt, vervang "MyExtension" hierboven met de naam van jou extensie. Gebruik "UpperCamelCase" naamgeving voor je bestandsmappen en PHP bestand(en); dit is de algemene Bestandsbenaming conventie. (The is a good starting point for your extension. You can also consider using MWStew for generating your extension boilerplate. Also check out the cookiecutter template for MediaWiki extensions on GitHub.)

De drie onderdelen van een extensie, opzet,uitvoering en lokalisatie, alsook de extensie types en licentie geven en het publiceren van jou extensie worden beschreven in de volgende secties op deze pagina.

Instellen
Je doel in het instellen is het samenvoegen van je setup zodat gebruikers alleen je opzetbestand in hoeven te zetten, zoals hier:

Als je jou extensie door gebruikers wilt laten aanpassen, dan moet je configuratieparameters definiëren en documenteren, de gebruikersinstellingen zien er dan ongeveer zo uit:

Om deze eenvoud te bereiken, moeten je installatiebestanden een aantal taken uitvoeren (gedetailleerd beschreven in de volgende secties):


 * registreer elke media handler, parser functie, speciale pagina's, zelfgemaakte XML tag, en variabele die gebruikt worden in jou extensie.
 * definieer en/of valideer elke configuratie variabele die je hebt gedefinieert voor je extensie.
 * maak de klassen die gebruikt worden in je extensie klaar voor autoloading
 * bepaal welke onderdelen van je instellingen onmiddellijk uitgevoerd moeten worden en welke onderdelen uitgevoerd moeten worden nadat de MediaWiki core is ge-initialiseerd en geconfigureerd is
 * definieer bijgevoerde Hooks die nodig zijn voor je extensie
 * maak of controleer nieuwe database-tabellen de nodig zijn voor je extensie.
 * stel lokalisatie voor je extensie in

MediaWiki kenmerken registreren
MediaWiki laat alle geinstalleerde extensies zien op de  pagina. Je kan bijvoorbeeld alle extensies die geïnstalleerd zijn op deze wiki zien in Special:Version. Het is goed als jou extensie ook op deze pagina weergeven wordt. Dit doe je door een invoer aan toe te voegen voor elke media handler, parser functie, speciale pagina, custom XML tag, and variabele die gebruikt wordt door jou extensie. De invoer ziet er ongeveer zo uit:

Zie voor details over wat deze velden doen. Veel velden zijn optioneel, maar het is verstandig om ze in te vullen. De  refereert naar de versie van het schema die in het  bestand is geschreven. Voor nu wordt alleen versie 1 ondersteund (MediaWiki 1.26.x en 1.27.x).

Naast de hierboven geschreven registratie moet je ook je functionaliteit een "hook" geven in MediaWiki. Het bovenstaande installeert alleen de Special:Version pagina. De manier waarop je dit doet hangt af van you extensietype. Voor details, lees de documentatie voor elke extensietype:

Je extensie configureerbaar maken voor gebruikers
Als je gebruikers jou extensie wilt laten configureren, dan moet je één of meerdere configuratievariabelen verschaffen. Het is slim om deze variabelen unieke namen te geven. Ze moeten ook de MediaWiki benamings conventies volgen(bijvoorbeeld: globale variabelen moeten beginnen met $wg).

Bijvoorbeeld, als jou extensie "extensie die niks doet" heet, dan wil je dat al je variabelen beginnen met $ednd of $EDND. Het is niet belangrijk wat je kiest zolang geen van de  MediaWiki core variabelen zo beginnen en je hebt gecheckt dat gepubliceerde extensievariabelen zo beginnen. Gebruikers zullen het niet waarderen als ze moeten kiezen tussen extensies omdat je variabelenamen overlappen met een andere extensie.

Het is ook een goed idee om uitgebreide documentatie voor alle configuratievariabelen in je installatienotities te plaatsen.

Hier is een boilerplate voorbeeld dat kan gebruikt worden om te starten:

Note that after calling  the global variable   does not exist. If you set the variable, e.g. in  then the value given in the will not be used.

Klassen klaarmaken om automatisch in te laden
Als je ervoor kiest om klassen te gebruiken om je extensie te implementeren, dan biedt MediaWiki een versimpeld mechanisme om PHP te helpen met het vinden van het bronbestand waar je klasse staat. In de meeste gevallen hoef je dan niet je eigen  methode te schrijven.

Om MediaWiki's autoloading mechanisme te gebruiken, voeg je vermeldingen toe aan het veld. De sleutel voor elke vermelding is de klassenaam; de waarde is het bestand dat de definitie van jou klasse bevat. Voor een 1-klasse-extensie heeft de klasse meestal dezelfde naam als de extensie, dus je autoloading sectie zit er ongeveer zo uit(extensie is genaamd "MyExtension"):

De bestandsnaam is gerelateerd aan de map waar je extension.json bestand in zit.

extra hooks definiëren
Zie.

Database-tabellen toevoegen
Als je extensie eigen tabellen moet toevoegen, gebruik de hook. Bekijk de handleidingpagina voor meer informatie over het gebruik.

Lokalisatie instellen
Zie:
 * Lokalisatie(Samenvatting)
 * Lokalisatie (uitgebreid)
 * Namespaces

Logs toevoegen
in Mediawiki worden alle gebruikersactie op een wiki gevolgd tbv transparantie en samenwerking. Bekijk om te zien hoe je dit doet?

Uitvoering
De techniek voor het schrijven van het implementatiegedeelte hangt af van welk deel van MediaWiki jij wilt uitbreiden:
 * Wiki opmaak: Extensies die wiki opmaak aanvullen bestaan meestal uit code die speciale XML tags,parser functies en variabelen definieert en implementeert.
 * Rapporteren en administratie: Extensies die rapportering and administratieve vaardigheden bieden doen dit gebruikelijk via speciale pagina's. Voor meer informatie zie.
 * Artikel automatisering en integriteit: Extensies die de integraties tussen MediaWiki en de achterliggende database verbeteren of artikelen controleert voor integriteitscapaciteiten voegen vaak functies to aan een van de vele hooks die het proces van het maken, aanpassen, hernoemen en het verwijderen van artikelen beinvloeden. Voor meer informatie over deze hooks en hoe je ze aan je code kan koppelen, bekijk.
 * look and feel Extensies die MediaWiki een andere interface en uiterlijk geven zitten vaak gebundeld in zogenaamde skins. Voor meer informatie over het maken van je eigen skins, zie en.
 * Beveiliging: Extensies die gebruikerslimieten bieden moeten integreren met MediaWiki's eigen toestemmingssysteem. Om meer over dit systeem te lezen, lees . Sommige extensies laten MediaWiki gebruik maken van externe authenticatiemechanismen. Voor meer informatie, zie . Als je extensie daarnaast probeert om de leesbaarheid van bepaalde artikelen te beperken, bekijk dan de 'gotchas' waarover gepraat wordt in.

Zie ook ,

Lokalisatie
Als je wilt dat je extensie gebruikt wordt op meertalige wiki's, dan is het verstandig om lokalisatie te ondersteunen in je extensie.

Berichten opslaan in "".json
Sla berichtdefinities in een lokalisatie JSON bestand op, één voor elke taal waarin je extensie vertaald is. De berichten worden opgeslagen met een berichtsleutel en het bericht zelf in standaard JSON format. Elk bericht ID moet kleine letters bevatten en mag geen spaties bevatten. een voorbeeld hiervan kan je zien in MobileFrontend. Hier is een voorbeeld van een minimum JSON bestand (in dit geval "en.json":

en.json

Berichtdocumentatie opslaan in "qqq".json
De documentatie voor berichtsleutels kan opgeslagen worden in het JSON bestand for de pseudo-taal met de code qqq. de documentatie voor het voorbeeld hierboven kan er zo uitzien:

qqq.json:

Berichten definiëren

 * Assign each message a unique, lowercase, no space message id; e.g.
 * Geef elk bericht een unieke, kleine lettersm, geen spatie bericht id; bijvoorbeelduploadwizard-desc
 * voor elke tekststring weergegeven aan de gebruiker, definieer een bericht.
 * MediaWiki ondersteunt berichten met parameters and die capaciteit moet gebruikt worden wanner een bericht onafhankelijk is van de informatie die gegenereerd wordt op het moment van runtime. Dummy Parameters worden aangegeven met $n, waar n de index van de placeholder is; bijvoorbeeld:

Berichtdocumentaitie definiëren
Elk bericht dat je definieert moet een geassocieerde berichtdocumentatie invoer hebben berichtdocumentatie in 'qqq.json bijvoorbeeld

lokalisatiebestand laden
In je installatie/opzet routine, definieer de locatie van je berichtbestanden(bijv. in de map i18n/):

Gebruik wfMessage in PHP
in je installatie- en implementatiecode, vervang elke statisch bericht met een call naar. In klassen die toepassen(alsook sommige subklassen van SpecialPage), kan in plaats daarvan   gebruiken. Voorbeeld:

Gebruik mw.message in JavaScript
het is mogelijk om i18n functies in JavaScript te gebruiken. zie voor details.

Extensietypes
Extensies kunnen gecategoriseerd worden gebaseerd op de programmeertechnieken die gebruikt zijn om hun functionaliteit te tonen. De meeste complexe extensies gebruiken vaak meer dan 1 van de volgende technieken:
 * Subklassering: MediaWiki verwacht bepaalde extensies die als subklassen van een MediaWiki basisklassen geïmplementeerd worden.
 *  – Subklassen van de klasse worden gebruikt om pagina's te bouwen waarvan de inhoud dynamisch gegenereerd wordt met behulp van ene combinatie van de huidige systeemstaat, input parameters en databasie queries. Zowel report en data invoer formulieren kunnen gegenereerd worden. Ze worden gebruikt voor rapportage- en  administratiedoeleinden.
 *  – Skins veranderen het uiterlijk en gebruik van Mediawiki door de code die pagina's maakt aan te passen door een subklasse te maken van de MediaWiki klasse.
 *  – Een techniek voor speciale PHP code te injecteren op specifieke punten in MediaWikiprocessen. Ze worden veel gebruikt door MediaWiki's parser, de lokalisatie-engine, de extensiemanagementsysteem, and haar pagina-onderhoudsysteem.
 *  – XML style tags die gekoppeld zijn aan een PHPfunctie die HTML code teruggeeft. Je hoeft jezelf niet te limiteren tot het formateren van text binnenin de tags. Je hoeft het niet eens weer te geven. Veel tag-extensies gebruiken tekst als parameters die de generatie van HTML helpt bij het invoegen van google objecten, data-invoer formulieren, RSS feeds en uittreksels van geselecteerde wiki-artikelen.
 *  – Een techniek voor het indexeren van een variëteit aan wiki tekst string aan een ID dat gekoppeld is aan een functie. zowelvariabelen enparser functies gebruiken beide deze techniek. Alle text die gekoppeld is aan dat id zal vervangen worden met de teruggave van de functie. de indexatie tussen de strings en het ID is opgeslagen in de $magicWords Array. De interpretatie van het id is een vrij ingewikkeld process - zie voor meer informatie.
 *  – Variabelen zijn een soort van misnaming. Variabelen zijn stukjes wikitekst die er uitzien als sjablonen maar die geen parameters hebben en die gekoppeld zijn aan hard-gecodeerde waardes. Standaard wiki-opmaak zoals of  zijn voorbeelden van variabelen. Ze krijgen hun naam van hun bronwaarden: een php-variabele of iets dat aan een variable gekoppeld kan worden, bijvoorbeeld een string, nummer, expressie of een teruggave van een functie.
 *  – .  Soortgelijk aan tag-extensies, parserfuncties bewerken argumenten een geven een waarde terug. in tegenstelling tot tag-extensies, het resultaat van een parserfunctie is wikitekst.
 *  – ya kan eigen modules aan MediaWiki's web API koppelen, die door javascript, bots en clients aangeroepen kan worden.
 *  – If you need to store data in formats other than wikitext, JSON, etc. then you can create a new.

Andere core versies ondersteunen
There are two widespread conventions for supporting older versions of MediaWiki core:

Extension maintainers should declare with the  parameter of the Extension template which convention they follow.
 * Master: the master branch of the extension is compatible with as many old versions of core as possible. This results in a maintenance burden (backwards-compatibility hacks need to be kept around for a long time, and changes to the extension need to be tested with several versions of MediaWiki), but sites running old MediaWiki versions benefit from functionality recently added to the extension.
 * Release branches: release branches of the extension are compatible with matching branches of core, e.g. sites using MediaWiki need to use the  branch of the extension. (For extensions hosted on gerrit, these branches are automatically created when new versions of MediaWiki are released.) This results in cleaner code and faster development but users on old core versions do not benefit from bugfixes and new features unless they are backported manually.

Publiceren
Om de documentatie van je bestaande extensie te auto-categoriseren en standaardiseren, zie. om je nieuwe extensie aan deze Wiki toe te voegen:

Inzetten en registreren
If you intend to have your extension deployed on Wikimedia sites (including possibly Wikipedia), additional scrutiny is warranted in terms of performance and security. raadpleeg.

Als je extensie namespaces toevoegt, dan will je wellicht zijn standaard namespaces registeren; soortgelijk, als database-tabellen of -velden toevoegt, dan wil je die wellicht registreren bij.

Please be aware that review and deployment of new extensions on Wikimedia sites can be extremely slow, and in some cases has taken more than two years.

Hulpdocumentatie
You moet public-domain hulpdocumentatie voor capaciteiten van je extensie beschikbaar maken. is een goed voorbeeld. Je moet gebruikers een link naar de documentatie geven via de functie.

Ondersteuning bieden / samenwerken
extensie-ontwikkelaars moeten een account maken op Wikimedia's, en een nieuw project voor de extensie aanvragen. Dit biedt een publiek forum waar gebruikers problemen en suggesties kunnen bieden, en je kan samenwerken met gebruikers en ontwikkelaars om bugs te vinden en toekomstige functionaliteiten toe te voegen aan je extensie.

Zie ook

 * – Implementeert sommige voorbeeldfunctionaliteiten met uitgebreide interne documentatie
 * – een functionele boilerplate extensie, handig als startpunt voor je eigen extensie
 * "Lees" de voorbeeldextensie, "baseer je eigen code op" de BoilerPlate extensie.
 * cookiecutter-mediawiki-extension – Een sjabloon voor de python tool cookiecutter om en BoilerPlate extensie te genereren (met variabelen etc.)
 * Zorgen ervoor dat je snel met je eigen extensie aan de slag kan. Kan ook de BoilerPlate extensie genereren.
 * - Kopieer specifieke code daarvan.
 * – Legt uit hoe je extensie API kan bieden an cliënten.
 * Best practices for extensions
 * Best practices for extensions
 * Best practices for extensions
 * Best practices for extensions
 * Best practices for extensions