=== WoW Guild Retrieve ===
Contributors: manatrance
Tags: WoW,warcraft,guild
Requires at least: 2.7
Tested up to: 2.9.1
Stable tag: 1.0.3

Show a roster of your World of Warcraft guild's members on any page.

== Description ==

I was building a website for a World of Warcraft guild on the Wordpress platform. I needed to display a roster
of all the guild's members. Rather than have the guild leader manually enter new members in a unique database, 
I decided to create a plugin to handle the display of a roster automatically using WoW Armory data.

WoW Guild Retrieve asks for a realm name and guild name. Because it's a shortcode, you can have multiple guild lists
even on the same page!

To use the plugin in any page or post, just include the following text in that page:

[wgr guildname="" realmname=""]

Between the quotes, add the appropriate names, like so:

[wgr guildname="My Guild Name" realmname="My Realm Name"]

It defaults to US servers. For EU servers, just add this:

[wgr guildname="My Guild Name" realmname="My Realm Name" region="eu"]

But wait, there's more!

If you'd like to change the sorting, just use the following options:

sorttype - this changes the default column which the plugin sorts by. May be a number between 0 and 4.
sortorder - this changes the order in which the plugin sorts. May be either "asc" or "desc".

Also, there is this option:

restrict - if set to true, this will restrict the guild list to only level 80 players.

The last option:

tablesize - if set, this changes the default number of rows displayed.

An example of a shortcode that uses all of the options is here:

[wgr guildname="My Guild" realmname="My Realm" region="eu" sorttype="1" sortorder="desc" restrict="true" tablesize="25"]

Also, you can change the names of the ranks displayed. Right now you need to go into the wow-guild.php file, go to line 146 (near the bottom), and change the rank names to suit your guild. An easier method is planned for the next release. To add new rank names, copy two lines starting with } elseif … and ending with $rank = … and paste them before the line that starts } else {, then change as above, making sure to increase the number in the elseif statement.

At this time, custom names are universal, so if you have multiple guild rosters on one website they will all have the same rank names.

If you have any questions, don't hesitate to drop by the plugin website here:

http://www.manatrance.com/wow-guild-retrieve

== Changelog ==

= v1.0.3 =

* Added custom rank names
* Added ability to change the default number of rows displayed

= v1.0.1 =

* Fixed a bug that displayed "Guild Leader" as "Rank 0"
* Fixed a bug that displayed incorrect or broken images

= v1.0.0 =

* Rebuilt the plugin to use shortcodes
* Now supports multiple guild lists
* Upgraded dataTables jQuery plugin to v1.6 from v1.4 beta 7

= v0.9.7 =

* Fixed bug in options that was preventing data display

= v0.9.6 =

* Added option to choose default sorting
* Added ability to restrict the roster to only level 80 players

= v0.9.5 =

* Added option to choose a light or dark styling
* Fixed a couple CSS bugs

= v0.9.4 =

* Fixed a bug with the WoW Armory lookup

= v0.9.3 =

* Added images and new styling.
* Added new div-based structure to aid in CSS styling.
* Fixed a bug with the CSS and javascript.

== Installation ==

1. Upload the contents of the zip to the '/wp-content/plugins/wow-guild-retrieve' directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Enter get\_guild\_info into any page or post you want to display the roster table.

== Frequently Asked Questions ==

= Is this plugin finished? =

No plugin is ever truly finished.

= Can I sort these columns? =

Yes! Just click on the column headers.

= Can I style the table with my own CSS? =

Of course. The id for the containing div is guild-data-div, and the markup is all XHTML 1.0 Strict compatible.

== Screenshots ==

1. A shot of the plugin in action