Quick docs

Installation
wpAdMentor is installed just like any Wordpress plugin. After installation and activation of the
plugin you will see a new menu:

General information
wpAdMentor is a banner management/rotator integrated into Wordpress. All management is done from
the regular Wordpress admin GUI. You can use to rotate “regular img/href” as well as HTML campaigns (which
means you can use the AdSense code for example).

The idea is that you first create adpositions - that is basically an ad spot on your website.
Example “Top banner”, “Side banner 1″, “Side banner 2″. Each campaign you create is then attached to
an adpos, for example you might want a 468*60 CJ banner to be shown on top position. Additional targetting
is done using the regular Wordpress categories.

Lets say you have two categories on your website - Games and Webmaster. You post articles about games
in the Games category and webmaster articles in your Webmaster category. Naturally. Now lets say
you have a banner for buying games. wpAdMentor lets you target that banner so it only shows
on the posts (and category pages) for Games.
Likewise you might want to run a hosting banner only for posts/pages inside
the “Webmaster” category.

You can assign a campaign to run on multiple categories so to speak - for example a banner for
game servers might be suiteful both for your “Games” and “Webmaster”pages.

Explaining weight

Imagine a lottery.
Each banner is assigned a weight and when deciding which banner to show at a specific moment,
all banners matching (correct adposition and correct category etc) are retrieved. Then all banners
get as many “lottery tickets” as they have weight. Meaning if Banner A has a weight of 10 and
banner B has a weight of 5, banner a gets 10 lottery tickets and banner B only 5. So banner A will
have bigger chance of “winning” (i.e being showed on the page), and roughly, over time, it will be
shown twice as many times as banner B.

More targetting:
In Wordpress, of course there are pages which are NOT a category page or not a single post.
Then how can we decide which banner to run on these pages ( say the homepage, or search page).
For these purposed there is an extra checkbox when creating/editing a campaign - “Show on other pages”.

As for Wordpress pages (say “About”, or “Sitemap” or whatever pages you have) you have full contreol and
can select that a certain banner is only to be shown on thje “About page” for example.

Now - we have created the ad positions (say “top position”, “side banner” and “inside post” ).
We have created the banners and assigned them to the correct adpositions and categories. Now, how can we
get the banner rotator into the pages? First have a look at the adpositions list

See the ID column? We are gonna need that now.

There are basically two ways of getting the banner rotation onto your blog pages

• You can from your template file - wherever you want the ad to appear:

<?  print AdMentor_ServeBanner(3) ?>

See number 3? That is the adposition ID. The system will automatically target on category/type of page,
but it simply can’t guess where your ad spots are. So therefore you specify that.

• The other way is from inside the post:

More screenshots, editing campaign

More screenshots, stats

Shortcomings in this version:
-no upload at all. You need to upload the image file and enter the url to it