doc

Ce modèle devrait être ajouté sur toutes les pages d'extention en français de ce wiki (seulement sur la page principale). Il mettra en place une infobox utile (voir plus bas) et ajoutera automatiquement l'extension dans la catégorie Toutes les extensions ainsi que les catégories extension par état et les type d'implementation.

Utilisation

Copiez et collez ce qui suit : {{Extension/fr|templatemode = |name = |status = |type1 = |type2 = |hook1 = |hook2 = |username = |author = |description = |image = |imagesize = |version = |update = |version preview = |update preview = |mediawiki = |php = |needs-updatephp = |composer = |table1 = |table2 = |license = |download = |readme = |changelog = |example = |namespace = |parameters = |tags = |rights = |compatibility = |bugzilla = }} Si vous souhaitez avoir de l'aide sur les valeurs des paramètres, voyez plus bas.

Manuel des extensions MediaWiki 40px {{{name}}} État de la version : unknown 220px Implémentation Description {{{description}}} Auteur(s) Un auteur (SomeUsertalk) Dernière version {{{version}}} ({{{update}}}) Latest preview version {{{version preview}}} ({{{update preview}}}) MediaWiki {{{mediawiki}}} PHP {{{php}}} Changements base de données {{{needs-updatephp}}} Composer {{{composer}}} Licence Téléchargement {{{download}}} {{{readme}}} {{{changelog}}} Exemple {{{example}}} Espace de nom {{{namespace}}} Paramètres {{{parameters}}} Tags {{{tags}}} Droits ajoutés {{{rights}}} Hooks utilisés hook1 hook2 {{{compatibility}}} [[translatewiki:Special:Translate/ext-|Translate the Extension/fr extension]] if it is available at translatewiki.net Issues: [[phab:tag/MediaWiki-extensions-{{{bugzilla}}}|Open tasks]] · Report a bug

Paramètres de contenu

Cette section décrit les paramètres qui gèrent le contenu de l'infobox. En ce qui concerne templatemode et les autres paramètres de contrôle, veuillez voir la section Paramètres de contrôle.

Paramètres de contenu

