=== WoWpi ===
Contributors: avenirer
Donate link: http://avenir.ro
Tags: World of Warcraft, wow, armory
Requires at least: 3.0.1
Tested up to: 4.5.2
Stable tag: 1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

The WoWpi plugin allows you to retrieve data from Battle.net API regarding your World of Warcraft character.

== Description ==

The plugin allows you to get your character data from Battle.net API service. The plugin uses caching of 12 hours, so you don't have to worry about reaching the quota established by the Battle.net. Also, it would be a great idea to queue the wowhead javascript that enables tooltips on hover (http://www.wowhead.com/tooltips).

== Installation ==

The WoWpi plugin allows you to get your character data from Battle.net API service.

1. Upload the plugin files to the `/wp-content/plugins/wowpi/` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the `Plugins` screen in WordPress.
3. Create an account on Battle.net API (https://dev.battle.net/member/register).
4. After creating an account on the Battle.net API website, you must add your website on the Applications tab (https://dev.battle.net/apps/myapps). Once created, the app will provide with a Key and a Secret.
5. On your WordPress, you must go to "Settings" > "WoWpi Settings" screen, and fill those in, including the Region and Locale, Realm, and Character Name.

**Use it inside themes as PHP function**

After you've set up the plugin, you can output the character data in your theme by using the wowpi_show_character() function:

`<?php
if (function_exists('wowpi_show_character')) {
 wowpi_show_character();
}
;?>`

The code above will output character name, profile picture, guild, main title, level, race and class.

For aditional information regarding the character, you must pass the function an array with the data you want retrieved:

- 'achievement_points' - will output the achievement points your character has;

- 'achievement_feed' - will output the achievement feed of your character;

- 'kills' - shows how many honorable kills your character did;

- 'professions' - enumerates the character's professions and their levels;

- 'gear' - outputs the gear that the character is having;

- 'talents' - shows the talents that the character has enabled.

For example, in order to get the talents and the gear of your character, you can insert the following php code:

`<?php
if (function_exists('wowpi_show_character')) {
 wowpi_show_character(array('talents','gear'));
}
;?>`

You can also insert another character, different than the main one (the one you've set up in the settings), by mentioning the character name as a second paramenter of the function:

`<?php
if (function_exists('wowpi_show_character')) {
 wowpi_show_character(array('kills','professions'),'Thonk');
}
;?>`

**Use it as a widget**

You can also use the plugin as a widget, by going to the Widgets inside your administration interface... I do not think this needs more explaining.

== Frequently Asked Questions ==

= Are there any bugs? =

I sure hope not, but this being my first plugin I can't guarantee for everything. Anyway, you can at any time write me at avenir.ro@gmail.com or use the forum to report any issues or ask for more things.

== Changelog ==

= 1.1 =
* [enhancement] added a new view wowpi_show_guild();
* [bug] removed “of the” when the character has no guild;
= 1.0 =
* The first commit