模板:AdvancedSiteNotices/doc

此页面是Template:AdvancedSiteNotices的模板文档。
此页面可能包含了模板的使用说明、分类和其他内容。

用法

添加通告时，请将通告填写在源代码内的{{AdvancedSiteNotices/core}}模板内。假如修改前的源代码为：

{{AdvancedSiteNotices/core|
  {{AdvancedSiteNotices/item|-{zh-cn:欢迎来到维基百科; zh-tw:歡迎來到維基百科;}-}}
}}

修改后的源代码将类似于下面的代码：

{{AdvancedSiteNotices/core|
  {{AdvancedSiteNotices/item|-{zh-cn:欢迎来到维基百科; zh-tw:歡迎來到維基百科;}-}}
  {{AdvancedSiteNotices/item|你好，世界}}
}}

{{AdvancedSiteNotices/item}}的参数

{{AdvancedSiteNotices/item}}有两个匿名参数和一个命名参数：{{{1}}}为必填参数，填写通告的实际内容；{{{2}}}和{{{criteria}}}为选填参数，可以定义通告面向的人群：

{{AdvancedSiteNotices/item|{{{1}}}|{{{2}}}|criteria={{{criteria}}}}}

参数{{{criteria}}}应为有效的JavaScript表达式。须注意，由于安全原因，表达式中只支持以下语法：

字符串（仅支持 '、" 包裹，支持转义字符 \n、\t、\r、\b、\f、\x、\u）；
布尔值；
逻辑运算符&&和||；
一元运算符!；
用括号包裹表达式（如(a && b) || c）；
函数调用（仅支持func(arg1, arg2)的形式，仅支持调用下方列明的函数）。

需传值的函数：
- in_country - 测试用户所在国家或地区，只要匹配其中一个传入值就会返回 true
- in_region - 测试用户所在主要行政区，只要匹配其中一个传入值就会返回 true
- in_city - 测试用户所在城市，只要匹配其中一个传入值就会返回 true
- in_group - 测试用户所在用户组，只要匹配其中一个传入值就会返回 true
- in_group_every - 测试用户所在用户组，只有用户拥有所有用户组时才返回 true
- in_lang - 测试用户使用语言，只要匹配其中一个传入值就会返回 true
无需传值的函数：
- is_anon - 测试用户是不是匿名用户
- is_temp - 测试用户是不是临时账户
- is_named - 测试用户是不是注册用户

当没有填写时，将使用参数{{{2}}}。

参数{{{2}}}有多种模式，各种模式可以混用，并以空格分隔：

only_sysop - 只对管理员显示
only_logged（已弃用）、only_logged_in、is_named - 只对注册用户显示
only_anon（已弃用）、only_logged_out - 只对退出用户显示，请注意临时账号算是退出用户
is_temp - 只对临时账号显示
is_anon - 只对匿名用户显示，请注意临时账号不算是匿名用户
only_zh_cn - 只对大陆用户显示
only_zh_hk - 只对香港和澳门用户显示
only_zh_sg - 只对新加坡和马来西亚用户显示
only_zh_tw - 只对台湾用户显示

实际用例：

{{AdvancedSiteNotices/item|[[Wikipedia:聚会/2010年台湾秋聚|'''2010年台湾维基人秋聚''']]与[[Wikipedia_talk:聚会/2010上海夏聚|'''2010年上海维基人夏聚''']]圆满落幕。|criteria=in_country('TW') {{!!}} in_country('CN') && in_city('Shanghai')}}
{{AdvancedSiteNotices/item|这条消息只有位于对应用户组的用户才能看见|criteria=in_group('rollbacker', 'patroller, 'sysop', 'autoreviewer')}}
{{AdvancedSiteNotices/item|這條消息在東八區跨到2025年後不顯示，不過由於快取問題實際上可能要一小時才會不再顯示|criteria={{#ifexpr:{{#time:YmdHi}}>202501010800|false|true}}}}

注意事项

如在公告包含其他模板，而该模板的内容会在不用编辑的情况下自动更新（如倒数），您可能需要清除ajax页面的缓存，内容才会更新。要清除缓存，请点击此处。
如需查询目前公告的显示性质，请至Template:AdvancedSiteNotices/viewer。
本页面目前被全保护——需要在公告中加入内容的用户请到Template_talk:AdvancedSiteNotices提出请求，由管理员代为加入。

参见