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

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


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. To use it as a widget, go to **Presentation** ->**Widgets**, add a **Text Widgets** and paste the code there.

**For more information, please visit [http://blog.codexpress.cn/php/wordpress-plugin-wp-guestmap/](http://blog.codexpress.cn/php/wordpress-plugin-wp-guestmap/ "WP GuestMap Installation")**



== Screenshots ==

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

== Frequently Asked Questions ==

1. The plugin doesn't work, what can I do?
First, make sure you are using the [latest version of WP-GuestMap](http://blog.codexpress.cn/php/wordpress-plugin-wp-guestmap/ "WP GuestMap Latest"). If it fails, please leave a comment [HERE](http://blog.codexpress.cn/php/wordpress-plugin-wp-guestmap/ "WP GuestMap Bug Report") with the URL of the widget, your WordPress version, and other plugins you've installed.

1. Why I cannot get the code in the option page?
First check whether you enabled javascript. If you do, check whether there are javascript errors when you loading the option page. The plugin itself will not cause a javascript error, but it is possible that some other plugin which inserts a wrong javascript in the option panel will affect this plugin. There is [Screenshot of the option panel](http://blog.codexpress.cn/php/wordpress-plugin-wp-guestmap/ "WP GuestMap Option Panel Screenshot"). If you can see a small map near the "Map Builder", it should work. :)

1. Why Stats Map does not load any icon?
If you are using a freehost that automatically appends some extra code to the page, Stats Map may not work properly, since AJAX based loader cannot parse those code. If Stats Map shows wrong data, please download the latest version.