MediaWiki API 帮助
这是一个自动生成的 MediaWiki API 文档页面。
文档和示例: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=options
( | options)
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块仅接受 POST 请求。
- 来源: MediaWiki
- 许可:
更改当前用户的首选项。
只有在核心或已安装的扩展中注册的选项,或者以userjs-为前缀的键的选项(供用户脚本使用)才能被设置。
特定参数
其他通用参数可用。
- reset
将偏好设置重置为网站默认值。
- 类型:布尔值(详情)
- resetkinds
当设置了 reset 选项时,要重置的选项类型列表。
- 值(用|或备用分隔):all, registered, registered-checkmatrix, registered-multiselect, special, unused, userjs
- 默认:all
- change
更改列表,格式为 name=value(例如 skin=vector)。如果未给出任何值(甚至没有等号),例如 optionname|otheroption|...,则该选项将被重置为其默认值。如果传递的任何值包含管道符 (|),请使用 备用的多值分隔符 以便正确操作。
- 用 | 或 其他方式分隔值。
- 最多值数量为 50(对于允许更高限制的客户端为 500)。
- optionname
应该设置为 optionvalue 值的选项的名称。
- optionvalue
由 optionname 指定的选项的值。当设置了 optionname 但省略了 optionvalue 时,该选项将被重置为其默认值。
- global
如果该选项是使用 GlobalPreferences 扩展全局设置的,该怎么做。
- ignore:什么都不做。该选项保留其先前的值。
- override:添加本地覆盖。
- update:全局更新该选项。
- create:全局设置该选项,覆盖任何本地值。
- 以下值之一:create, ignore, override, update
- 默认值:ignore
- token
从 action=query&meta=tokens 获取的 "csrf" token
- 此参数是必需的。
示例
- 重置所有偏好设置。
- 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