=== Ads By Country ===
Contributors: Nick Daugherty
Donate link: http://www.skyrocketwebsites.com/donate/
Tags: ads by country, ads, adsense, affiliate, manage ads, monetization, monetize,paypal, yahoo publisher, ypn, ip location, geoip, geolocation, ip address location, geo ip, ip geolocation, ip to location, geotargeting, ip address, location from ip address, ip country, ip locator, ip location, ip town, ip city, geomarketing

Requires at least: 2.7
Tested up to: 3.1

This plugin creates a javascript widget in your sidebar that shows ads to your site visitors based on what country they're in. 

== Description ==

This plugin creates a javascript widget that shows ads in your sidebar based on what country each visitor is from.  It uses the MaxMind GeoIP JS Web Service to do this.

MaxMind's API is extremely fast, lightweight, and most of all, free.

Since it's all Javascript, it *should* be compatible with caching plugins like W3 Total Cache and WP Super Cache (needs testing).

DISCLAIMER: The author of this plugin is in no way associated with MaxMind, and this plugin is not sanctioned or supported by MaxMind in any way. This plugin is offered with no warranties or guarantees, expressed or implied. The author of this plugin is in no way responsible for any results associated with the use of this plugin.

== Installation ==

1. Upload the plugin folder `ads by country` to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Visit the Options >> Ads By Country Page to set up your ads
1. Visit the Appearance >> Widgets Page to include your widget in the sidebar
1. (Optional) Use any of the following shortcodes in your posts or pages:
   [mmjs-countrycode] : returns the ISO 3166-2 country code
   [mmjs-countryname] : returns the country name
   [mmjs-ip]          : returns ip address
1. The following JavaScript variables are also made available in your theme:
   mmjsCountryCode
   mmjsCountryName
   mmjsIPAddress

== Frequently Asked Questions ==

= Does WP GeoLocation work all the time? =
According to MaxMind.com, their geolocation service is online 99.95% of the time.

= Does WP GeoLocation always display info accurately? =
No. If your visitor is using a proxy, then their actual geolocation info will be incorrect.

= How accurate is the geolocation information? =
Pretty accurate. This plugin accesses MaxMind's server to get geolocation data, so it's usually on target.
However, if your visitor is from a small town, their location may resolve to the nearest large metro area.

= What are the disadvantages of using the JavaScript service? =
The main disadvantage is that the information is saved to JavaScript variables as opposed to PHP variables.
This means that you can't have wordpress act differently with post content until the page is loaded.

The updside is that the JavaScript service is far more accurate than the free GeoIP database that is offered.

== Changelog ==

= 0.1 =
* Initial release

== Upgrade Notice ==

= 0.1 =
* Initial release