Manual:Parameters to index.php/fr

Cette page est une liste partielle des paramètres de, le script principal du logiciel MediaWiki, tel que fourni par Mediawiki lui-même. La plupart de ces arguments sont habituellement passés dans l’URL en paramètres d’une requête avec la méthode, mais peuvent également être passés comme données de formulaire d’une requête avec la méthode. La méthode  est nécessaire actuellement dans certains cas, tels que l’action   pour actualiser la page rendue en cache sur le serveur. Certaines extensions fournissent des paramètres supplémentaires.

Révisions de page ou version
Les paramètres donnés à  s’appliquent habituellement et ont une signification liée à la page auxquels ils s’appliquent. La page (ou l’une de ses versions) peut être spécifiée en entrant un ou plusieurs des paramètres suivants : https:// en.wikipedia.org/w/index.php? title =Ferengi& curid =177126& diff =304901009& oldid =304764764

Certaines actions (comme  pour afficher une page ou   pour la modifier) agissent également sur une version particulière de la page. Une telle version est identifiée par les deux paramètres suivants, autorisant l’omission du titre et de l’identifiant de page.

Actions
Ce qui suit est une liste de valeurs du paramètre.

Certaines de ces actions peuvent être activées ou désactivées en utilisant un paramètre de configuration dédié dans. Ces paramètres locaux sont listés lorsqu’ils sont disponibles.

Écrasement des préférences de l’utilisateur
Les paramètres suivants écrasent certaines des préférences de l’utilisateur. Les autres paramètres expliqués dans les autres sections sont,   et. Les paramètres ci-dessous affectent toutes les actions sauf  et.

Affichage et rendu
Afficher est l’action par défaut. Si aucune autre action n’est ajoutée à l’URL,  est utilisé. Cette action affiche une page, une version ou la différence entre deux versions de la même page ou de deux pages différentes. Voici une liste (partielle) des paramètres supplémentaires possibles.


 * diff
 * La valeur de ce paramètre identifie une révision ; la différence entre une autre révision et celle-ci est retournée :


 * si  n’est pas passé, la différence entre cette révision et la précédente pour le même article est affichée ;
 * autrement, la différence entre la révision donnée par  et celle-ci est affichée ; la valeur de ce paramètre peut être un identifiant de révision, une des valeurs   ou   pour identifier une révision qui précède ou suit immédiatement celle indiquée par , ou bien la valeur   pour identifier la dernière révision de la page.
 * Notez que les paramètres  et   n’ont pas besoin d’indiquer deux versions du même article, ce qui permet de comparer deux versions de deux pages différentes.


 * redirect
 * Si la valeur de ce paramètre est  (non) et si la page indiquée est une redirection, la page de redirection elle-même est affichée et non pas la page cible de cette redirection ; ce paramètre ne produit un effet que pour les actions   ou   et seulement si aucun paramètre   ni   n’est passé, car c’est le seul cas où l’article cible est affiché à la place de la redirection.


 * rdfrom
 * Quand la page résulte d’avoir suivi une redirection depuis un wiki externe, ce paramètre indique de quel wiki il s’agissait, ce qui permet d’afficher la ligne « Redirigé depuis... ».


 * diffonly
 * Écraser les préférences de l’utilisateur pour savoir s’il faut effectuer le rendu de la page quand un « diff » est demandé, par exemple avec.


 * search
 * Si non vide (et si les recherches sont autorisées), cela écrase tous les autres paramètres et effectue une recherche.

Les paramètres suivants ne s’appliquent qu’aux catégories.


 * from
 * Si la page est une catégorie, afficher seulement les entrées dont la clé de tri égale ou suit la valeur donnée par ce paramètre.
 * Exemple : https://en.wikipedia.org/w/index.php?title=Special:Log&type=upload & from =20070814233520&until=20070814233625
 * Lien vers un journal de toutes les images téléversées le 14 août 2007 de 23:35:20 à 23:36:25.


 * until
 * Si la page est une catégorie, afficher seulement les entrées dont la clé de tri précède la valeur donnée par ce paramètre ; ce paramètre est utilisé uniquement si le paramètre  n’est pas passé.

Le paramètre suivant ne s’applique qu’aux images.


 * page
 * un numéro de page pour un média multipages ; actuellement, cela ne s’applique qu’aux fichiers DjVu et PDF ; la première page commence au numéro 1 (indépendamment de l’éventuelle numérotation interne des pages utilisée ou référencée au sein même du document).

