=== Plugin Name ===
Contributors: matchalabs
Tags: advert, banner, google ads, ads
Requires at least: 3.3
Tested up to: 3.5
Stable tag: 0.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Flexible advert system with an easy advert creation process.

== Description ==

Once installed and set up (requires some simple template edits - see 'Installation'), the advert creation process is simple:

1. Create an advert (either upload an image or paste HTML)
2. Tag the advert to location (e.g. sidebar)
3. Optionally restrict the advert to be displayed on specific posts or pages (e.g. home page)
4. That's it!

Features:

* Define unlimited advert locations (e.g. header, footer, sidebar)
* Configure the number of adverts to display in each location (default is 1)
* Create image or HTML adverts
* Set start and end dates for adverts
* Restrict advert to showing on specified pages and post types
* Counts impressions and clicks per advert
* No advert size restrictions
* Requires simple template edits (to insert advert location shortcodes)
* Mask Advert URL in the browser status bar - no ugly click tracking URLs

Tested with:

* Google Adsense
* Adzerk

== Installation ==

1. Upload the `ml-adverts` folder to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Navigate to 'ML Adverts -> Advert Locations' and create the locations you want to place adverts (e.g., header, footer, sidebar)
1. Make a note of the shortcodes for each location (shortcodes are displayed in the table)
1. Update your templates and put the shortcode for each area in the correct place: `<?php echo do_shortcode("[ml-adverts location=your-location-name]"); ?>`
1. Navigate to 'ML Adverts -> Add New' to create your adverts


== Frequently Asked Questions ==

= Why isn't my advert displaying? =

If the advert Status is "Active", then ensure the correct location shortcode is placed in the template (see "Installation"), otherwise fix the issues listed in the Status column on the advert listing page.

= What happens if 2 active adverts are tagged to the same location, but the location is only set to display 1 advert? =

A single random advert for that location will be displayed. 

= Why is the clicks count listed as "N/A"? =

Clicks are only counted for image type banners. For HTML type banners (e.g. Google Ads) you should use your
publishing account to view the number of clicks.

== Screenshots ==

1. Creating advert locations
2. Insert shortcodes into template
3. Creating adverts

== Changelog ==

= 0.1 =
* Initial version

== Upgrade Notice ==

= 0.1 =
* Initial version