Aide de l’API MediaWiki
Ceci est une page d’aide de l’API de MediaWiki générée automatiquement.
Documentation et exemples : https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=options
- Ce module nécessite des droits de lecture.
- Ce module nécessite des droits d’écriture.
- Ce module accepte seulement les requêtes POST.
- Source : MediaWiki
- Licence : GPL-2.0-or-later
Modifier les préférences de l'utilisateur actuel.
Seules les options inscrites dans le noyau ou dans l’une des extensions installées, ou les options avec des clés préfixées par userjs- (conçues pour être utilisées dans les scripts utilisateur), peuvent être définies.
- reset
Réinitialise les préférences avec les valeurs par défaut du site.
- Type : booléen (détails)
- resetkinds
Liste des types d’options à réinitialiser quand l’option reset est définie.
- Valeurs (séparées par | ou autre) : all, registered, registered-checkmatrix, registered-multiselect, special, unused, userjs
- Par défaut : all
- change
Liste des modifications, au format « nom=valeur » (par ex. « skin=vector »). Si aucune valeur n’est fournie (pas même un signe égal), par ex., « nomoption|autreoption|… », l’option sera réinitialisée à sa valeur par défaut. Pour toute valeur passée contenant une barre verticale (|), utiliser le séparateur alternatif de valeur multiple pour que l’opération soit correcte.
- Valeurs séparées par | ou autre.
- Le nombre maximal de valeurs est 50 (ou 500 pour les clients ayant droit aux limites plus élevées).
- optionname
Nom de l’option qui doit être définie avec la valeur fournie par optionvalue.
- optionvalue
La valeur de l'option spécifiée par optionname. Si optionname est défini mais que optionvalue est absent, l'option sera réinitialisée à sa valeur par défaut.
- token
Un jeton « csrf » récupéré par action=query&meta=tokens
- Ce paramètre est obligatoire.
- Réinitialiser toutes les préférences.
- api.php?action=options&reset=&token=123ABC [ouvrir dans le bac à sable]
- Modifier les préférences skin et hideminor.
- api.php?action=options&change=skin=vector|hideminor=1&token=123ABC [ouvrir dans le bac à sable]
- Réinitialiser toutes les préférences, puis définir skin et nickname.
- api.php?action=options&reset=&change=skin=monobook&optionname=nickname&optionvalue=[[User:Beau|Beau]]%20([[User_talk:Beau|talk]])&token=123ABC [ouvrir dans le bac à sable]