Manual:Code/fr

Cette page décrit les fichiers-sources principaux du code de MediaWiki.

index.php

 * sur SVN

Principal point d'entrée du logiciel MediaWiki. Il se charge de la majorité des requêtes. Voir Manual:Index.php/fr.

api.php

 * sur SVN

L'autre point d'entrée de l'extérieur pour l'API, mais peut aussi être utilisé à l'interne par le reste du code. Voir API/fr pour une description approfondie.

img_auth.php

 * sur SVN

Script qui ne renvoie les images qu'aux utilisateurs enregistrés. Pour configurer le wiki pour utiliser ce script, voyez Manual:Image Authorisation.

opensearch_desc.php

 * sur SVN

Retourne un document de description OpenSearch (voyez http://www.opensearch.org/) qui pointe vers les moteurs de recherche du wiki.

profileinfo.php

 * sur SVN

Autorise les utilisateurs a voir les informations de profilage sauvegardées dans la base de données. Voyez How to debug.

redirect.php

 * sur SVN

Réoriente vers l'article passé dans le paramètre wpDropdown de la requête.

thumb.php

 * sur SVN

Script qui redimensionne les images.

trackback.php

 * sur SVN

Ajoute un nouveau rétrolien dans la base de données.

Répertoire /includes/
Ce répertoire contient tous les fichiers requis par MediaWiki.

Article.php

 * sur SVN

Contient la classe Article. Elle représente un article du wiki, peut le modifier (actions edit, delete...) et pourvoit à son état (formatage du wikicode, flags, etc.). Voir Manual:Article.php.

LinkCache.php

 * sur SVN

Garde les informations à propos de l'existence des articles. Voir LINKCACHE.TXT.

Linker.php

 * sur SVN

OutputPage.php

 * sur SVN

Contient :
 * la fonction output, appelée depuis la fonction finalCleanup de Wiki.php . Elle appelle la fonction outputPage de Skin.php ;
 * la fonction out, appelée depuis la fonction outputPage de Skin.php plusieurs fois pour envoyer le code HTML à l'utilisateur : $mBodytext précédé et suivi du code HTML.

Le fichier contient aussi la fonction addPrimaryWikiText</tt> (obsolète, remplacée par addWikiText</tt> de Article.php) qui :
 * applique la fonction parse</tt> de Parser.php au wikitexte $text</tt>, générant ainsi du code HTML $text</tt> ;
 * applique la fonction addParserOutput</tt> au code HTML $text</tt>, qui elle-même applique la fonction addHTML</tt> à $text</tt>, annexant ainsi $text</tt> à $mBodytext</tt>.

Pager.php

 * sur SVN

Contient la classe IndexPager</tt> utilisée pour ordonner les résultats des requêtes MySQL. Voir Manual:Pager.php.

Parser.php

 * sur SVN (répertoire "/includes/parser/" depuis la version 1.13)

Ce fichier définit l'objet Parser</tt> utilisé pur convertir le wikitexte en HTML. Voir Manual:Parser.php.

Setup.php

 * sur SVN

Ce fichier inclut plusieurs fichiers couramment utilisés et crée les variables objet globales qui permettent à MediaWiki de fonctionner. Voir Manual:Setup.php.

Skin.php

 * sur SVN

Ce fichier gère l'apparence du wiki. Toutes les fonctions qui retournent du HTML et des options pour la mise en forme de ce dernier s'y trouvent, et sont appelées des différents fichiers au besoin.

Il contient la fonction outputPage</tt>, appelée depuis la fonction output</tt> de OutputPage.php bon nombre de fois, pour envoyer mBodyText</tt> à l'utilisateur avec le code HTML qui l'encadre.

L'objet <tt>StandardSkin</tt> est une implémentation complète, et est destiné à ce qu'on y greffe des sous-classes d'autres skins qui écraseront certaines des fonctions parentes. L'objet <tt>User</tt> contient une référence vers un skin (selon les préférences de l'utilisateur), et alors plutôt que d'avoir un objet "skin" global, nous relions le skin à l'objet <tt>User</tt> avec <tt>$wgUser->getSkin</tt>.

Title.php

 * sur SVN

Ce fichier représente le titre d'un article, et exécute tout le travail de traduction entre ses différentes formes telles que le texte en clair, l'URL, la clé de la base de données, etc. Par commodité, et pour des raisons historiques, il représente aussi certaines fonctionnalités des articles ne concernant pas le texte, notamment les droits d'accès.

User.php

 * sur SVN

Ce fichier décrit l'état de l'utilisateur visionnant/modifiant le site. Il peut être questionné sur les paramètres de l'utilisateur, son nom, etc. Il s'occupe des requêtes en lecture et en écriture de la table <tt>users</tt> de la base de données, et gère les cookies et les sessions.

WebStart.php

 * sur SVN

Ce script initialise une requête Web : vérifications de sécurité, chargement de LocalSettings.php et de Setup.php. Voir Manual:WebStart.php.

Wiki.php

 * sur SVN

Ce fichier consiste en la définition de la classe <tt>MediaWiki</tt>. Voir Manual:Wiki.php.

Répertoire /languages/
Ce répertoire contient les fichiers utilisés pour l'internationalisation.

Language.php

 * sur SVN

Ce fichier contient la classe <tt>Language</tt>, qui représente les langues utilisées pour accompagner le texte, et aussi quelques fonction d'encodage de caractères. Deux variables globales sont en lien avec cette classe : $wgContLang pour la langue du site et $wgLang  pour la langue de l'utilisateur.

Répertoire /maintenance/
Ce répertoire contient des scripts de maintenance devant être exécutés en ligne de commande. Voir Manual:Maintenance scripts pour une liste de ces scripts.

Répertoire /skins/
Ce répertoire contient toutes les classes de skins, le code Javascript, les CSS et les images utilisées par les skins.

Voir aussi

 * How to become a MediaWiki hacker/fr
 * Manual:Coding conventions/fr