=== Advertising Manager ===
Contributors: switzer
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=scott%40switzer%2eorg&item_name=Do%20you%20like%20Advertising%20Manager%20for%20Wordpress%3F%20%20Please%20help%20development%20by%20donating%21&currency_code=USD&bn=PP%2dDonationsBF&charset=UTF%2d8
Tags: ad, adbrite, adgridwork, adify, admin, adpinion, adroll, ads, adsense, adserver, advertisement, advertising, affiliate, banner, banners, chitika, cj, commercial, commission, crispads, google, income, junction, link, manager, media, money, openx, plugin, random, referral, revenue, rotator, seo, server, shoppingads, widget, widgetbucks, yahoo, ypn
Requires at least: 2.5
Tested up to: 3.0
Stable tag: 3.4.19

Easily place Google Adsense and other ads on your Wordpress blog.  Simple to use, with powerful management and optimisation features.

== Description ==

This plugin will manage and rotate your Google Adsense and other ads on your Wordpress blog.  It automatically recognises many ad networks including [Google Adsense](http://www.google.com/adsense), [AdBrite](http://www.adbrite.com/mb/landing_both.php?spid=118090&afb=120x60-1-white), [Adify](http://www.adify.com), [AdGridWork](http://www.adgridwork.com/?r=18501), [Adpinion](http://www.adpinion.com/), [Adroll](http://re.adroll.com/a/D44UNLTJPNH5ZDXTTXII7V/7L73RCFU5VCG7FRNNIGH7O/d6ca1e265e654df2010a2153d5c42ed4.re), [Chitika](http://chitika.com/publishers.php?refid=switzer), [Commission Junction](http://www.cj.com/), [CrispAds](http://www.crispads.com/), [OpenX](http://www.openx.org/), [ShoppingAds](http://www.shoppingads.com/refer_1ebff04bf5805f6da1b4), [Yahoo!PN](http://ypn.yahoo.com/), and [WidgetBucks](http://www.widgetbucks.com/home.page?referrer=468034).  Other ad networks can be used as well.

Features:

* The most popular ad plugin for Wordpress, with new features coming every single month
* Simple way to import all of your ads
* Widget can be used to place ads in the sidebar
* Put ads in your blog posts with the click of a button
* Ads can be placed in your templates with a single PHP function
* Ad limitations by author, category, tag, page type, and much more
* Auto-recognition for 15 of the most popular ad networks, so you can manage these ads in your Wordpress blog rather than going to each website.

Related Links:

* <a href="http://code.openx.org/projects/show/advertising-manager" title="Advertising Manager plugin for WordPress">Plugin Homepage</a>
* Follow <a href="http://twitter.com/scottswitzer" title="Track Advertising Manager developments by following author Scott Switzer on Twitter">Scott Switzer</a> and <a href="http://twitter.com/openx" title="Track Advertising Manager developments by following sponsor OpenX on Twitter">OpenX</a> on Twitter
* <a href="http://code.openx.org/projects/activity/advertising-manager" title="Recent changes for the Advertising Manager plugin for WordPress">Recent Changes</a>
* <a href="http://code.openx.org/projects/advertising-manager/issues" title="Feature requests and bugs">Feature Requests and Bugs</a>
* <a href="http://wordpress.org/tags/advertising-manager">Support Forum</a>
* <a href="http://openx.org/ad-server/get-openx-hosted">OpenX Ad Server</a> - Advertising Manager is compatible with OpenX tags, in case you want to use advanced techniques to manage your ads.

== Installation ==

1. Unzip the package and upload the advertising-manager directory into your wp-content/plugins directory
1. Activate the plugin at the plugin administration page
1. Add your ad networks by clicking 'Create new' under the 'Ads' menu.  Manage your ad networks by clicking 'Edit' under the 'Ads' menu.
1. Place ads in your template by adding '<?php advman_ad(name) ?>' to your template in the place you want to see an ad (where 'name' is the name of your ad).
1. Place ads in your blog posts and pages by adding '[ad#name]' to your blog post (where 'name' is the name of your ad), or by using the 'Insert Ad' dropdown from the edit toolbar.
1. Place ads in your sidebar by dragging the 'Advertisement' widget onto your sidebar, and selecting the ad you want to display

More detailed installation instructions can be found on the [Advertising Manager Wiki](http://code.openx.org/wiki/advertising-manager/Installation_Instructions).

If you are upgrading from Adsense Manager, Adsense Deluxe, or a previous version of Advertising Manager, upgrade instructions can be found [here](http://code.openx.org/wiki/advertising-manager/Upgrading_Instructions).


== Screenshots ==

1. Manage Your Advertising in Wordpress 2.7
1. Create ad in Wordpress 2.7
1. Edit ad in Wordpress 2.7
1. Ad settings in Wordpress 2.7
1. Manage Your Advertising in Wordpress 2.5
1. Create ad in Wordpress 2.5
1. Edit ad in Wordpress 2.5
1. Ad settings in Wordpress 2.5


== Frequently Asked Questions ==

= I previously used the Adsense Manager plugin for Wordpress.  Do I need to reconfigure my ads? =
Advertising Manager will automatically import your settings from Adsense Manager.  There is no modification necessary.  In addition, Advertising Manager will accept the Adsense Manager ad calls ('<?php adsensem_ad() ?>') as well.

= I previously used Adsense Deluxe plugin for Wordpress.  Do I need to reconfigure my ads?
Advertising Manager will automatically import your settings from Adsense Deluxe.  There is no modification necessary.  In addition, Advertising Manager will accept the Adsense Manager ad calls ('<!--adsense#name-->') as well.

= Does Advertising Manager support Wordpress MU (multi-user)? =
Yes.

= Can Advertising Manager work in my language? =
Yes.  Advertising Manager is localised.  If your blog is in another language, and Advertising Manager shows in English, then it is most likely that a translation has not been done.
Don't worry - if you are a native speaker in English as well as your local language, you can help out!  Information on how to get involved can be found here:

http://code.openx.org/wiki/advertising-manager/Translate_Advertising_Manager_in_your_language

= Do I still need Advertising Manager now I can manage ads through Google's system? =

Yes.  Advertising manager allows you to rotate ads, easily turn on/off ads, place them in your blog, and many features other than configuration of the ad colors and format.  It a critical tool to use if you want to make more from your advertising.

= Why does changing Ad Format/Dimensions sometimes not change the size of the ad? =

For some ad networks (e.g. newer Adsense tags, WidgetBucks, Adroll, etc.) the dimensions of ads are managed through the online interface. There is no way to change these settings from within the WordPress system that would work reliably. You do not have to update these dimension settings if you update your Ad online, however, it can be useful in correctly identifying 'Alternate Ads' for AdSense blocks.

= How do I place Ad code at the top, bottom, left, right, etc. of the page? =

There is a (nice tutorial here)[http://www.tamba2.org.uk/wordpress/adsense/] which explains positioning using code in template files. You can use this together with Advertising Manager: just place the ad code tags <?php advman_ad('name'); ?> where it says "place code here". 

= How can I share revenue with my authors? =

1.  Load YOUR ad into Advertising Manager.
1.  Load your AUTHOR's ad into Advertising Manager.
1.  Name both ads the same - this will allow them to rotate.
1.  In your author's ad, be sure to select the authors username in Display Options
1.  Set the weights of the ads according to your revenue share.  The easiest way to do this is to set YOUR ad weight to 36, and then set the weight of your author's ad according to the revenue share deal.  For 10% revenue share, set the author ad weight to 4; 20% = 9; 33% = 18; 40% = 24; 50% = 36; 60% = 54; 66.7% = 72; 70% = 84; 80% = 144; 90% = 324.  For the nerdy wonks out there, the formula is (AUTHOR AD WEIGHT) = (MY AD WEIGHT * REVENUE SHARE) / (1 - REVENUE SHARE)

More detailed instuctions can be found in the documentation:  [Concepts - Placing ads on your blog](http://code.openx.org/wiki/advertising-manager/Placing_ads_on_your_blog)


== To Do ==

* Link into OpenX Sync and OpenX Market for optimisation
* Auto-inserting of ads into posts based on configurable rules (i.e. All Posts, 2nd Paragraph)
* Support for Amazon Affiliates and any other networks I hear about.

== Upgrade Notice ==

= 3.4.19 =
* Fixed PHP ads to use proper syntax

== Change Log ==

= 3.4.19 =
* Fixed PHP ads to use proper syntax

= 3.4.18 =
* Fixed PHP Compaitible Mode to work with in-post ads
* Tested with WP 3.0 and made minor changes

= 3.4.17 =
* Fixed compatibility issue with the Tweet Blender plugin (thanks kirilln!)
* Fixed readme file formatting issues

= 3.4.16 =
* Fixed bug with displaying ads in a widget.

= 3.4.15 =
* Fixed issue with serving ads in a post.  Added tag based ad limitations.

= 3.4.14 =
* Removed some notices from the code.  Added PHP ad ability (BETA).  Added collecting statistics on ads (as a start - much more to do).  Added the 'notes' column in the ad list.

= 3.4.13 =
* Added additional checking before including files in the plugin directory.  Removed '@' for defines - if there is an error, things should stop there.

= 3.4.12 =
* Added displaying ads to particular categories.

= 3.4.11 =
* Fixed error when using Advman for Swedish and other languages.

= 3.4.10 =
* Fixed array error when checking for author.

= 3.4.9 =
* Fixed show-author functionality.  Add ability to 'Set Max Ads Per Page' for all ad types.

= 3.4.8 =
* Fixed minor Google Adsense 'type' issue, minor notice, and fixed defaulting

= 3.4.7 =
* Fixed adsense account id importing issue, short tag issue, and openx importing issue

= 3.4.6 =
* Fixed and expanded widget functionality for WP2.8 users

= 3.4.5 =
* Fixed many small bugs, formatting changes, and missing fields from some ad networks

= 3.4.4 =
* Fixed an issue where scripts were being delivered to all admin screens

= 3.4.3 =
* Fixed display bug with WP 2.8

= 3.4.2 =
* Added multiple select for author field, changed the page type field (show *), fixed error in factory method

= 3.4.1 =
* Fixed settings screen, and random bug with printf

= 3.4 =
* New architecture - less space, more efficient code.  Tons of ad network bug fixes.  Added plugin design, and new ad serving engine.

= 3.3.18 =
* Added ability to suppress widget formatting on ads, fixed issue with PHP_INT_MAX on versions of PHP before 4.4.

= 3.3.17 =
* Fixed a bug with widget display, updated all language files, fixed a bug with Ozh plugin

= 3.3.16 =
* Added functionality around reverting to older versions of adsensem, fixed a bug with 0 weight ads, fixed a bug displaying ID rather than name for post ads

= 3.3.15 =
* Fixed small bug in upgrade script, added counter support to widgets

= 3.3.14 =
* Only enable Advertising Manager when Adsense Manager is disabled

= 3.3.13 =
* Fixed a notice error in WP 2.6, added a small script which removes a notice set by adsense manager

= 3.3.12 =
* Fixed error when using Advertising Manager as a widget

= 3.3.11 =
* Added 'advman' to all variables which reside in the wordpress scope, to ensure that they do not stomp on other plugins

= 3.3.10 =
* Added Chitika support, added counter support, fixed regex for ad in posts

= 3.3.9 =
* Public beta - rotating ads, Adify support, much bug fixing and code restructuring

= 3.3.4 =
* First alpha version that is separate from Adsense Manager


== Licence ==

This plugin is released under the GPL - you can use it free of charge on your personal or commercial blog. Make sure to submit back to the project any changes that you make!

== Translations ==

The plugin comes with various translations, please refer to the [WordPress Codex](http://codex.wordpress.org/Installing_WordPress_in_Your_Language "Installing WordPress in Your Language") for more information about activating the translation. If you want to help to translate the plugin to your language, please have a look at the advman.pot file which contains all defintions and may be used with a [gettext](http://www.gnu.org/software/gettext/) editor like [Poedit](http://www.poedit.net/) (Windows).
