模板: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提出請求，由管理員代為加入。

參見