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

Intellen
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:

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. They are used for both reporting and administration purposes.
 *  – Skins change the look and feel of MediaWiki by altering the code that outputs pages by subclassing the MediaWiki class.
 *  – A technique for injecting custom php code at key points within MediaWiki processing. They are widely used by MediaWiki's parser, its localization engine, its extension management system, and its page maintenance system.
 *  – XML style tags that are associated with a php function that outputs HTML code. You do not need to limit yourself to formatting the text inside the tags. You don't even need to display it. Many tag extensions use the text as parameters that guide the generation of HTML that embeds google objects, data entry forms, RSS feeds, excerpts from selected wiki articles.
 *  – A technique for mapping a variety of wiki text string to a single id that is associated with a function. Both variables and parser functions use this technique. All text mapped to that id will be replaced with the return value of the function. The mapping between the text strings and the id is stored in the array $magicWords. The interpretation of the id is a somewhat complex process – see  for more information.
 *  – Variables are something of a misnomer. They are bits of wikitext that look like templates but have no parameters and have been assigned hard-coded values. Standard wiki markup such as or  are examples of variables. They get their name from the source of their value: a php variable or something that could be assigned to a variable, e.g. a string, a number, an expression, or a function return value.
 *  – .  Similar to tag extensions, parser functions process arguments and returns a value. Unlike tag extensions, the result of parser functions is wikitext.
 *  – you can add custom modules to MediaWiki's "action" web API, that can be invoked by JavaScript, bots or third-party clients.

Support other core versions
You can visit the extension support portal to keep on top of changes in future versions of MediaWiki and also add support for older versions that are still popular.

Publishing
To autocategorize and standardize the documentation of your existing extension, please see. To add your new extension to this Wiki:

Deploying and registering
Consult. If your extension adds namespaces, you may wish to register its default namespaces; likewise, if it adds database tables or fields, you may want to register those at.

Help documentation
You should provide public-domain help documentation for features provided by your extension. is a good example. You should give users a link to the documentation via the function.

Providing support / collaboration
Extension developers should open an account on Wikimedia's, and request a new project for the extension. This provides a public venue where users can submit issues and suggestions, and you can collaborate with users and other developers to triage bugs and plan features of your extension.