=== WP GuestMap ===
Contributors: Jiang Kuan
Donate link: 
Tags: Widget, GuestMap, Google, Google Map, GeoIP, Weather, Stats, Sidebar, Statistics
Requires at least: 2.0.0
Tested up to: 2.3
Stable tag: 1.4b2

The plugin is Google Map widget builder, currently three major widgets are supported: Guest Locator, Stats Map and Weather Map. Now you can view your visitor's statistics via feed.


== Description ==

If you have some problems with it, please leave a comments [HERE](http://blog.codexpress.cn/php/wordpress-plugin-wp-guestmap/ "WP GuestMap Bug report")

The plugin is Google Map widget builder, currently three major widgets are supported:

* Guest Locator -- locate and display the current visitor on Google Map
* Stats Map -- collect visitors' geolocation and make clouds on Google Map
* Weather Map -- show weather forecast of specific location on Google Map

It generates HTML codes, so that you can easily copy and paste it to sidebar widget or posts/pages. (**To use it as a widget, go to **Presentation** ->**Widgets**, add a **Text Widgets** and paste the code there.**)

**Guest Locator**
The simplest widget. Just put a welcome message (plain text or HTML), and the widget will locates your visitors and welcome them. Macros like %country%, %country_code%, %city%, %latitude% and %longitude% are available.

**Stats Map**
This widget must be enabled to take effect. It loads little by little and finally displays all your visitors' location. *Output Pagesize* is maximum output count each step(you needn't change it generally). *Date of Birth* is very useful option, only visitor visiting after the birthday will be shown on Stats Map. *Authentic Key* is new. With it, you can subscribe statistics by RSS feed.

**Weather Map**
This widget shows a simple weather report on Google Maps. You need to get your Google AJAX Feed API Key(From Google) and the location id (from Yahoo! Weather).


If you wish to use another set of national flags in Guest Locator, please go to [this post](http://blog.codexpress.cn/wordpress/another-package-of-national-flags-for-wp-guestmap/ "WP GuestMap National Flags")

Upgrading & Other Infomation: please visit [http://blog.codexpress.cn/php/wordpress-plugin-wp-guestmap/](http://blog.codexpress.cn/php/wordpress-plugin-wp-guestmap/ "WP GuestMap Upgrade").

== Installation ==


1. Unzip the package and upload the folder **wp-guestmap** to **/wp-content/plugins/**.
1. Activate the plugin through the **Plugins** menu in WordPress.
1. Go to **WP GuestMap** on **Options** page, configurate your Google Maps API key and other settings in **Map Settings** section. *Save the settings* (the key must be valid, otherwise you cannot do further operations).
1. Adjust map options in **Map Builder** section (you can do that with the form or manipulate the map on the right directly)
1. Generate codes and paste them to where you need

**(All map widget requires Google Maps API URL)**



== Screenshots ==

1. Guest Locator
2. Stats Map
3. Weather Map
4. Visual feed for Stats Map on Google Maps

== Frequently Asked Questions ==