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. Les fonctions d'analyseur ont une méthode différente pour associer un ID au code PHP. Voir pour plus d'informations.

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


 * 1) 'Définit la variable pour qu’elle soit incluse dans le code>Special:Version/code>. Cela nécessite d’ajouter un membre à .  Pour plus d’informations, veuillez consulter 'Registering features with MediaWiki'.
 * 2) 'Déclare le mot magique ID comme variable. ' Pour accomplir ceci nous écrivons et attribuons un crochet à, le sujet de cet article.

Exemples
''Remarque : si vous souhaitez utiliser cet exemple comme modèle de codage, veuillez remplacer le  par quelque chose d’unique à votre projet afin qu’il y ait moins de risques de conflits de noms avec MediaWiki ou ses extensions. Par exemple, si votre extension a été nommée  et que vous étiez raisonnablement sûr que personne d’autre n’avait une extension avec des constantes, des variables, des fonctions ou des classes commençant par 'BEST_', 'wgBEST', 'wfBEST', ou même 'BEST' vous pourriez vouloir remplacer 'My' par 'BEST'.''

Fichier

Fichier

Pour plus d’informations

 * - discute des mots magiques par défaut intégrés dans le paquet principal MediaWiki
 * - examine les différents types de mots magiques et comment MediaWiki différencie les variables, les fonctions d’analyse et les modèles.
 * Spécifications du langage Markup