Extensions MediaWiki

Extensions utiles

• Highlightjs Integration, git
• ReplaceText, native
• WikiEditor, native
• NativeSvgHandler, git
• SimpleMathJax, git

---

• MobileFrontend, git
• FooterManager
• Math
• SyntaxHighlight
• GoToCategory
• ContactPage

Création

Les dossiers et fichiers relatifs aux extensions doivent être placés dans /extensions.

• Extension Writing Tutorial
• Developing extensions
• Extensions FAQ
• Extensions pour mobile

extension.json

extension.json

{ "@comment": "Tout ce qui commence par @ sera ignoré", "name": "My Extension", "version": "1.0", "author": "Moi", "license-name": "CC-BY-NC-SA-4.0", "url": "https://www.mediawiki.org/wiki/Extension:MyExtension", "description": "My message", "type": "parserhook", "require": { "MediaWiki": ">= 1.27" }, "Hooks": { "ParserFirstCallInit": [ "MyExtensionClass::onParserFirstCallInit" ], "BeforePageDisplay": [ "MyExtensionClass::onBeforePageDisplay" ] }, "AutoloadClasses": { "MyExtensionClass": "MyExtension.class.php" }, "config": { "configElement1": "valeur", "configElement2": false }, "manifest_version": 1 }

• name: nom affiché dans Spécial:Version
• license-name
• type : api, antispam, datavalues, media, parserhook, semantic, skin, specialpage, variable, other
• manifest_version: version du schema d'extension.json, seule la version 1 est supportée

MyExtension.class.php

MyExtension.class.php

<?php class MyExtensionClass { public static function onParserFirstCallInit( Parser &$parser ) { global $configElement1, $configElement2; if ( $configElement2 === false ) { /* ... */ } return true; } public static function onBeforePageDisplay(OutputPage &$out, Skin &$skin) { $out->addModules('...'); return true; } }

MyExtension.php

Fichier de compatibilité utilisé seulement si l'extension est chargée avec require_once "$IP/extensions/MyExtension/MyExtension.php";

MyExtension.php