Historique

 * limit
 * Le nombre de modifications de page à afficher, le maximum étant de 5 000 modifications.
 * Exemple : https://en.wikipedia.org/w/index.php?title=Special:Contributions &limit=13 &contribs=user&target=Atlgirl052005 - liste 13 modifications par page.


 * dir
 * L’ordre relatif des pages de l’historique des modifications.
 * Les modifications de page sont triées dans l’ordre décroissant de leur horodatage (de la plus récente à la plus ancienne).


 * offset
 * Utilise un horodatage pour spécifier quelle partie de l’historique est affichée ;
 * Retourne les modifications effectuées avant l’horodatage indiqué.
 * Exemple : https://en.wikipedia.org/w/index.php?title=Special:Contributions &offset=20090815195334 &contribs=user&target=Atlgirl052005
 * Affiche les modifications qui ont été effectuées immédiatement avant l’horodatage 20090815195334 (les éventuelles modifications qui ont été effectuées à l’horodatage 20090815195334 lui-même ou après ne sont pas affichées).
 * Le format du paramètre est aaaammjjhhmmss. Donc 20090815195334 a été créé le 15 août 2009 [20090815] à 19 h 53 m 34 [195334] (selon le calendrier grégorien dans le fuseau horaire du temps universel coordonné).
 * Voir Wikipédia:Guide complet du diff et des liens associés.
 * Si  est ajouté, cela fonctionne à l’envers, c’est-à-dire en listant toutes les modifications effectuées après l’horodatage indiqué.
 * Exemple : https://en.wikipedia.org/w/index.php?title=Special:Contributions&offset=20090815195334 &dir=prev &contribs=user&target=Atlgirl052005
 * Affiche les modifications qui ont été effectuées immédiatement après l’horodatage 20090815195334 (les éventuelles modifications qui ont été effectuées à l’horodatage 20090815195334 lui-même ou avant ne sont pas affichées).
 * Exemple pour afficher seulement la toute première modification d’une page : https://en.wikipedia.org/w/index.php?title=Wikipedia:Village_pump_(technical)&action=history& dir=prev &limit=1


 * feed
 * Un flux est retourné pour lister les modifications trouvées dans l’historique ; les valeurs autorisées sont  et  . Peut être désactivé avec.


 * go
 * (déprécié — ce paramètre doit être évité, car il a été remplacé)  affiche la première page de l’historique (montrant les modifications journalisées les plus anciennes).

Brut (raw)
Passer  retourne le code source d’une page ou d’une version. Pour des raisons de sécurité dans certaines versions de MediaWiki, ceci n’est autorisé qu’en utilisant le « point d’accès du script primaire », c’est-à-dire en utilisant la forme « affreuse » d’URL avec.


 * templates
 * Si passé avec la valeur  (développer), les modèles (ou appels de fonctions) inclus à l’intérieur de la page seront développés (de façon récursive le cas échéant).


 * ctype
 * La valeur du type de contenu à utiliser dans l’entête HTTP de la réponse contenant le contenu brut, au lieu de  par défaut ; il n’est possible d’utiliser qu’un des types autorisés, qui sont actuellement :   (valeur par défaut), ,   et.


 * maxage
 * La valeur de  à utiliser dans le champ d’entête HTTP   en retournant la page brute (afin de contrôler la durée maximale de conservation du contenu retourné dans le cache de l’agent client, avant que ce contenu en cache soit considéré comme expiré pour autoriser alors l’agent client à actualiser ce contenu en effectuant une nouvelle requête au serveur).


 * smaxage
 * La valeur de  dans le champ d’entête HTTP   à utiliser en retournant la page brute (afin de contrôler la durée maximale de conservation du contenu retourné dans le cache du serveur, avant que ce contenu en cache soit considéré comme expiré pour autoriser alors le serveur à le demander ou le générer à nouveau depuis sa base de données et ses règles actuelles dans leur configuration la plus récente).


 * oldid
 * L’identifiant d’une version spécifique à retourner :


 * direction
 * peut prendre une des valeurs,  , ou bien   : au lieu de la version indiquée par le paramètre  , renvoie respectivement la version qui la suit, celle qui la précède, ou bien la version actuelle (la dernière version en date non masquée).

