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 paramètres sont habituellement passés dans l’URL d’une requête HTTP(S) utilisant la méthode standard, mais peuvent également être passés comme données de formulaire d’une requête HTTP(S) utilisant la méthode standard. La méthode standard  est en fait nécessaire dans certains cas, tels que l’action   pour actualiser le rendu de la page conservé dans le cache sur le serveur. Certaines extensions fournissent des paramètres supplémentaires.



Révision de page ou version
Les paramètres donnés à  habituellement s’appliquent et ont une signification liée à la page à laquelle 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. D'autres paramètres expliqués dans d'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  renvoie le code source d’une page ou d’une version. Pour des raisons de gestion du cache et de sécurité, ceci ne doit être généralement utilisé qu'uniquement via le chemin du script, c'est à dire, ]]. While "short urls" like  are only meant for action=view, they unofficially tend to work for other actions as well. This is expressly discouraged for action=raw as it leads to less effective caching and bypasses automatic purging after edits.


 * 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 le paramètre supplémentaire  est passé, seul le rendu de la valeur du champ wpTextbox1 sera affiché, pas le formulaire de modification, ni aucun des autres éléments d’interface utilisateur ou des styles personnalisés habituellement insérés au sein des pages visualisées ; ce rendu est similaire à celui qui résulterait de l’enregistrement des modifications puis de l’affichage avec   ; voir  pour davantage d’informations.
 * Le paramètre  est identique à   ; c’est pourquoi un aperçu normal est retourné si le paramètre   n’est pas fourni.
 * wpDiff
 * Ce paramètre est défini dans une requête utilisant la méthode  pour demander une table montrant les modifications entre la version actuelle de la page ou de la section et la version obtenue si le contenu du champ   avait été enregistré.



Paramètres nécessaires pour l’enregistrement
Les paramètres suivants doivent être renseignés et sont nécessaires si un utilisateur veut enregistrer une page. Une valeur dans le champ de résumé des modifications peut aussi être nécessaire s’il a été configuré ainsi (voir ci-dessous).


 * wpTextbox1
 * Le contenu de la nouvelle page ou 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-là et celui où les modifications sont soumises pour l’enregistrement ou pour une prévisualisation (dans ce cas, il est demandé à l’utilisateur de confirmer l’enregistrement).


 * wpRecreate
 * Au cas où la page aurait été supprimée après l’horodatage indiqué dans, ce champ confirme que la page doit être enregistrée.


 * wpEdittime
 * Pour les nouvelles pages, il vaut la même chose que  ; sinon, il correspond à l’horodatage de la dernière révision enregistrée de la page ; utilisé pour vérifier les conflits d’édition.


 * wpEditToken
 * Un jeton de modification ; celui-ci est utilisé pour éviter que les utilisateurs ne soient pas amenés à enregistrer une page en suivant un lien ou en pressant un bouton depuis un site externe. Pour les utilisateurs qui ne sont pas connectés,  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 qu’une page puisse être enregistrée,,  ,   et   sont nécessaires dans une requête utilisant la méthode  , mais ni  , ni   ne sont passés. Si la page a été supprimée après, l’option booléenne   est également nécessaire afin de pouvoir la recréer.



Données supplémentaires facultatives
Le résumé des modifications ou le paramètre « ignorer les vides » peuvent être obligatoires si l’option « avertir en cas de résumés vides » est configurée.


 * wpSummary
 * Le résumé des modifications.


 * wpMinoredit
 * Si ce paramètre est positionné lors d’une requête d’enregistrement, cette modification sera marquée comme mineure. Pour l’affichage d’un aperçu ou d’un « diff », il s’agit de l’état de la case à cocher « ceci est une modification mineure », telle qu’elle figurait dans le formulaire de modification qui a été soumis.


 * wpWatchthis
 * Si ce paramètre est passé lors d’une requête d’enregistrement, la page sera ajoutée à la liste de suivi de l’utilisateur ; s’il n’est pas passé dans cette requête, la page sera supprimée de la liste de suivi de l’utilisateur. Lors de l’affichage d’un aperçu ou d’un « diff », il indique l’état de la case à cocher « suivre cette page », telle qu’elle figurait dans le formulaire de modification qui a été soumis.


 * wpSection
 * Spécifie l’index d’une section au sein du document à soumettre ; les sections sont numérotées séquentiellement à partir de 0 ; la section 0 est la partie initiale de l’article figurant avant le titre de la première section ; la valeur  est utilisée pour ajouter une nouvelle section au document.


 * wpChangeTags
 * Une liste facultative 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 l’empreinte de hachage MD5 du champ de résumé des modifications, tel qu’il a été initialement présenté à l’utilisateur dans le formulaire de modification ; ce champ normalement non modifiable et invisible dans le formulaire est utilisé pour vérifier si l’utilisateur a bien modifié ce champ avant de soumettre le formulaire pour l’enregistrement ou la publication : si la valeur de ce paramètre est identique à l’empreinte de hachage MD5 calculée sur la valeur donnée dans le champ  du formulaire soumis, cela signifie que le résumé des modifications n’a pas été modifié par l’utilisateur.


 * wpIgnoreBlankSummary
 * Enregistrer la page même si l’utilisateur n’a pas modifié le résumé des modifications, alors qu’il était supposé le faire.


 * wpTextbox2
 * En cas de conflit engendré par des modifications concourantes, ce champ contient une copie de la valeur du champ de saisie  tel qu’il était présent dans la requête d’enregistrement, avant la détection et le signalement par le serveur de ce conflit.


 * wpScrolltop
 * Ce paramètre caché est utilisé pour conserver la position de la barre de défilement dans la boîte de dialogue de modification lors du chargement d’un aperçu de prévisualisation.


 * redlink
 * Si l’utilisateur n’est pas autorisé à modifier la page, rediriger vers la page de l’article vide (par exemple, « Wikipédia n’a trouvé aucun article correspondant exactement à ce nom ») au lieu d’afficher l’avertissement concernant l’erreur de droit d’accès ; ce paramètre est utilisé sur les liens rouges.


 * wpExtraQueryRedirect
 * Entrée masquée à modifier après l’URL d’enregistrement, mais qui n’est pas utilisée par le formulaire de modification effectif. Initialement destiné à être utilisé par des gadgets ou équivalents pour conserver et retrouver leur état lorsque la page web doit être rechargée ou actualisée (sans obligation pour ces gadgets de disposer d’un accès à du stockage accessible dans le navigateur client).



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 Special:Export 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.