编辑“︁Template:AdvancedSiteNotices/doc”︁（章节）

== 用法 ==
添加通告时，请将通告填写在源代码内的{{tl|AdvancedSiteNotices/core}}模板内。假如修改前的源代码为：
<syntaxhighlight lang="wikitext">
{{AdvancedSiteNotices/core|
  {{AdvancedSiteNotices/item|-{zh-cn:欢迎来到维基百科; zh-tw:歡迎來到維基百科;}-}}
}}
</syntaxhighlight>

修改后的源代码将类似于下面的代码：
<syntaxhighlight lang="wikitext" highlight="3">
{{AdvancedSiteNotices/core|
  {{AdvancedSiteNotices/item|-{zh-cn:欢迎来到维基百科; zh-tw:歡迎來到維基百科;}-}}
  {{AdvancedSiteNotices/item|你好，世界}}
}}
</syntaxhighlight>

=== &#123;{AdvancedSiteNotices/item}&#125;的参数 ===
&#123;{AdvancedSiteNotices/item}&#125;有两个匿名参数和一个命名参数：'''<span style="color:#FF00FF;">{&#123;{1}&#125;}</span>'''为必填参数，填写通告的实际内容；'''<span style="color:#FF00FF;">{&#123;{2}&#125;}</span>'''和'''<span style="color:#FF00FF;">{&#123;{criteria}&#125;}</span>'''为选填参数，可以定义通告面向的人群：
<!--<pre style="background: #F9F9F9; border: 1px dashed #2F6FAB">-->
 &#123;{AdvancedSiteNotices/item|'''<span style="color:#F-F00FF;">{&#123;{1}&#125;}</span>'''|'''<span style="color:#FF00FF;">{&#123;{2}&#125;}</span>'''|'''criteria=<span style="color:#FF00FF;">{&#123;{criteria}&#125;}</span>'''}&#125;

参数'''<span style="color:#FF00FF;">{&#123;{criteria}&#125;}</span>'''应为有效的JavaScript表达式。须注意，'''由于安全原因，表达式中只支持以下语法'''：
* 字串（僅支援 <code><nowiki>'</nowiki></code>、<code><nowiki>"</nowiki></code> 包裹，支援跳脫字元 <code><nowiki>\n</nowiki></code>、<code><nowiki>\t</nowiki></code>、<code><nowiki>\r</nowiki></code>、<code><nowiki>\b</nowiki></code>、<code><nowiki>\f</nowiki></code>、<code><nowiki>\x</nowiki></code>、<code><nowiki>\u</nowiki></code>）；
* 布林值；
* 邏輯運算子<code><nowiki>&&</nowiki></code>和<code><nowiki>||</nowiki></code>；
* 一元運算子<code><nowiki>!</nowiki></code>；
* 用括號包裹表達式（如<code><nowiki>(a && b) || c</nowiki></code>）；
* 函數调用（僅支援<code><nowiki>func(arg1, arg2)</nowiki></code>的形式，仅支持调用下方列明的函数）。
<div style="background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 0.3em 1em;">
* 需傳值的函數：
** <span style="color:blue;">in_country</span> - 测试用户所在[[ISO 3166-1|国家或地区]]，只要匹配其中一個傳入值就會返回 <code>true</code>
** <span style="color:blue;">in_region</span> - 测试用户所在[[ISO 3166-2|主要行政区]]，只要匹配其中一個傳入值就會返回 <code>true</code>
** <span style="color:blue;">in_city</span> - 测试用户所在城市，只要匹配其中一個傳入值就會返回 <code>true</code>
** <span style="color:blue;">in_group</span> - 测试用户所在用户组，只要匹配其中一個傳入值就會返回 <code>true</code>
** <span style="color:blue;">in_group_every</span> - 测试用户所在用户组，{{red|只有用戶擁有所有用戶組時才返回 <code>true</code>}}
** <span style="color:blue;">in_lang</span> - 测试用户使用語言，只要匹配其中一個傳入值就會返回 <code>true</code>
* 無需傳值的函數：
** <span style="color:blue;">is_anon</span> - 测试用户是不是匿名用戶
** <span style="color:blue;">is_temp</span> - 测试用户是不是臨時帳戶
** <span style="color:blue;">is_named</span> - 测试用户是不是註冊用户
</div>

当没有填写时，将使用参数'''<span style="color:#FF00FF;">{&#123;{2}&#125;}</span>'''。

参数'''<span style="color:#FF00FF;">{&#123;{2}&#125;}</span>'''有多种模式，各种模式可以混用，并以空格分隔：
<div style="background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 0.3em 1em;">
* <span style="color:blue;">only_sysop</span> - 只对管理员显示
* <span style="color:blue;">only_logged</span>（'''已棄用'''）、<span style="color:blue;">only_logged_in</span>、<span style="color:blue;">is_named</span> - 只对註冊用户显示
* <span style="color:blue;">only_anon</span>（'''已棄用'''）、<span style="color:blue;">only_logged_out</span> - 只对'''登出用户'''显示，請注意臨時帳號'''算是登出用戶'''
* <span style="color:blue;">is_temp</span> - 只对臨時帳號显示
* <span style="color:blue;">is_anon</span> - 只对'''匿名用户'''显示，請注意臨時帳號'''不算是匿名用戶'''
* <span style="color:blue;">only_zh_cn</span> - 只对大陆用户显示
* <span style="color:blue;">only_zh_hk</span> - 只对香港和澳门用户显示
* <span style="color:blue;">only_zh_sg</span> - 只对新加坡和马来西亚用户显示
* <span style="color:blue;">only_zh_tw</span> - 只对台湾用户显示
</div>

实际用例：
<syntaxhighlight lang="wikitext">
{{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}}}}
</syntaxhighlight>