Une liste des sections et des sous-sections de la page peut être obtenue (au format JSON par défaut) au moyen du point d’entrée de l’API avancée de MediaWiki en utilisant l’action  avec le paramètre , aussi bien sur une page complète indiquée simplement par son titre dans le paramètre  , qu’en demandant d’analyser du wikicode indiqué dans le paramètre   pour effectuer une transclusion de la page complète et y ajouter un sommaire, par exemple api.php?action=parse&text={{:My_page}}&#95;&#95;TOC&#95;&#95;&prop=sections.
 * section
 * Limite la sortie à une section ou une sous-section particulière du document. Les sections sont spécifiées par des entiers non négatifs : la section 0 est la section précédant toute section nommée, la section un est la première section ou sous-section nommée, etc. Le schéma de numérotation prend en compte les sections et les sous-sections de la même façon.


 * Exemple de requête du wikicode (brut) d’une section d’un article de Wikipédia.

Modifier et soumettre
Les actions de modification et de soumission réalisent presque la même action. Par défaut, elles retournent un formulaire de « modification de page » pour la page concernée. Différents résultats peuvent être obtenus en passant d’autres arguments ; certains résultats (comme l’enregistrement de la nouvelle version d’une page) ne peuvent être obtenus qu’en utilisant la méthode. Cette action utilise les paramètres standards pour spécifier une page par son titre ou son identifiant de page, ou bien spécifier une version historisée d’une page par son identifiant de version.

Options qui affectent le formulaire de modification
Les options suivantes produisent un effet sur le formulaire de modification. (Note : le paramètre « section » affecte également la façon dont la page est enregistrée. De plus, les paramètres « preload » et « preloadparams » ne fonctionnent qu’avec le modèle de contenu wikicode).


 * section
 * Spécifie l’index d’une section au sein d’un document à précharger et à modifier ; les sections sont numérotées séquentiellement à partir de zéro ; la section 0 est la partie initiale de l’article située avant l’entête de la première section ; la valeur  est utilisée pour ajouter une nouvelle section au document.


 * preload
 * spécifie une page, dont le texte wiki est utilisé comme valeur initiale de la zone de saisie et de modification du contenu dans le formulaire de modification, si la page ou la section à modifier n’existe pas encore ; si elle existe, la commande de préchargement est ignorée ; voir aussi.
 * Exemple : https://en.wikipedia.org/wiki/Talk:Main_Page?action=edit&section=new&preload=Project:Sandbox


 * preloadparams[] (ou preloadparams%5B%5D) : Permet de remplacer les paramètres de style  dans le texte préchargé. Par exemple, https://mediawiki.org/wiki/Project:Sandbox?action=edit&section=new&preload=Manual:Creating_pages_with_preloaded_text/param_demo&preloadparams%5b%5d=first%20value&preloadparams%5b%5d=second%20value entraînerait le préchargement de Manuel:Création de pages avec un texte préchargé/démonstration des paramètres dans le formulaire de modification, mais avec   remplacé par la « première valeur » et   remplacé par la « seconde valeur ».
 * editintro
 * Titre d’un article ou d’un modèle existant dont le rendu sera affiché au-dessus du formulaire de modification.

https://en.wikipedia.org/w/index.php?title=User_talk:5dsddddd&action=edit&section=new&preloadtitle=The+%5B%5BWP%3AARS%7CArticle+Rescue+Squadron%5D%5D https://en.wikipedia.org/wiki/User_Talk:Ikip?action=edit&section=new&preload=Template:Article_Rescue_Squadron_ invite&preloadtitle=Invitation
 * preloadtitle
 * Dans le cas de, cela fournit le contenu initial du champ de saisie du « Sujet / titre » ; il peut être modifié avant l’enregistrement de la section à ajouter.
 * Exemple de lien pour ajouter une nouvelle section dans une page de discussion, en préchargeant le titre de la section (avec )  :
 * Exemple de lien pour ajouter une nouvelle section dans une page de discussion, en préchargeant à la fois le titre de la section (avec ) et son contenu (avec   indiquant le nom d’un modèle à inclure) :


 * nosummary
 * Ne pas afficher le champ de saisie ou de modification du « Sujet / titre » lors de l’ajout d’une nouvelle section avec.


 * summary
 * Sa valeur est utilisée pour renseigner le résumé initial des modifications à la place de celui qui serait généré en cas de résumé vide lors de l’enregistrement.


 * preview
 * Si mis à  (oui) ou à   (non), écrase la préférence définie par l’utilisateur «  ».


 * internaledit/externaledit : Écrase les préférences de l’utilisateur pour les éditeurs externes.
 * mode
 * Ce paramètre affecte la page de résultat s’il est passé avec la valeur  et en utilisant un éditeur externe.


 * undo, undoafter
 * Ces paramètres indiquent de tenter d’annuler une séquence de modifications, depuis la révision  jusqu’à la révision   ; techniquement, ceci est réalisé en essayant de fusionner l’inverse de ces modifications depuis la séquence de toutes les modifications subséquentes ; les valeurs de ces paramètres sont des identifiants d’anciennes versions d’une même page ; si la fusion complète n’est pas possible, un formulaire normal de modification est renvoyé pour la première des plus récentes révisions fusionnables qui peuvent être annulées.

