As you can see the plugin will now tell you if your hosting servers’ PHP installation is capable of pulling data from the armory, and will show a pleasant status message on the options page. Other notable changes include the removal of the cache options. Why? We have WordPress, thus we have a database. What for would you want a file cache? Plus file caching comes with the need to set file permissions to allow your hosting server storing cache files. Potential security risks shall be avoided.

Nothing else to see. If you run WordPress in debug mode, you will notice the armory plugin also has one. Be warned, the armory plugin will parse all (did I say all? Thats 30k items) and cache their data and tooltips in your WordPress database. This will take some time. Most likely ten to fifteen minutes.

My local item cache now contains 23222 (valid aka. real) items and is taking 17.8MB of disk space. Of course, all data saved as serialised XML data in MySQL.

As pictures speak louder than words here is a screenshot of the current option panel for the armory plugin in WordPress.

Currently you can choose which armory you want to fetch data from. This – for now – is restricted to the US armory and the EU armory, with a few languages supported (English, German, French, and Spanish). Additionally you can choose if you want to allow armory links inside post, pages, and comments. E.g. you could allow links only in your own content, but not in user created comments.

Finally, there is working support for caching armory data in XML files. These will be saved into a folder inside the armory plugin. I plan to extend this to support your WordPress database, but this needs a few additional lines of PHP code.

Speaking of PHP, I have decided to base my plugin on an existing PHP class library named phpArmory. Library development sadly has slowed down in the last few months but I managed to fix all features that did not work, so the library now is fully aware of any locale the armory supports, and can fetch characters, guilds, and items without any errors. Caching with file and database backends has been tested and works. Cheers for me. I will upload the fixed phpArmory class once I have this plugin displaying tooltips on this site.

Expect more details and a 0.1 release within the next few hours.

When Blizzard Entertainment released the World of Warcraft armory in March 2007, the player base quickly separated into one half being angry and the other half being pretty much exited. You either have to love it, or hate it. With my blog back to life, I decided to join the forces of the armory lovers.

While preparing a few articles I noticed that I have quite a few mentions of items and characters in my posts, and what could be nicer than making these items and characters visible for my readers without requiring them to browse to another website? Sure, it is not a must have thing, but it is a convenience which adds a bit to the overall feeling. So I decided to start [developing a plugin](http://codex.wordpress.org/Writing_a_Plugin] for the recently released WordPress 2.5 which I use to create my blog.

Before jumping into my favourite text editor it seemed like a good plan to blog about the plugin, in order to describe what I want it to do, and how it should work. Having a plan is a Good Thing™ as many may remember from software engineering courses.

What do we need?

Quite a few features seem to be obvious when you look at what data the armory presents.

• item links: the ability to edit our posts, pages, and comments and turning item names into nice item tooltips, just like they look when you mouse over an item in the game client.
• character links: in the game client, you can SHIFT-click on any character name you read in chat, and the game client will print the basic character data like name, race, class, level, and current zone. It would be nice, to sign posts or comments with the character name and have a tooltip display the basic character values.

What would be nice to have?

Above these, there are some other features which smell like being worth the effort to implement them.

• full integration with WordPress 2.5+: WordPress 2.5 – “Brecker” comes with a lot of revamped administrative features and AJAX support. I’d love to have the plugin make use of that. This includes AJAX for pulling of item and character data from the armory and dynamically adding the tooltips where possible, and also includes making use of the new Shortcode API.
• caching of character and item data: yes, we all know it. Both the game realms and the armory have maintenance schedules and thus downtimes. Since it would suck to have no tooltips, the plugin should cache all data it has received from the armory. This has two benefits: it saves bandwidth for items we already have seen, and in case the armory is down, we still can have sexy tooltips.

What we do not want to miss?

I am used to care a lot about features, but much less about usability when it comes to toying with fun stuff, thus a little reminder to me follows.

• automatic installation and removal of the plugin: everything should be free of work for the user. The plugin should install itself without requiring user interaction, and it should remove itself without requiring interaction, plus it should clean up before it leaves the house.
• sane defaults: there are actually only a few options for such a plugin where a user might want to make a choice. There is the US armory, and the EU armory. The armory is available only in a few locales, not in all locales you can have your WordPress configured for, and the user might want to decide if he wants a file based cache, or if he would like to use the already existing WordPress database.

Did I miss any feature or requirement? Nothing comes to my mind yet, but if you have any suggestion add a comment and get to talk with me.

What next?

I have already built a basic framework for the plugin which is active and running in this blog. As you might notice once you open this sites HTML source, there are already a few lines added by the plugin for the AJAX tooltips, and a small style sheet for the visual look of these tooltips.

<link rel="stylesheet" href="http://www.marenkay.com/wp-content/themes/marenkay.com/style.css" type="text/css" media="screen" />
<script type="text/javascript" src="http://www.marenkay.com/wp-content/plugins/wow-armory/js/overlib.js"></script>

Currently the plugin can pull data for characters and items from the armory, but it yet lacks a display function. I am still working on the configuration screen, as I do not want this plugin to require you editing PHP files. According to the WordPress developer documentation, this would suck anyway.

Expect an initial release on Saturday. I hope some people will volunteer for testing.