Extension:AdManager

MediaWiki extensions manual
AdManager
Release status: unmaintained
Implementation Special page , Skin
Description Allows setting an ad zone for individual pages or categories
Author(s) Ike Hecht (tosfostalk)
Latest version 0.3.1 (2014-07-05)
MediaWiki 1.29+
PHP 5.3+
Database changes Yes
Tables ad
adzones
License GNU General Public License 2.0 or later
Download
  • $wgAdManagerService
  • $wgAdManagerPlacement
  • $wgAdManagerCode
Quarterly downloads 7 (Ranked 169th)
Translate the AdManager extension if it is available at translatewiki.net

The AdManager extension allows per-page or per-category placement of ads into a wiki page. It is designed to work with zones from an external advertising server such as OpenX but allows the placement of zones from (probably) any such server. The ads are displayed in the sidebar.

This extension was sponsored by the American Academy of Ophthalmology and was developed by WikiWorks.

UsageEdit

Defines two special pages: Special:AdManagerZones and Special:AdManager. Special:AdManagerZones is used to set which zones are available in Special:AdManager. These should be set to the zone number that the advertising server would normally insert into its insertion code. Special:AdManager is used to assign specific pages or categories to ad zones.

InstallationEdit

  • Download and place the file(s) in a directory called AdManager in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php :
    wfLoadExtension( 'AdManager' );
    # $wgAdManagerService = 
    # $wgAdManagerCode =
    
  • Run the update script which will automatically create the necessary database tables that this extension needs.
  •   Note: One of the configuration parameters must be uncommented and set appropriately.
  •   Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

To users running MediaWiki 1.24 or earlier:

The instructions above describe the new way of installing this extension using wfLoadExtension(). If you need to install this extension on these earlier versions (MediaWiki 1.24 and earlier), instead of wfLoadExtension( 'AdManager' );, you need to use:

require_once "$IP/extensions/AdManager/AdManager.php";

ConfigurationEdit

ParametersEdit

  • $wgAdManagerService - This can (currently) be set to 'openx'. If you set this, you do not have to set the $wgAdManagerCode (which will be ignored anyway).
  • $wgAdManagerCode - Use this parameter to use any other advertising service. The code must include '$1' for any spot where the zone number should be inserted.

User rightsEdit

  • admanager - Permission to use the two special pages to add zones or apply them to a page/category.