Que faire ?
Les options suivantes indiquent au logiciel quoi faire dans les cas suivants : enregistrement, affichage d’un aperçu ou des différences avec la version actuelle.


 * wpSave
 * Cet argument est généré lors de l’enregistrement du contenu d’un formulaire de modification retourné par le serveur, mais il n’est en fait ni utilisé, ni nécessaire lors de la soumission (voir ci-dessous pour les arguments nécessaires à l’enregistrement).


 * wpPreview
 * Défini dans une requête utilisant la méthode  pour demander un aperçu de la page ou de la section comme si la valeur du champ   avait été enregistrée.


 * Par défaut, retourne un formulaire de modification avec un aperçu de la valeur du champ.
 * si l'argument supplémentaire  est passé, seulement le rendu de la valeur de wpTextbox1 sera affiché, pas le formulaire ni les autres éléments d'IHM; ceci est similaire au résultat de l'enregistrement puis de l'affichage avec  ; voir  Manual:Live preview pour davantage d'informations;
 * l'argument  est identique à wpPreview; c'est pourquoi, un aperçu régulier est retourné si   n'est pas fourni;
 * wpDiff
 * fixé dans une requête POST pour demander une table affichant les modifications entre la version courante de la page ou de la section, et la version obtenue si le contenu de wpTextbox1 avait été enregistré;

Paramètres à enregistrer obligatoirement
Les paramètres suivants sont nécessaires quand un utilisateur enregistre une page. Le champ de résumé des modifications peut être aussi nécessaire s'il est configuré ainsi (voir ci-dessous).


 * wpTextbox1
 * le contenu de la nouvelle page/section;


 * wpStarttime
 * l'horodatage associé au début de la modification de la page par l'utilisateur; utilisé pour vérifier si la page a été supprimée entre ce moment et celui où elle est soumise (dans ce cas, il est demandé à l'utilisateur de confirmer l'enregistrement);


 * wpRecreate
 * dans le cas où la page a été supprimée après wpStarttime, ce champ confirme que la page doit être enregistrée;


 * wpEdittime
 * pour les nouvelles pages, il vaut wpStarttime; sinon, il correspond à l'horodatage de la dernière révision de la page; utilisé pour vérifier les conflits d'édition;


 * wpEditToken
 * un jeton de modification; ceci est utilisé pour éviter que les utilisateurs ne soient pas amenés à enregistrer une page en suivant un lien ou en pressant un bouton sur un site externe. Pour les utilisateurs qui ne sont pas connectés, wpEditToken est nécessaire depuis rSVN18112; actuellement il contient uniquement les caractères  plutôt qu'une chaîne aléatoire (voir modifier le suffixe du jeton).

Pour la page qui va être enregistrée,,  ,   et   sont nécessaires dans une requête POST, mais ni   ni   ne sont fournis. Si la page a été supprimée après, le booléen d'option   est aussi nécessaire.

