MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/API
action=options
(main | options)
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
- 來源:MediaWiki
- 協定:GPL-2.0-or-later
更改目前使用者的偏好設定。
只有注册在核心或者已安装扩展中的选项,或者具有userjs-
键值前缀(旨在被用户脚本使用)的选项可被设置。
參數:
- reset
重設偏好設定為網站預設值。
- 類型:布林值(詳細資訊)
- resetkinds
當設定 reset 選項時,要重設的選項類型清單。
- 多值 (以 | 或 alternative 分隔):registered、registered-multiselect、registered-checkmatrix、userjs、special、unused、all
- 預設值:all
- change
更改列表,以name=value格式化(例如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 [在沙盒中開啟]