<?php if ( function_exists( 'wfLoadExtension' ) ) { wfLoadExtension( 'MyExtension' ); // Keep i18n globals so mergeMessageFileList.php doesn't break $wgMessagesDirs['MyExtension'] = __DIR__ . '/i18n'; return true; } else { die( 'This version of the MyExtension extension requires MediaWiki 1.25+' ); }

Ancienne méthode

MyExtension.php

<?php // Check environment if ( !defined( 'MEDIAWIKI' ) ) { echo( "This is an extension to the MediaWiki package and cannot be run standalone.\n" ); die( -1 ); } /* code de l'extension */ // pas de fermeture de la balise php

Chargement de l'extension

LocalSettings.php

wfLoadExtension( 'MonExtension' ); # charge le fichier /usr/share/webapps/mediawiki/extensions/MonExtension/extension.json

Ressources

ResourceLoader Features

extension.json

"ResourceModules": { "ext.MyExtension": { "scripts": [ "dossier/script.js", "script.js" ], "styles": "styles/style1.css" } }, "ResourceFileModulePaths": { "localBasePath": "", "remoteExtPath": "MyExtension", "remoteSkinPath": "MyExtension" },

• localBasePath: Important. Base path to prepend to all local paths, relative to current directory
• remoteExtPath: Optionnel. Base path to prepend to all remote paths, relative to $wgExtensionAssetsPath ($wgScriptPath/extensions)
• remoteSkinPath: Optionnel. Base path to prepend to all remote paths, relative to $wgStylePath ($wgScriptPath/skins)

MyExtension.class.php

public static function onBeforePageDisplay(OutputPage &$out, Skin &$skin) { $out->addModuleStyles( 'ext.MyExtension' ); return true; }

Si des erreurs du type Fatal exception of type MWException apparaissent dans la Browser Console de Firefox,
forcer l'affichage du détail des erreurs dans MediaWiki:

LocalSettings.php

$wgShowExceptionDetails = true;

Cela peut être du à :

• des mauvais chemins
• des problèmes de droits en lecture

Special pages

Built-in special pages are located in the includes/specials directory. Source code: includes/specialpage/SpecialPage.php

MySpecialPage/extension.json

{ "name": "MySpecialPage", "version": "1.0", "author": "Me", "url": "https://www.mediawiki.org/wiki/Extension:MySpecialPage", "descriptionmsg": "myspecialpage-desc", "license-name": "AGPL-3.0", "type": "other", "AutoloadNamespaces": { "MediaWiki\\Extension\\MySpecialPage\\": "src/" }, "SpecialPages": { "MyExtension": "MediaWiki\\Extension\\MySpecialPage\\Special" }, "AvailableRights": [ "myspecialpage-right" ], "MessagesDirs": { "MyExtension": [ "i18n" ] }, "manifest_version": 2

MySpecialPage/src/Special.php

<?php class SpecialMyExtension extends SpecialPage { // UnlistedSpecialPage public function __construct() { parent::__construct( 'MyExtension' ); } public function execute( $par ) { $request = $this->getRequest(); $output = $this->getOutput(); $this->setHeaders(); # Get request data from, e.g. $param = $request->getText( 'param' ); $output->addWikiTextAsInterface( '= Titre =' ); $output->addHTML( "<div>" );

MySpecialPage/i18n/fr.json

{ "@metadata": { "authors": "Me" }, "myspecialpage": "My Special Page", "myspecialpage-desc": "My Special Page description.", "myspecialpage-summary": "My Special Page summary."

• Resource Modules

Parser un string Mediawiki

$output = $parser->recursiveTagParse("=Titre=", $frame ); // <h1>Titre</h1>

Créer des nouvelles balises

$wgHooks['ParserFirstCallInit'][] = 'newTags'; function newTags( Parser $parser ) { $parser->setHook( 'nouvelleBalise', 'renduPourLaNouvelleBalise' ); return true; } function renduPourLaNouvelleBalise( $input, array $args, Parser $parser, PPFrame $frame ) { $nb = 5; if (array_key_exists('nb', $args) && is_numeric ($args['nb']) && $args['nb'] > 0) { $nb = $args['nb']; } return '<strong>' . htmlspecialchars( $input ) . '</strong>'; }

<nouvelleBalise nb=5 />

Tag extensions

Requête dans la base de données

$querySQL = "SELECT colonne1 FROM table1"; $dbr = wfGetDB( DB_SLAVE ); $res = $dbr->query( $querySQL ); $count = $dbr->numRows( $res ); if( $count > 0 ) { while( $row = $dbr->fetchObject( $res ) ) { $valeur = $row->colonne1; } } else { ... }

Formation du code HTML

Xml::openElement( 'p', array( 'class' => 'maclasse' ) ); Xml::closeElement( 'p' ); Xml::tags( 'p', array( 'class' => 'maclasse' ), "contenue" );

Désactiver le cache pour les pages qui utilise l'extension

function wfSomeHookFunction( $parser, $foo, $bar ) { $parser->disableCache(); }

How do I disable caching for pages using my extension

timestamp UTC → date locale

$timestamp = ... // timestamp UTC récupéré dans la BdD : 20120530111700 // récupération du context, utile pour connaitre la langue et l'utilisateur $context = RequestContext::getMain(); // convertion du timestamp de la base de donnée vers le timestamp Mediawiki $timestamp = wfTimestamp( TS_MW, $row->rev_timestamp ); // utilisation des préférences de l'utilisateur pour la conversion du timestamp en date $date = $context->getLanguage()->userTimeAndDate( $timestamp, $context->getUser() ); // 30 mai 2012 à 13:17

Manipulation autour de timestamp et de date:

// convertion du timestamp Mediawiki en timestamp UNIX $unixTimestamp = wfTimestamp( TS_UNIX, $timestamp); // 1338376620 // date en anglais date("l j F Y - H:i", $unixTimestamp); // Wednesday 30 May 2012 - 13:17 // date suivant la locale strftime("%A %e %B %G - %H:%M", $unixTimestamp); // conversion en heure GMT + ajout du décalage du fuseau horaire $offset = date("Z"); // 7200 gmstrftime("%A %e %B %G - %H:%M", $unixTimestamp + $offset);

wfTimestamp
date
strftime

Crédits

[1]

Hook

[2]

AJAX

## Abort if AJAX is not enabled if ( !$wgUseAjax ) { trigger_error( 'Please enable AJAX : «$wgUseAjax = true;» in LocalSettings.php', E_USER_WARNING ); return; }

Publier une extension

Page de l'extension sur mediawiki.org

• Template Extension
• Template ExtensionInstall

Exemples

Compter le nombre de pages sans catégories

// jointure de categorylinks dans page avec cl_from = page_id // résultat: cl_from IS NULL pour les pages sans catégories // seulement les articles: page_namespace = 0 // pas les redirection: page_is_redirect = 0 $query = "select page_namespace, page_title, cl_from from page left outer join categorylinks on cl_from = page_id where page_namespace = 0 and page_is_redirect = 0 and cl_from IS NULL;"; $dbr = wfGetDB( DB_SLAVE ); $res = $dbr->query( $query ); // liens vers les sans catégories $output .= $dbr->numRows( $res ) . " pages";

Inspiré du fichier « includes/specials/SpecialUncategorizedpages.php »

Liens interne

$output .= Linker::linkKnown( SpecialPage::getTitleFor( 'Allpages' ), "Toutes les pages !!!"); $title = Title::newFromText("Special:Uncategorizedpages"); $output .= "<a href=\"" . $title->getFullURL() . "\">Sans cat&eacute;gories</a>"; $output .= $parser->recursiveTagParse( "[[Special:Uncategorizedpages|Sans cat&eacute;gories]]", $frame );

Nombre d'articles

// colonne ss_good_articles de la table site_stats // An approximate count of pages matching the following criteria: // in namespace 0 // not a redirect // contains the text '[[' $nbPages = SiteStats::articles(); // {{NUMBEROFARTICLES}} // colonne ss_total_pages de la table site_stats // Total pages, theoretically equal to SELECT COUNT(*) FROM page; except faster $nbPages = SiteStats::pages(); // {{NUMBEROFPAGES}} // requête SQL pour un résultat précis mais peut poser un problème de performance $query = "select count(*) from page where page_namespace = 0 and page_is_redirect = 0"; $dbr = wfGetDB( DB_SLAVE ); $res = $dbr->query( $query ); $nbPages = $res->fetchRow()[0];

• site_stats table

Fichiers:

• includes/specials/SpecialAllPages.php
• includes/SiteStats.php