Données supplémentaires optionnelles
Le résumé des modifications, ou le paramètre « ignorer les vides » peuvent être obligatoires si « avertir des résumés vides » est configuré.


 * wpSummary
 * le résumé des modifications;


 * wpMinoredit
 * si positionné lors d'une demande d'enregistrement, cette modification est marquée comme mineure; pour un aperçu ou un diff, il s'agit de la valeur initiale de la coche "ceci est une modification mineure" du formulaire de modification;


 * wpWatchthis
 * si passé lors d'une demande d'enregistrement, la page est ajoutée à la liste de suivi de l'utilisateur; si non passé dans une demande d'enregistrement, la page est supprimée de la liste de suivi de l'utilisateur; pour l'apperçu ou le diff, il s'agit de la valeur initiale de l'option cochée « suivre cette page » du formulaire de modification;


 * wpSection
 * spécifier l'index d'une section de document à soumettre; les sections sont numérotées séquentiellement à partir de 0; la section 0 est la partie de l'article avant le titre de la première section; la valeur  est utilisée pour ajouter une nouvelle section au document;


 * wpChangeTags
 * une liste optionnelle de balises séparées par des virgules, à ajouter à la modification. Si certaines des balises fournies ne sont pas activées pour l'utilisation manuelle, la modification sera rejetée.


 * wpAutoSummary
 * contient le code de hachage MD5 du champ résumé de la modification tel qu'il a été initialement présenté à l'utilisateur dans le formulaire de modification; ce champ est utilisé pour vérifier si l'utilisateur a modifié ce champ avant de soumettre: si le code de hachage MD5 de la valeur de  est le même que ce champs, le résumé de la modification n'a pas été mis à jour;


 * wpIgnoreBlankSummary
 * enregistrer la page même si l'utilisateur n'a pas mis à jour le résumé de la modification, alors qu'il était supposé le faire;


 * wpTextbox2
 * en cas de conflit d'édition, il contient la valeur du champ wpTextbox1 de la demande d'enregistrement qui a généré le conflit;


 * safemode
 * certains navigateurs sont connus pour avoir des problèmes quand on modifie du texte contenant des caractères Unicode; quand une requête de formulaire de modification arrive de l'un de ces navigateurs, les caractères non-ascii du contenu initial de la zone de texte sont convertis sour la forme  et la valeur   est cachée dans le formulaire; lors de la soumission, le champ   indique que la traduction inverse doit être réalisée; un navigateur est considéré non compatible Unicode si l'entête HTTP de l'agent client vérifie les expressions régulières de la variable ;


 * wpScrolltop
 * utilisé pour conserver la position de la barre de défilement dans la boîte de dialogue de la modification lors du chargement d'un aperçu.


 * redlink
 * si l'utilisateur n'est pas autorisé de modifier la page, rediriger vers la page de l'article vide (par exemple, "Wikipedia n'a pas trouvé d'article correspondant exactement à ce nom") au lieu d'afficher l'avertissement concernant l'erreur de droits; ce paramètre est utilisé sur les liens rouges.


 * wpExtraQueryRedirect
 * entrée masquée à modifier après l'enregistrement de l'URL et non utilisée par le fomulaire de modification courant. Sensé être utilisé par les gadgets et équivalents.

Pages spéciales
La plupart des pages spéciales ont des paramètres supplémentaires, spécifiques à la fonction qu’elles mettent en œuvre. Comme exemple, les paramètres pour Spécial:Exporter des pages sont listés dans la page  du manuel de MediaWiki.

Les paramètres d’URL suivants permettent de fournir des valeurs initiales pour certains champs d’entrée ; ils peuvent être modifiés par l’utilisateur avant de soumettre le formulaire.

Special:MovePage

 * wpReason
 * champ de texte pour préciser un motif.


 * wpNewTitle
 * champ de texte pour préciser le nouveau titre.


 * wpLeaveRedirect
 * s’il faut sélectionner la case à cocher « Laisser une redirection en arrière-plan ».

Special:BlockIP

 * wpDisableEmail
 * s’il faut sélectionner la case à cocher «  ».


 * wpDisableUTEdit
 * s’il faut sélectionner la case à cocher «  ».


 * wpReason
 * élément sélectionné initialement dans la boîte déroulante, la valeur doit correspondre à une rangée de la table MediaWiki:Ipbreason-dropdown.


 * wpReason-other
 * champ de texte libre pour préciser un motif personnalisé ; nécessite.


 * wpAutoBlock
 * s’il faut sélectionner la case à cocher «  ».


 * wpWatch
 * s’il faut sélectionner la case à cocher «  ».

Special:UserRights

 * user-reason
 * champ de texte libre pour préciser un motif.

Paramètre
Le  est utilisé seulement si le logiciel s’exécute sur une grappe répliquée de la base de données.

Le paramètre  fait en sorte qu’une requête ne soit pas honorée lorsque le trafic sur le serveur est trop important. Le paramètre  s’applique à toutes les actions. La valeur du paramètre  est un nombre ; plus faible est cette valeur, plus faible sera le trafic minimum ayant pour effet de ne pas honorer la requête. Une valeur négative ou nulle n’est pas autorisée.