=== 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.4b1

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. 

** 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).

To use it as a widget, go to **Presentation** ->**Widgets**, add a **Text Widgets** and paste the code there.


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

== Frequently Asked Questions ==