Handleiding:Extensies
Met een extensie kunt u het uiterlijk en de werking van MediaWiki aanpassen.
- Systeembeheerder kunnen extensies installeren (en verwijderen) in de MediaWiki installaties die zij beheren.
- Ontwikkelaars kunnen nieuwe extensies maken of bijdragen aan bestaande extensies.
Use extensions at your own risk, particularly those tagged as insecure. Als een extensie patches voor de kernsoftware vereist, zorg er dan voor dat u van tevoren een back-up van uw database maakt om het risico te voorkomen dat uw wiki stuk gaat.
Extensies selecteren
Gebundelde extensies
Verschillende extensies zijn standaard gebundeld met MediaWiki .
Deze extensies moeten over het algemeen van groot nut zijn, efficiënt presteren, stabiel zijn, goed geschreven zijn en geen bekende grote beveiligingsproblemen hebben. Ze moeten ook compatibel zijn met de nieuwste versies van MediaWiki en met elkaar (d.w.z. de ene extensie mag de functies van de andere niet blokkeren). Een gebundelde extensie kan afhankelijk zijn van een of meer andere extensies, zolang deze ook gebundeld zijn.
Sitebeheerders krijgen deze automatisch bij het installeren of upgraden van MediaWiki. Bij het upgraden van MediaWiki worden eventuele extensie-upgrades ook automatisch toegepast. Sitebeheerders kunnen ervoor kiezen om een van deze te verwijderen, als ze dat willen.
Er zijn lopende discussies over welke extensies deel moeten uitmaken van deze groep. U kunt extensies voorstellen om mee te nemen in de bundel . Extensies worden gebundeld zodra de ontwikkelaars een consensus bereiken om dit te doen.
Een extensie kan uit de bundel worden verwijderd als de functionaliteit ervan wordt samengevoegd in MediaWiki core , het wordt vervangen door een alternatief of in het onwaarschijnlijke geval dat er onoplosbare grote beveiligingslekken worden ontdekt.
Extensies bekijken
Blader door Category:All extensions/nl of Category:Extensions by category/nl om het volledige assortiment beschikbare extensies te zien.
Geïnstalleerde extensies controleren
Welke extensies actief zijn op een instantie van MediaWiki kan worden gecontroleerd door naar de pagina Special:Version te gaan en naar beneden te scrollen naar de kop Geïnstalleerde extensies (anchor #mw-version-ext
).
Voorbeeld: Deze extensies zijn geïnstalleerd op deze wiki, en deze extensies zijn actief op de Engelse Wikipedia.
Populaire extensies
U kunt op meerdere manieren naar populaire extensies zoeken.
Van extensies die van MediaWiki.org worden gedownload via ExtensionDistributor worden wat statistieken verzameld. Er is een top15 (Special:ExtensionDistributor), een lijst met de 15 vaakst gedownloade extensies. In de infobox van een extensie wordt aangegeven hoe vaak die extensie is gedownload. Deze aantallen zijn helaas niet volledig omdat alternatieve manieren van installeren, zoals via Git of Composer, niet worden meegeteld.
Een andere mogelijkheid is te kijken naar WikiApiary , het aantal wiki's waarop een extensie is geïnstalleerd. Het voordeel is dat men dan kijkt naar het aantal actuele installaties en niet naar het aantal downloads (het gebruikt de wiki's API's voor de aantallen), het zijn ook (in 2023) actuele gegevens. Het telt ook geen installaties op private wiki's.
Extensie installeren
- Lees Manual:Extensions/Installation and upgrade voor meer ondersteuning
MediaWiki is na de installatie direct klaar om extensies te accepteren. Volg deze stappen om een extensie te installeren:
- Voor het installeren
- Veel extensie geven instructies voor de installatie van de extensie met gebruik van Unix commando's.U heeft toegang tot de shell (SSH) nodig om deze commando's die op de helppagina's van de extensie staan, in te voeren.
- Extensie downloaden
- Met de Extension Distributor kunt u de meeste populaire extensies selecteren en downloaden.
- Extensies worden meestal al modulaire packages gedistribueerd.Ze komen meestal in een eigen submap van
$IP /extensions/
te staan.Een lijst met extensies opgeslagen in de Wikimedia Git repository staat op: git:mediawiki/extensions.Enkele extensies gebruiken geen versiecontrole, deze extensies worden niet aanbevolen. - Enkele extensies zijn ook beschikbaar in bundels, Composer/nl of package repositories.
- Wij bevelen aan om voor een installatie eerst altijd het bestand README te lezen.Daarin staat mogelijke belangrijke informatie over de configuratie.
- Extensie installeren
- Voeg onderaan het bestand
LocalSettings.php
toe: wfLoadExtension( 'ExtensionName' );
- Door deze regel wordt de PHP-interpreter aangestuurd om het extensie bestand te lezen, hierdoor wordt het benaderbaar voor de MediaWiki.
- Sommige extensies kunnen problemen geven met onderhoudsscripts, bijvoorbeeld als ze de
$_SERVER
variabelen direct benaderen (niet aanbevolen). In dit geval kunnen ze ingepakt worden in de conditie, zodat de onderhoudsscripts nog steeds uitgevoerd kunnen worden. if ( !$wgCommandLineMode ) { wfLoadExtension ( 'ExtensionName' ); }
- Het onderhoudsscript importDump.php zal mislukken als een extensie een aangepaste namespace wil hebben die is toegevoegd in een conditie, zoals Extension:Semantic MediaWiki , Extension:Page Forms/nl .
- Voeg onderaan het bestand
- Controleer dat de verplichte rechten zijn toegekend aan de extensies!
- Hoewel deze wijze van installeren voor de meeste extensies zal werken,kan er bij een paar een andere wijze nodig zijn.Lees voor elke extensie de details de documentatie van de extensie.
- Als u de configuratie variabelen in
LocalSettings.php
wilt aanpassen, dan zal u dat na het toevoegen van de extensie moeten doen.Anders overschrijven de standaarden van de extensie uw instellingen.
Extensies bijwerken
Enkele extensies vereisen dat ze bijgewerkt worden, als u de versie van MediaWiki bijwerkt. Andere extensies kunnen met meerdere versies van MediaWiki werken. Het upgraden van een extensie:
- Download de nieuwe versie van de extensie
- Vervang alle bestanden van de extensie in de map
extensions/ExtensionName
met de nieuwe bestanden.Laat de configuratie van de extensie staan in bestandLocalSettings.php
- Als er voor de extensie wijzigingen nodig zijn in de database, dan moet u het onderhoudsscript update.php uitvoeren.De meeste extensies zullen wel aangeven of dat script wel/niet uitgevoerd moet worden.(Maak altijd eerst een back-up van uw database voordat u het script uitvoert.)Als u geen toegang heeft tot de commando-regel, dan kunt u de web updater gebruiken.
Extensie verwijderen
Verwijder uit LocalSettings.php
de regel met de naam van de extensie om de extensie uit de installatie te verwijderen:
wfLoadExtension( 'ExtensionName' );
- Verwijder alle regels die horen bij de configuratie van die extensie.
Extensies ontwikkelen
MediaWiki core biedt verschillende manieren voor extensies om het gedrag en het uiterlijk van een wiki te veranderen. Deze extension-points geven extensies de flexibiliteit om functies en functionaliteit toe te voegen, zoals het weergeven van een speciale pagina of het definiëren van een API-module. Om te beginnen, zie de gids voor het ontwikkelen van extensies . Voordat u een nieuwe extensie schrijft, kunt u overwegen bij te dragen aan een bestaande extensie of te helpen met het onderhouden van een niet-onderhouden extensie .
Gebruikers kunnen ook een algemene aanvraag doen op Phabricator, en hopen dat uw goede idee wordt opgepikt door een ontwikkelaar. Zie https://phabricator.wikimedia.org/tag/mediawiki-extension-requests/
Zie ook
- Category:Extensions/nl
- Sjabloon:Extensie
- Handleiding: Extensies ontwikkelen
- Manual:Translating extensions - Informatie over het vertalen van extensies.
- Special:ExtensionDistributor - Bevat een lijst met de 15 extensies die het vaakst worden gedownload in Wikimedia version control
- extloc - Where are MediaWiki extensions deployed in Wikimedia production?
- API:Siteinfo#Extensions