Manual:Variable/fr


 * Cette page concerne la création de variables. Pour l'aide à propos de l'utilisation des variables par défaut, voir . Pour les variables globales PHP utilisées en interne dans MediaWiki, voir .

Les Variables sont des morceaux de wikitexte qui ressemblent à des modèles mais n'ont pas de paramètres et ont reçu des valeurs codées en dur. Les balises wiki standard telles que  ou   sont des exemples de variables. Vous pouvez également étendre le balisage wiki en définissant vos propres variables personnalisées.

Le terme est quelque peu impropre parce qu'il n'y a rien de variable dans une variable. Les utilisateurs finaux ne peuvent pas modifier la valeur d'une variable car elle est prédéterminée par un ensemble de code PHP qui calcule sa valeur. Le terme "variables vient de la source de leur valeur: une variable PHP ou quelque chose qui pourrait être affecté à une variable, par ex. une chaîne, un nombre, une expression ou une valeur de retour de fonction.

Définir des variables personnalisées
Les variables sont un cas particulier de mots magiques donc notre première étape sera de définir la variable comme un mot magique:


 * 1) Choisissez un identifiant de mot magique pour votre variable. Il s'agit uniquement d'un identifiant interne qui est utilisé pour relier les différentes parties de la définition de la variable: les noms qui apparaissent dans le texte wiki et le code PHP qui attribue une valeur à la variable. Il est préférable de choisir un identifiant qui sera uniquement associé à votre extension et qui ne risque pas d'être confondu avec d'autres identifiants de mots magiques utilisés par d'autres extensions. Une stratégie courante consiste à utiliser quelque chose comme  où canonicalname est le nom sous lequel vous allez enregistrer votre extension (voir Registering custom variables  au dessous de).
 * 2) Définir les noms qui apparaîtront dans le texte wiki. Pour accomplir cela, vous devrez définir un tableau  dans un fichier. Voir  pour plus d'informations. Vos noms peuvent être sensibles à la casse et dépendants de la langue.
 * 3) Fournir du code PHP pour affecter une valeur à la variable. Pour ce faire, vous devrez définir et enregistrer une fonction hook avec.

Notez que la seule différence entre ce processus et le processus général de définition des mots magiques est la dernière étape: définir une fonction hook pour. Parser functions have a different method for associating an ID with PHP code. See for more information.

Enregistrer des variables personnalisées
Ceci est un processus en deux étapes :

To accomplish this we write and assign a hook to, the subject of this article.
 * 1) Define the variable so that it gets included in . This requires adding a member to  .  For more information, please see Registering features with MediaWiki.
 * 1) Declare the magic word ID as a variable.

Exemples
''Note: if you wish to use this example as a coding template, please replace  with something unique to your project so that there is less risk of name clashes with MediaWiki or any of its extensions. For example, if your extension was named  and you were reasonably sure that no-one else had an extension with constants, variables, functions, or classes beginning 'BEST_', 'wgBEST', 'wfBEST', or even 'BEST' you might want to replace 'My' with 'BEST'.''

Fichier

Fichier

Pour plus d’informations

 * - discusses default magic words built into the core MediaWiki package
 * - reviews the different kinds of magic words and how MediaWiki tells apart variables, parser functions, and templates.
 * Spécifications du langage Markup