OVERVIEW
========
This module helps with integration the OpenX adserver (http://www.openx.org/)
into Drupal. Escpecially it helps with seperating code (where to place ads in
templates) and content (which ads to serve). This module will generate all the
JavaScript required to invoke OpenX adserver.
INSTALLATION
============
(1) Place the OpenX folder in your modules direcotry.
(2) In your site, navigate to Administer/Site Building/Modules, and enable the
OpenX module.
CONFIGURATION
=============
Go to Administration/Site Configuration/OpenX Adserver to set configuration options.
Configuration options are split into three parts:
(a) Adserver Settings
Every OpenX Server can be configured differently regarding domains and script names. Therefore, you need to provide in the urls and
script names to be called. You can copy and paste the values from the adserver's site Settings/Main Settings in the administrator panel.
If you don't have administrator access on the adserver, ask your administrator for the according values.
(b) Publisher Settings
Every website is known as a publisher in the OpenX adserver. Copy the publishers mnemonic and the number of zones for this site here.
(c) Zones
Now you are ready to enter your zones. Every zone has a unique number and an internal code, you can copy this information from your
adserver generated invocation code. Navigate to Inventory/Publishers & Zones/[My site]/Invocation Code. For every zone you'll find
code like this one:
<script language='JavaScript' type='text/javascript'>
<!--
az_adjs(52,'siteea111cd');
//-->
</script>
52 is the zone ID and "siteea111cd" is the zone code in question.
Aditionally you may give your zone a name, to access this zone within template code. You may also for every user role determine, if ads
are shown or not.
BLOCKS
======
This module offers as many blocks as zones are defined. The blocks are named
after the zones that is "OpenX Zone 0", "OpenX Zone 1" etc. You may enable or
disable blocks under Adminstration/Site Building/Blocks.
MANUAL INVOCATION
=================
If you want to place ads within your templates manually, you may use the following code:
<?php print openx_invoke([index]); ?>
Where [index] is the number of one of your zones, that is 0, 1, etc. You may also invoke a zone by its name, like this:
<?php print openx_invoke("leaderboard top"); ?>
The module will take care to generate the according JavaScript after validate if to show ads to the user logged in
