Extension:AdManager

From MediaWiki.org
Jump to: navigation, search
MediaWiki extensions manual - list
Crystal Clear action run.png
AdManager

Release status: beta

Implementation Special page, Skin
Description Allows setting an ad zone for individual pages or categories
Author(s) Ike Hecht (tosfosTalk)
Last version 0.2 (September 2011)
MediaWiki 1.17.* or greater
Database changes yes
License GPL
Download See here
Parameters

$wgAdManagerService, $wgAdManagerCode

Added rights

admanager

Hooks used
LoadExtensionSchemaUpdates

SkinBuildSidebar

Check usage (experimental)

Contents

[edit] What can this extension do?

AdManager is an extension to MediaWiki that 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 or BanManPro 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.

[edit] Usage

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.

[edit] Download instructions

You can download the code directly via SVN from the MediaWiki source code repository, at http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/AdManager/. From a command line, you can call the following:

svn checkout http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/AdManager/

To view the code online, including version history for each file, you can go here.

[edit] Installation

To install this extension, add the following to LocalSettings.php:

include_once("$IP/extensions/AdManager/AdManager.php");
# Note: One of the lines below must be uncommented and set appropriately.
# $wgAdManagerService = 
# $wgAdManagerCode =

Note: After you've included the extension you must run update.php!.

[edit] Configuration parameters

  • $wgAdManagerService - This can be (currently) be set to either 'openx' or 'banman'. 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.

[edit] User rights

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

Variants
Actions
Navigation
Support
Download
Development
Communication
Print/export
Toolbox