updated readme

Author: Ryan Hoover

readme.txt

@@ -1,5 +1,5 @@
 === WP Engine GeoIP ===
-Contributors: wpengine, markkelnar, stevenkword, stephenlin, ryanshoover
+Contributors: wpengine, markkelnar, stevenkword, stephenlin, ryanshoover, taylor4484
 Tags: wpe, wpengine, geoip, localization, geolocation
 Requires at least: 3.0.1
 Tested up to: 4.2.2
@@ -13,6 +13,7 @@ Create a personalized user experienced based on location.
 
 WP Engine GeoIP integrates with the variables on your WP Engine site to display content catered to the visitor’s location. With the ability to access variables from as broad as country to as specific as latitude and longitude, your website can now display geographically relevant content.
 
+
 = Geo-Marketing =
 
 * Create marketing campaigns targeted only at certain locations.
@@ -31,7 +32,7 @@ WP Engine GeoIP integrates with the variables on your WP Engine site to display
 
 * Filter required legal notices from countries for whom those notices may not be relevant.
 
-= ** Please Note =
+= * Please Note * =
 
 This plugin will only function on your [WP Engine](http://wpengine.com/plans/?utm_source=wpengine-geoip) Business, Premium or Enterprise level account. This will not function outside of the WP Engine environment.
 
@@ -40,31 +41,92 @@ This plugin will only function on your [WP Engine](http://wpengine.com/plans/?ut
 1. Upload `geoip` to the `/wp-content/plugins/` directory
 2. Activate the plugin through the 'Plugins' menu in WordPress
 
-== Shortcodes ==
+Please view the 'Other Notes' tab to see all of the available GeoIP shortcodes
+
+
+== Location Variable Shortcodes ==
+You can use any of the following location variable shortcodes to return the various geographic location the user is visiting your site from:
+
+1) Continent: `[geoip-continent]`
+
+2) Country: `[geoip-country]`
+
+3) Region (State): `[geoip-region]`
+
+4) City: `[geoip-city]`
+
+5) Postal Code: `[geoip-postalcode]`
+
+6) Latitude: `[geoip-latitude]`
+
+7) Longitutde: `[geoip-longitude]`
+
+8) Location: `[geoip-location]`
+
+= Example =
+`Hi, and welcome to [geoip-city]! The place to be in [geoip-region],[geoip-country].`
+A visitor from Austin, Texas would see the following:
+`Hi, and welcome to Austin! The place to be in TX, US.`
+
+== Localized Content ==
+
+9) Content: `[geoip-content country="US"]Your US specific content goes here[/geoip-content]`
+The content shortcode allows you to hide or show specific content based on visitor geographies:
+
+Below are all the supported geography options, this allows to you SHOW content for only specific locations:
+
+* continent
+* country
+* areacode
+* region
+* city
+* postalcode
+
+Below are all the supported negative geography options, this allows to you HIDE content for only specific locations:
+
+* not_continent
+* not_country
+* not_areacode
+* not_region
+* not_city
+* not_postalcode
+
+= Examples of the Content Shortcode =
+This will display “Content just for US visitors” strictly for visitors viewing from the United States. 
+`[geoip-content country="US"] Content just for US visitors [/geoip-content]`
+
+
+This will display “Content just for everyone in Texas and California” strictly for visitors from Texas and California.
+`[geoip-content region="TX, CA."] Content just for everyone in Texas and California [/geoip-content]`
+
 
-1) Continent: [geoip-continent]
+You can mix and match geography and negative geography options to create verbose logic in a single shortcode:
+`[geoip-content country="US" not-city="Austin"]Content for US visitors but not for visitors in Austin[/geoip-content]`
 
-2) Country: [geoip-country]
 
-3) Region (State): [geoip-region]
+== Testing Parameters == 
+You can use the following URL parameters to test how your localized content will appear to visitors from various geographic locations. You can add any of the parameters below to any URL of a page using the GeoIP shortcodes or API calls:
 
-4) City: [geoip-city]
+Spoof visitor from the state of Texas:
+`yourdomain.com/?geoip&region=TX`
 
-5) Postal Code: [geoip-postalcode]
+Spoof visitor from the United States:
+`yourdomain.com/?geoip&country=US`
 
-6) Latitude: [geoip-latitude]
+Spoof visitor from Austin, Texas
+`yourdomain.com/?geoip&city=Austin`
 
-7) Longitutde: [geoip-longitude]
+Spoof visitor from the U.S. zip code 78701:
+`yourdomain.com/?geoip&zip=78701`
 
-8) Location: [geoip-location]
 
-9) Content: [geoip-content country="US"]Your content goes here[/geoip-content]
+Please note: full page redirects and TLD redirects still need to be implemented with the necessary API calls.
 
-== FAQ ==
+== Frequently Asked Questions ==
 
-1) Will this work outside of a WP Engine account?
+1) Will this work outside of the WP Engine hosting account?
 
-No, this will only work within a WP Engine environment.
+No, this will only work within the WP Engine environment. This will not work for sites hosted on other web hosts.
 
 2) Are there any other restrictions to using this plugin?
 
@@ -78,11 +140,11 @@ Continent, country, state, city, zip, latitude, longitude.
 
 4) How do I sign up for a WP Engine Account?:
 
-That’s easy! [Click here](http://wpengine.com/plans/?utm_source=wpengine-geoip).
+That’s easy! [Signup here](http://wpengine.com/plans/?utm_source=wpengine-geoip).
 
-5) I installed the plugin and code and it isn’t working.
+5) I installed the plugin and used a shortcode or API call and it isn’t working.
 
-Please contact the [Support Team](https://my.wpengine.com/support#general-issue).
+Please contact the WP Engine [Support Team](https://my.wpengine.com/support#general-issue).
 
 == Screenshots ==
 
@@ -97,7 +159,8 @@ Please contact the [Support Team](https://my.wpengine.com/support#general-issue)
 
 = 1.1.0 =
 - Adds continent shortcode
-- Adds content shortcode
+- Adds content shortcode for localized geographic content
+- Adds testing parameters to spoof visitor location
 - Bumps version number for WP 4.2.2 compatibility
 
 = 1.0.2 =