Extension:CentralNotice

The CentralNotice extension delivers announcements (usually in the form of banners) to Wikimedia wikis.

It is used heavily by the Fundraising team to solicit donations, and for announcements of interest to Wikimedia communities and users.

CentralNotice can target announcements by country, language, project, device and logged-in status.

This page has information for CentralNotice developers and wiki administrators who want to install CentralNotice on their own sites.

To learn how to create and configure CentralNotice campaigns, please see Help:CentralNotice on Meta-Wiki.

For information about the CentralNotice setup on the Wikimedia Foundation's cluster, see CentralNotice on Wikitech.

CentralNotice allows central distribution of announcements to many wikis (called subscribing wikis) from a central wiki (the infrastructure wiki). English

[ ]
plementation that uses Campaign — a collection of banners. The project, country and content language selectors apply at the campaign level.  Campaigns are defined as active if the central wiki time is greater than the campaign start time, less than the campaign end time, and the campaign is marked as enabled.


 * Banners in a campaign are assigned a bucket and <tvar|2>weight</>. Buckets are yet another selector, and weight affects the relative allocation of banners inside a campaign.

None
 * There are four priority levels in CentralNotice. Higher priority campaigns will get a greater allocation of page views.


 * <tvar|1>Selector</> — any property which may be filtered on for the purposes of allocation.


 * 1>Special:MyLanguage/Extension:CentralNotice/Allocation system</>|Banner allocation algorithm


 * 1>Special:MyLanguage/Extension:CentralNotice/Database schema</>|Database schema / table layout

None


 * country: string - Two-letter country code.


 * region: string - Implementation specific.


 * lat: number.


 * lon: number.

New Campaign

 * 1) Load Special:CentralNotice


 * 1) Add a campaign with a given start time at the bottom portion of the page, leave a comment, and click submit.


 * 1) If this campaign is only run on a specific wiki and or language then select it from the pull downs.


 * 1) Click on the new campaign and add the banners you want within this running campaign and their respective weights.


 * 1) If all looks well then set this campaign to enabled and it will show at the corresponding time.

Add any of the following URL parameters to preview a specific banner, defeat "diet" schemes, or debug pseudorandom banner selection.


 * banner


 * randomcampaign
 * A decimal number between 0 and 1, to be used as the "random" seed for choosing a campaign.


 * randombanner
 * A decimal number between 0 and 1, to be used as the "random" seed for choosing a banner among banners available in the chosen campaign.


 * country
 * filteri None


 * English
 * English


 * force English



For example,




 * Extension:CentralNotice/Statuses, reasons and status codes
 * CentralNotice/Notes/Miscelaneous doc bits
 * Extension:CentralNotice/Notes/Documentation rewrite
 * Extension:CentralNotice/Notes/Campaign-associated_mixins_and_banner_history
 * Extension:CentralNotice/Notes/Banner controller refactoring
 * [ Other subpages of this page ] (warning: many are outdated)
 * Extension:CentralNotice/Notes/Documentation rewrite
 * Extension:CentralNotice/Notes/Campaign-associated_mixins_and_banner_history
 * Extension:CentralNotice/Notes/Banner controller refactoring
 * [ Other subpages of this page ] (warning: many are outdated)