Extension:DismissableSiteNotice

MediaWiki extensions manual

DismissableSiteNotice Release status: stable
Implementation	Skin , MyWiki
Description	Allows users to close the sitenotice
Author(s)	Brion Vibber (Brion VIBBERtalk)
Latest version	continuous updates
Compatibility policy	Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki	>= 1.34.0
Database changes	No
License	GNU General Public License 2.0 or later
Download	Download extension Git [?]: Download Git master browse repository (GitHub) commit history repository contributors (GitHub) code review
Parameters $wgMajorSiteNoticeID $wgDismissableSiteNoticeForAnons
Hooks used SiteNoticeAfter
Quarterly downloads	58 (Ranked 116th)
Public wikis using	2,711 (Ranked 188th)
Translate the DismissableSiteNotice extension if it is available at translatewiki.net
Issues	Open tasks · Report a bug

The DismissableSiteNotice extension allows users to close the sitenotice, using cookies.

Installation

• Download and place the file(s) in a directory called DismissableSiteNotice in your extensions/ folder.
• Add the following code at the bottom of your LocalSettings.php :

  wfLoadExtension( 'DismissableSiteNotice' );
  

• Configure as required.
•  Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration

This extension provides two configuration parameters:

$wgMajorSiteNoticeID

Integer. The value is stored inside a cookie. When a user decides to close the sitenotice, the current value of $wgMajorSiteNoticeID is saved as well and the closed notice is not shown again. $wgMajorSiteNoticeID now can be incremented when a new text is set up as sitenotice. If $wgMajorSiteNoticeID has inbetween been incremented, then the sitenotice is shown again, even if the user closed an older sitenotice before.

$wgDismissableSiteNoticeForAnons

This allows to set whether or not it should be possible for anonymous visitors of the wiki to dismiss the sitenotice shown. Defaults to "false". Available for MW 1.25 +

Usage

When you add a new sitenotice and want everyone to see it, change the number on the created page "MediaWiki:Sitenotice id" by one (e.g. if it would be 5, you'd replace the page with the number 6 and so on).

The extension behavior is that it will remember the dismissal by the user and only reset after the number in MediaWiki:Sitenotice_id has been raised. This allows a wiki to make minor updates to a notice without causing it to show again for everybody.