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=globalpreferences

(main | globalpreferences)
  • 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 : GlobalPreferences
  • Licence : GPL-2.0-or-later

Modifier les préférences globales de l’utilisateur actuel.

Seules les préférences enregistrées pour le wiki actuel peuvent être modifiées localement.

Paramètres :
D'autres paramètres généraux sont disponibles.
reset

Réinitialiser les préférences globales. Supprime tout ou, selon la valeur du paramètre resetkinds, certains types de préférences globales, supprimant ainsi leur caractère global.

Type : booléen (détails)
resetkinds

Liste de types de préférences à réinitialiser quand l’option reset est positionnée.

Valeurs (séparées par | ou autre) : all, registered, registered-checkmatrix, registered-multiselect, special, unused, userjs
Par défaut : all
change

Liste de modifications, au format « nom=valeur » (par ex. « skin=vector »). Si aucune valeur n’est données (pas même un signe égal), par ex. « nompreference|autrepreference|... », la préférence sera rendue non globale. Si une valeur passée doit contenir le caractère barre verticale (|), utilisez le séparateur alternatif des valeurs multiples 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

Le nom de la préférence qui doit être mise à la valeur donnée par optionvalue.

optionvalue

La valeur de la préférence spécifiée par optionname.

token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.
Exemples :
Rendre non globale une unique préférence.
api.php?action=globalpreferences&change=skin=&token=123ABC [ouvrir dans le bac à sable]
Rendre non globales toutes les préférences.
api.php?action=globalpreferences&reset=&token=123ABC [ouvrir dans le bac à sable]
Modifier les préférences skin (habillage) et hideminor (masquer les éléments mineurs).
api.php?action=globalpreferences&change=skin=vector|hideminor=1&token=123ABC [ouvrir dans le bac à sable]