Paramètre	Traduction	Description
name	nom	nom de l'extension
status	état	état de la version courante Options possibles : unstable (instable - ne pas utiliser cette extension) experimental (premières étapes de développement, peut changer de façon drastique) beta (stable mais non testée dans son ensemble) stable (version stable) unknown (par défaut, statut inconnu) Si le statut ne figure pas parmi les choix ci-dessus, il sera ignoré et la valeur par défaut 'Unknown' (inconnu) sera affiché dans le modèle. Dans le cas où la valeur est manquante, l'extension entrera dans la catégorie statut inconnu. Dans le cas où la valeur est non valide, l'extension sera placée dans une catégorie spéciale afin que l'erreur puisse être tracée et résolue. Couleurs utilisées pour définir les statuts
type1 type2 type3 type4 type5 type6	idem	type d'implémentation La(Les) stratégie(s) d'implémentation employée(s) en construisant cette extension. Ce paramètre est utilisé pour créer des catégories qui aident les programmeurs à trouver des exemples de diverses stratégies ou schémas d'implémentation spécifiques de MediaWiki. Bien que les valeurs de ce paramètre coïncident quelquefois avec le cas d'utilisation et l'objet d'une extension, ce n'est pas la raison d'être de ce paramètre. Si les valeurs que vous avez choisies pour ce paramètre n'identifient pas de façon adéquate le but ou les cas d'utilisation, nous vous recommandons d'ajouter autant de liens de catégorie que nécessaire. Les valeurs légales pour les paramètres type1, type2, etc. sont : parser - catégorie d'appel pour les extensions parseurTemplate:Lang non catégorisées. Si vous avez écrit une extension parseur, veuillez SVP utiliser l'un des types suivants plus précis : contenthandler - Extensions utilisant ContentHandlerTemplate:Lang. link - marqueur de lienTemplate:Lang personnalisé, par ex. [[...]] parser function - marqueur de modèle paramétréTemplate:Lang personnalisé, par ex. {{#name: ... }} tag - marquage de balise XML personnaliséTemplate:Lang, par ex. <tagname>...</tagname> variable - marquage de modèle non paramétréTemplate:Lang personnalisé, par ex. {{NAME}} extended syntax - extensions qui ajoutent une syntaxe wiki non standard (c'est-à-dire tout ce qui ne fait pas partie de la catégorie balises, fonctions parseur ou variables). interface - catégorie d'appel pour les extensions de l'interface utilisateur non catégorisées. media - extensions qui permettent l'embarquement de contenu multimédia sur les pages wiki par enregistrement d'une extension fichier avec $wgMediaHandlersTemplate:Lang mywiki - extensions qui gèrent l'infrastructure afin que les utilisateurs puissent personnaliser leur expérience MediaWiki et/ou participer à la gestion de cette infrastructure notify - extensions qui envoient des courriels aux utilisateurs, diffusent des messages et fournissent d'autres moyens de notifications pour la communauté page action - extensions qui améliorent ou modifient les actions de pageTemplate:Lang. Cette catégorie comprend tout ce qui implémente une action qui lit, écrit, fait des recherches, crée, renomme, supprime, redirige ou parle d'une page. Elle n'inclut pas tout ce qui concerne les droits (utilisez user rights) ou les journaux de bord (utilisez user activity). search - extensions qui exécutent des recherches et sélectionnent des articles pour les utilisateurs skin - extensions qui ajoute du CSS ou du JavaScript, ou bien qui implémentent des fonctions hook afin de modifier l'aspect de MediaWiki via l'architecture des habillages ajax - extensions qui utilisent les techniques de programmation Ajax special - extensions qui sous-classent la classe SpecialPageTemplate:Lang, utilisent l'un de ses hooks, ou bien ajoutent des patches sur une ou plusieurs fonctions dans SpecialPage.php. Voyez le manuel sur les pages spécialesTemplate:Lang pour plus d'information sur le sujet. autres api - extensions qui ajoutent un nouveau module API ou étendent un module API du noyau hook - extension hook - définit un nouveau hook - voyez hook1, etc. ci-dessous si vous voulez définir les hooks utilisés par votre extension pfunc - même chose que parser function Nous sommes en train de revoir les valeurs de cette page. Les types situés sous cet encart sont très certainement obsolètes ou redéfinis. Nous nous excusons de la gène occasionnée. Voyez Template talk:Extension/Archive_1#Type taxonomyTemplate:Lang pour plus d'information. database - ajoute des tableaux et/ou des champs dans la base de données soutenant une installation MediaWiki db - même chose que database data extraction - extraction de données example - ce n'est pas une véritable extension, mais un exemple sur la manière d'en écrire une Tout autre valeur pour 'type' est incorrecte et placeront l'extension dans la catégorie Extensions avec un type non valide ou manquant.
hook1 hook2 hook3 hook4 ... hook30	greffon ou hook	nom de chaque hook (ou greffon) utilisé par l'extension L'entrée de valeurs dans ce champ est un bon moyen de dévoiler votre extension et d'aider ainsi les autres développeurs. Chaque hook documenté ajoutera automatiquement l'extension dans un listing de catégorie qui utilise ce hook. Cette catégorie est auto-liée à chaque article de hook afin que les programmeurs puissent facilement trouver des exemples d'extensions qui utilisent ce hook particulier. Pour les hooks déjà inclus : utiliez simplement le nom du hook seul. Veuillez voir Manual:HooksTemplate:Lang pour les valeurs (mais ne mettez pas le '/' de présentation). Pour les hooks personnalisés définis par les extensions : utilisez extensionName/hookName. Pour une liste partielle des hooks personnalisés, voyez Extension hook registryTemplate:Lang. Pour des hooks multiples, assignez le premier à hook1, le second à hook2 et ainsi de suite.
username	Identifiant utilisateur	L'identifiant de l'auteur sur MediaWiki.org (s'il en a un). Peut être omis, mais s'il est renseigné, il sera utilisé pour faire un lien vers les pages utilisateur et discussion utilisateur de l'auteur. Il devrait être rempli sans espace de nom et sans [[]].
description	description	description succinte
image	image	capture d'écran ou logo de l'extension. Elle devra être entrée sans espace de nom et sans [[]].
imagesize	taille image	facultatif, taille de l'image (taille par défaut : 220px)
version	version	dernière version
update	mise à jour	date de la dernière mise à jour
mediawiki	mediawiki	version requise de MediaWiki
php	php	version requise de PHP
needs-updatephp	besoin d'update.php	yes indique que l'extension nécessite un changement du schéma des tableaux de la base de données ou une action équivalente avant que MediaWiki puisse tourner. C'est un élément incontournable : votre MediaWiki va planter si vous oubliez de lancer update.php - si bien entendu l'extension nécessite de le faire. Les extension qui sont conformes aux standards d'extension de MediaWiki sont livrées avec un script de changement de schéma qui vous devrez lancer manuellement (une fois) avant de démarrer et accéder à MediaWiki via votre navigateur, et après avoir copié tous les fichiers d'extension dans $IP/extensions/ExtensionName et inséré require_once( "$IP/extensions/ExtensionName" ) dans $IP/LocalSettings.php : php $IP/maintenance/update.php {{ Template:TNTN |1=$IP désigne le répertoire d'installation (or "chemin" path en anglais) de votre installation MédiaWiki, le répertoire qui contient LocalSettings.php, index.php etc..}}
schema-registry	registre de schéma	yes indique que les modifications du schéma de l'extension sont répertoriées dans le registre des tableaux et champs de la base de donnéesTemplate:Lang.
license	licence	licence(s) utilisée(s) pour cette extension, par ex. GPL
download	téléchargement	lien pour le téléchargement : SVN, Template:Tl avec server=gerrit, ou tout autre. Si vous entrez du code directement sur une page wiki de MediaWiki, faites un lien vers celle-ci en utilisant le nom de la page en entier et un nom de section, par ex. [[Extension:Exemple/version_1.22a#Code]] (il doit rester valide quand il est copié ailleurs par un bot)
readme	lisez-moi	lien externe vers le fichier lisez-moi : http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/Sort/README
changelog	journal des modifications	lien externe vers le fichier journal des modifications : http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/Sort/Sort
parameters	paramètres	paramètres disponibles pour LocalSettings.php
tags	balises	toutes les balises que votre extension utilise (par ex. <tag1>, <tag2>).
rights	droits	droits ajoutés par l'extension. Ne pas confondre avec la licence ! Les droits correspondent à des choses comme makebotTemplate:Lang ou desysopTemplate:Lang, non à des choses comme GFDL ou LGPL ou GPL - ce sont des licences !
namespace	espace de nom	espace de nom dans lequel cette extension est utilisée
example	exemple	exemple, site web ou capture d'écran de l'extension en utilisation
compatibility	compatibilité	charte de compatibilité, par ex. Template:Extension Testing
bugzilla	bugzilla	nom du composant de l'extension MediaWiki sur bugzilla
CheckUsageNameOverride		écrase le nom de la page utilisé pour le lien de vérification d'utilisation

Paramètres de contrôle

Paramètres de contrôle

Paramètre

Description

templatemode

Contrôle l'auto-catégorisation de la page hôte. Normalement, ce champ est vide. Voici les autres valeurs possibles : nocats - supprime la catégorisation et le lien 'check usage'. Utilisez cette valeur si vous ajoutez ce modèle dans la sous-page d'une extension ou dans la documentation how-to des extensions. Par exemple, l'exemple utilisé ci-dessus a comme paramètre templatemode=nocats parce ce que ce n'est pas une page d'extension et nous ne voulons pas ajouter cette page dans les catégories qui n'ont rien à y faire. nousage - supprime le lien 'check usage'. Le lien est supprimé de même si la page est une sous-page : elle n'est pas dans l'espace de nom Extension:, ou si elle est supprimée par 'templatemode=nocats' Si le champ est laissé vide, ce modèle ajoutera la page hôte à Category:All extensions/fr et dans une ou plusieurs catégories suivant les valeurs entrées dans les paramètres de contenu.

Utilisation de l'infobox

Pages d'extension existantes

Si vous voulez ajouter l'infobox sur une page existante, copiez-collez le code situé haut de la page.

Créer un nouvel article sur une extension

Si vous voulez créer une nouvelle page d'extension, entrez le nom ci-dessous et cliquez sur le bouton. Une nouvelle page sera créée avec le modèle infobox déjà en place.

Il est d'abord préférable de créer la page d'extension en anglais, puis de faire celle en francais.

<inputbox> type=create bgcolor=#eeeeff width=40 placeholder=Enter your extension's name here prefix=Extension: preload=Template:Extension/Sample buttonlabel=Create </inputbox>

Pour la version française :

Veuillez remplacer "MyExtension" avec le nom de l'extension (suivi de /fr pour la version française) : <inputbox> type=create bgcolor=#eeeeff width=40 default=Extension:MyExtension/fr preload=Template:Extension/Sample/fr buttonlabel=Créer la page d'extension </inputbox> MediaWiki est un projet open-source et les utilisateurs sont encouragés à faire leurs extensions MediaWikiTemplate:Lang sous une licence compatible approuvée GPLv2 Open Source Initiative (OSI) (y compris MIT, BSD, PD). Pour les extensions qui ont une licence compatible, vous pouvez demander un accès développeurTemplate:Lang sur les bases de connaissance MediaWiki pour les sources des extensions et obtenir un nouveau répertoire créé à votre attention. Vous pouvez aussi poster votre code directement sur la page de votre extension, bien que ce ne soit pas la méthode préférable.

Un développeur qui partage son code sur le wiki MediaWiki ou sur la base de connaissances des codes devrait s'attendre à :

Retour / Critique / Revues de code

Les revues et commentaires faits par d'autres développeurs sur des point comme l'utilisation de la structure, la sécurité, l'efficacité et l'utilité.

Ajustement de la part de développeurs

D'autres développeurs modifiant votre soumission afin de l'améliorer ou faire du nettoyage dans votre code pour qu'il satisfasse aux nouvelles méthodes et classes de structure, aux conventions de codage et aux traductions.

Accès amélioré pour les admins système des wiki

Si vous décidez de mettre votre code sur le wiki, un autre développeur peut décider de le déplacer vers la base de connaissance de code MediaWiki pour une maintenance plus facile. Vous pouvez alors demander un accès commit pour continuer à le maintenir.

Versions futures faites par d'autres développeurs

De nouvelles branches de votre codes créées par d'autres développeurs en tant que nouvelles versions de MediaWiki peuvent être publiées. Avec l'intégration de votre code dans d'autres extensions qui ont un objectif identique ou similaire - incorporant les meilleurs fonctionnalités de chaque extension.

Crédit

Le crédit de votre travail sera préservé dans les versions futures - y compris les extensions intégrées dans d'autres.

De même vous devriez créditer les développeurs de toute extension où vous avez emprunté du code - particulièrement lorsque vous effectuez une intégration.

Tout développeur qui ne se sent pas à l'aide quant à l'une de ces actions ne devrait pas héberger son code directement sur le wiki MediaWiki ou dans la base de connaissance. Vous êtes malgré tout encouragé à créer une page de résumé pour votre extension sur le wiki afin de permettre aux gens de connaître l'extension et qu'ils sachent où la télécharger. Vous pouvez aussi ajouter le modèle Template:Tl sur votre extension afin de demander aux autres développeurs d'éviter de modifier votre code, bien qu'aucune garantie ne peut être donnée qu'une mise à jour ne soit pas faite si elle était nécessaire pour des raisons de sécurité et de compatibilité. Vous pouvez utiliser la page des problèmes courants si vous pensez qu'un autre développeur a violé l'esprit de ces application en éditant votre extension.