Template:WatchlistNotice

An empty watchlist notice for use on MediaWiki:WatchlistNotice

Template documentation[ view · edit · history · purge ]

This documentation is transcluded from Template:WatchlistNotice/doc.

Displays a watchlist notice if all of the conditions are met. Some criteria allow specifying lists. If one of the list entries fullfills the condition, the whole criterion is considered fulfilling the condition. For example, if you specify DE:US, the message might be shown in Germany and the United States. For use at MediaWiki:WatchlistNotice. See also: Help:Watchlist messages

Usage

{{WatchlistNotice
|id            =
|text          =
|type          =
|from          =
|until         =
|countries     =
|cities        =
|latFrom       =
|latTo         =
|lonFrom       =
|lonTo         =
|preferences   =
|languages     =
|groups        =
|browser       =
|browserVerMin =
|browserVerMax =
|browserLang   =
|condition     =
}}

This template makes use of LUA (server side) and JavaScript (client side) to accomplish its tasks.

Using the following sample doesn't make sense but it shows how each of the parameters could be used:

{{WatchlistNotice
|id=0
|text={{LangSwitch
  |de=German translation
  |en=English translation
}}
|type=i18n
|from=2014-01-01 22:00:00
|until=2014-07-01 22:00:00
|countries=DE:US
|cities=Lynchburg:Petersburg:Frankfort:Kassel:Essen:Berlin:Köln
|latFrom=40.0
|latTo=50.0
|lonFrom=-120.0
|lonTo=20.0
|preferences=gadget-AjaxQuickDelete=1;fancysig=1
|languages=en:de:fr
|groups=licensereviewer autopatrolled
|browser=opera
|browserVerMin=3
|browserVerMax=100
|browserLang=en:de:fr
}}

Template parameters

Parameter	Description	Default	Status
`id`	Numbers only. Each message should have a unique id. An exception are messages with the same content. They may share the same ID.	empty	required
`text`	The text to be displayed. You may use {{LangSwitch}} here.	empty	required
`type`	One of the following types: `policy_new\|policy_change\|technical_new\|technical_change\|technical_issue\|poty` complete, customizable list of supported types	empty	required
`from`	Time (UTC) in format `YYYY-MM-DD hh:mm:ss` from which on the notice should be shown. `YYYY` is the four digit year (e.g. 2023); `MM` is the month of the year (e.g. 06 for June); `DD` is the day of the month (e.g. 31); `hh` is the hour (e.g. 01); `mm` is the minute of the hour (e.g. 05); `ss` — Second of the minute (e.g. 02). The number of letters corresponds with the number of digits required. Therefore, single digit numbers must be padded with 0.^LUA	empty	optional
`until`	Time (UTC) in format `YYYY-MM-DD hh:mm:ss` until which the notice should be shown.^LUA	empty	optional
`countries`	A colon (`:`)-separated list of `ISO 3166-1 Alpha 2` country codes. E.g. DE for Germany and US for the United States of America. Complete list (list with flags) (en:ISO 3166-1)^JS	empty	optional
`cities`	A colon (`:`)-separated list of cities. Note that in case it is unknown to the server, `(null)` will be returned. Usually in the country's native language. View your city.^JS	empty	optional
`latFrom`	Geographical latitude (in degree [`°`]); from -90.00 to 90.00; A negative sign means South, a positive value means North. Note the dot (`.`) as a decimal mark. With `latFrom`, `latTo`, `latFrom` and `lonTo` you are able to specify a rectangle. Message is shown to users who live inside this region. All four values must be specified or none of them. LatFrom and LonFrom specify the the top left corner of the recangle if the north is on top.^JS	empty	optional
`latTo`	see `latFrom`^JS	empty	optional
`lonFrom`	Geographical longitude; from -180.00 to 180.00; A negative number means West, a positive value means East.^JS	empty	optional
`lonTo`	see `lonFrom`^JS	empty	optional
`preferences`	A semicolon-separated list of user options in the following format: `key=value;key=value;key!=value;`. This allows you to _target messages e.g. to users who make use of UploadWizard or who prefer having the categories on top of the page or to check for inequality `!=` with a user preference. The expression is only evaluated if the user preference is available to the script. Otherwise it is implicitly passed. List visible in a JavaScript browser console executing `mw.user.options.values`. Every value is converted to String automatically. Please do not add quotation marks. (cf. example above)^JS	empty	optional
`languages`	A colon (`:`)-separated list of ISO 639-1 language codes which will be checked against the Commons user language. Language variants (e.g. pt-br) will be considered as matching the condition if only the main language as specified by ISO 639-1 is supplied. No further fallback mechanism is used. Cf. {{List of supported languages}}^LUA	empty	optional
`groups`	A space separated list of user groups for whom to show the message. One or more of the following: `licensereviewer autopatrolled filemover patroller adminonly OTRS` (or take the values from this list). As always, at least one of the values must be met by the user to fulfill this criterion. Example: User:EuroHawk is a patroller. If you specify "filemover patroller adminonly", the message will be possibly — provided that the remaining criteria set up by other parameters of this template are met — shown to them. ^CSS^LUA	empty	optional
`browser`	A colon (`:`)-separated list of internal browser names so that the message is only shown in these particular browsers (aka user agents, clients). Useful if there are known issues with special browsers. You can pick them from this list's value column.^JS	empty	optional
`browserVerMin`	Message (possibly) shown if the browser version is equal or greater than browserVerMin. See `browser`.^JS	empty	optional
`browserVerMax`	Message (possibly) shown if the browser version is equal or less than browserVerMax. See `browser`.^JS	empty	optional
`browserLang`	A colon (`:`)-separated list of RFC 4646 identifiers.The Language Identifier (LCID) “consists of its [ISO-639] language code, its [ISO-3166] country/region code, and an optional [ISO-15924] script tag for the written language, as described in [RFC4646].”^[1] Either the browser language setting or the OS language setting (depending on what can be retrieved) will be checked against this list. Providing only the ISO-639 (language) code (omitting country/region) allows you to _target the message to all the language variants.^JS	empty	optional
`condition`	Here, you can add a condition à la façon `{{#expr:{{PAGESINCAT:User needing help\|pages}}>=3}}`. A result of 0 will prevent the message from being shown, any other result will be considered as fulfilling the condition. This way, you can avoid wrapping something around the template when you are in need of additional conditions.^LUA	1	optional
`bug`	Reserved for later extension. It's possible to query the Bugzilla API for a bug status. [1] [2] en:MediaWiki:Gadget-BugStatusUpdate.js ^JS	empty	optional

Additional information

The template is intended to be used in the following namespaces: the Special namespace

The template is intended to be used by the following user groups: Administrators

Relies on:

Localization

This template is not intended to be localized.

References

↑ http://msdn.microsoft.com/en-us/library/cc233967.aspx

[msdn-lcid-1] ttp://msdn.microsoft.com/en-us/library/cc233967.aspx

[1]