Projet Phabricator : [[phab:tag/mediawiki-extensions-{{{bugzilla}}}/|#MediaWiki-extensions-{{{bugzilla}}}]]

Modèle:Extension

From MediaWiki.org
Jump to: navigation, search
This page is a translated version of the page Template:Extension and the translation is 81% complete.

Outdated translations are marked like this.
Other languages:
العربية • ‎български • ‎বাংলা • ‎کوردی • ‎Deutsch • ‎Ελληνικά • ‎English • ‎español • ‎فارسی • ‎français • ‎galego • ‎magyar • ‎Հայերեն • ‎italiano • ‎日本語 • ‎한국어 • ‎한국어 (조선) • ‎македонски • ‎मराठी • ‎Nederlands • ‎polski • ‎português • ‎português do Brasil • ‎русский • ‎Scots • ‎Türkçe • ‎українська • ‎Tiếng Việt • ‎粵語 • ‎中文
Manuel des extensions MediaWikiManual:Extensions
Crystal Clear action run.png
Extension

État de la version :Extension status inconnu

LicenceTemplate:Extension#license Aucune licence spécifiée
Téléchargement Aucun lien

Traduisez l’extension Extension sur translatewiki.net

Documentation icon Documentation du modèle[view] [modifier] [history] [purger]

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 MediaWikiManual:Extensions
Crystal Clear action run.png
{{{name}}}

État de la version :Extension status inconnu

Placeholder.png
ImplémentationTemplate:Extension#type {{{type1}}}, {{{type2}}}
DescriptionTemplate:Extension#description {{{description}}}
Auteur(s)Template:Extension#username Un auteur (SomeUsertalk)
Dernière versionTemplate:Extension#version {{{version}}} ({{{update}}})
Dernière version de développementTemplate:Extension#version {{{version preview}}} ({{{update preview}}})
MediaWikiTemplate:Extension#mediawiki {{{mediawiki}}}
PHPTemplate:Extension#php {{{php}}}
Changements de la base de donnéesTemplate:Extension#needs-updatephp {{{needs-updatephp}}}
ComposerComposer {{{composer}}}
LicenceTemplate:Extension#license {{{license}}}
Téléchargement {{{download}}}
{{{readme}}}
{{{changelog}}}
ExempleTemplate:Extension#example {{{example}}}
Espace de nomTemplate:Extension#namespace

{{{namespace}}}

ParamètresTemplate:Extension#parameters

{{{parameters}}}

BalisesTemplate:Extension#tags
{{{tags}}}
Droits ajoutésTemplate:Extension#rights

{{{rights}}}

Accroches utiliséesTemplate:Extension#hook
hook1Manual:Hooks/hook1
hook2Manual:Hooks/hook2

{{{compatibility}}}

Traduisez l’extension Extension sur translatewiki.net

ProblèmesPhabricator

[[phab:tag/mediawiki-extensions-{{{bugzilla}}}|Tâches ouvertes]] · Signalez un 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.

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 parseur{{{2}}} non catégorisées. Si vous avez écrit une extension parseur, veuillez SVP utiliser l'un des types suivants plus précis :
  • 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 $wgMediaHandlers{{{2}}}
    • 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 page{{{2}}}. 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 SpecialPage{{{2}}}, 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éciales{{{2}}} 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 taxonomy{{{2}}} 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.

Beaucoup d'extensions ont plus d'un type. Si ce cas s'applique pour vous, remplacez |type= par |type1=|type2=|type3=.... Vous pouvez définir jusqu'à six types pour une extension.
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:Hooks{{{2}}} 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 registry{{{2}}}.

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
$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ées{{{2}}}.
license licence licence(s) utilisée(s) pour cette extension, par ex. GPL
download téléchargement lien pour le téléchargement : SVN, {{WikimediaDownload}} 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 makebot{{{2}}} ou desysop{{{2}}}, 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.



Pour la version française :

Veuillez remplacer "MyExtension" avec le nom de l'extension (suivi de /fr pour la version française) :


MediaWiki est un projet open-source et les utilisateurs sont encouragés à faire leurs extensions MediaWiki{{{2}}} 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éveloppeur{{{2}}} 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 {{Extension exception}} 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.

Maintenance: vulnerabilities, archived