MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=options
(main | options)
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
- 來源:MediaWiki
- 授權條款:GPL-2.0-or-later
更改目前使用者的偏好設定。
僅有註冊在核心或是已安裝擴充功能之一、或是帶有 userjs-
前綴的鍵之選項(由使用者手稿所使用)可被設定。
參數:
- reset
重設偏好設定為網站預設值。
- 類型:布林值(詳細資訊)
- resetkinds
當設定 reset 選項時,要重設的選項類型清單。
- 多值 (以 | 或 alternative 分隔):all、registered、registered-checkmatrix、registered-multiselect、special、unused、userjs
- 預設值:all
- change
更改清單,格式化為「名稱 = 值」(例如:skin=vector)。如果未提供值(甚至沒有等號),像是:optionname|otheroption|...,那麼選項將會重新設定成預設值。如果傳遞的任何值包含豎線字元(|),請使用替代多值分隔符號以便正確操作。
- 將幾個值以 | 或 alternative 分隔。
- 值的最大數目為 50(用於客戶端允許的較高限制為 500)。
- optionname
選項名稱,其應設定為由 optionvalue 所提供的值。
- optionvalue
由 optionname 所指定,用於選項的值。
- token
自 action=query&meta=tokens 接收的「csrf」權杖。
- 此為必填參數。
範例:
- 重設所有偏好設定
- api.php?action=options&reset=&token=123ABC [在沙盒中開啟]
- 更改skin和hideminor偏好設定。
- api.php?action=options&change=skin=vector|hideminor=1&token=123ABC [在沙盒中開啟]
- 重置所有偏好設定,然後再設定 skin 與 nickname。
- api.php?action=options&reset=&change=skin=monobook&optionname=nickname&optionvalue=[[User:Beau|Beau]]%20([[User_talk:Beau|talk]])&token=123ABC [在沙盒中開啟]