Template:AdvancedSiteNotices/doc

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

用法

添加通告时，请将通告填写在源代码内的{{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)的形式，仅支持调用下方列明的函数）。

標記 [x] 的函數尚不存在。in_group [!] 尚只能接受一個參數。

需傳值的函數：
- in_country - 测试用户所在国家或地区，只要匹配其中一個傳入值就會返回 true
- in_region - 测试用户所在主要行政区，只要匹配其中一個傳入值就會返回 true
- in_city - 测试用户所在城市，只要匹配其中一個傳入值就會返回 true
- in_group [!] - 测试用户所在用户组，只要匹配其中一個傳入值就會返回 true
- in_group_every [x] - 测试用户所在用户组，只有用戶擁有所有用戶組時才返回 true
- in_lang [x] - 测试用户使用語言，只要匹配其中一個傳入值就會返回 true
無需傳值的函數：
- is_anon - 测试用户是不是匿名用戶
- is_temp - 测试用户是不是臨時帳戶
- is_named - 测试用户是不是註冊用户

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

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

標記 [x] 的模式尚不存在。

only_sysop - 只对管理员显示
only_logged（已棄用）、only_logged_in、is_named - 只对註冊用户显示
only_anon（已棄用）、only_logged_out [x] - 只对登出用户显示，請注意臨時帳號算是登出用戶
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')}}

注意事項

如在公告包含其他模板，而該模板的內容會在不用編輯的情況下自動更新（如倒數），您可能需要清除ajax頁面的緩存，內容才會更新。要清除緩存，請點選此處。
如需查詢目前公告的顯示性質，請至Template:AdvancedSiteNotices/viewer。
本頁面目前被全保護——需要在公告中加入內容的用戶請到Template_talk:AdvancedSiteNotices提出請求，由管理員代為加入。

參見