{"id":14320,"date":"2011-08-04T22:40:13","date_gmt":"2011-08-04T22:40:13","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/wow-armory-character\/"},"modified":"2014-11-18T15:08:55","modified_gmt":"2014-11-18T15:08:55","slug":"wow-armory-character","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/wow-armory-character\/","author":6466430,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.1","stable_tag":"1.1.1","tested":"4.0.38","requires":"3.5.0","requires_php":"","requires_plugins":"","header_name":"WoW Armory Character","header_author":"Adam Cooper","header_description":"","assets_banners_color":"b54906","last_updated":"2014-11-18 15:08:55","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"http:\/\/realmenweardress.es\/wow-armory-character\/","header_author_uri":"http:\/\/realmenweardress.es","rating":0,"author_block_rating":0,"active_installs":10,"downloads":8345,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"0.9.7":"<p>Your activity feed can now be shown - complete with icons - just like your armory page. Please resave your\nwidget settings afterwards to ensure they work.<\/p>","0.9.6":"<p>This update makes changes to how the talents are displayed due to the changes to talents in 5.0.4<\/p>","0.9.5":"<p>Profession information can now be show as a number of badges and new global settings have been introduced\nto help with theming.<\/p>","0.9.4":"<p>You can now show your characters achievements. For easier theming you can now specify your own\ntemplate file to render the profile.<\/p>","0.9.3":"<p>Prior to this version the plugin was non-functional on anything less then PHP 5.3. If your running 5.2\nthen it should now work.<\/p>","0.9.1":"<p>Numerous bug fixes plus the addition of support for the KR and TW regions.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":"1028001","resolution":"1544x500","location":"assets"},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":"1028001","resolution":"772x250","location":"assets"}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.9","0.9.1","0.9.2","0.9.3","0.9.4","0.9.5","0.9.6","1.0.0","1.1.0","1.1.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1020320","resolution":"1","location":"assets"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"1020320","resolution":"2","location":"assets"}},"screenshots":{"1":"The default widget output","2":"The widget configuration screen."}},"plugin_section":[],"plugin_tags":[881,20237,162,874,12873],"plugin_category":[43],"plugin_contributors":[87456],"plugin_business_model":[],"class_list":["post-14320","plugin","type-plugin","status-closed","hentry","plugin_tags-armory","plugin_tags-character","plugin_tags-widget","plugin_tags-world-of-warcraft","plugin_tags-wow","plugin_category-customization","plugin_contributors-blueajcooper","plugin_committers-blueajcooper"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/wow-armory-character_b54906.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/wow-armory-character\/assets\/screenshot-1.png?rev=1020320","caption":"The default widget output"},{"src":"https:\/\/ps.w.org\/wow-armory-character\/assets\/screenshot-2.png?rev=1020320","caption":"The widget configuration screen."}],"raw_content":"<!--section=description-->\n<p>This plugin displays World of Warcraft character profiles pulled from data made available by the WoW community API.\nIt allows you to view a basic profile that shows your character information and picture. It can be easily configured to \nshow the gear that you are wearing (with optional links to <a href=\"http:\/\/wowhead.com\">wowhead<\/a>), your talents, professions,\nactivity feed and recent achievements.<\/p>\n\n<p>To see a customised example of the plugin in action <a href=\"http:\/\/realmenweardress.es\/about\/\">check it out on my wordpress blog<\/a>.\nFor an example of the plugin configured to show all the available information check out the screenshots tab.<\/p>\n\n<h4>Known Issues<\/h4>\n\n<ul>\n<li>When showing characters with Chinese or Korean locales the wowhead tooltips will show in english. I'm actively \nseeking a solution.<\/li>\n<li>The widget configuration will keep reseting your language choice to English. When making changes be sure to first\nre-choose your region and then choose your language if you do not wish english to be selected.<\/li>\n<li>Multiple Armory widgets on one page will cause issue with the administration pages javascript. For the time being I\nrecommend using shortcodes if you need more then one character displayed on a page.<\/li>\n<\/ul>\n\n<h3>Translation<\/h3>\n\n<p>The plugin is fully setup to use the excellent internationalisation features of wordpress. However, since I sadly do not\nspeak any of the languages I'd like to support (those used by World of Warcraft itself) I am not able to provide the\ntranslations I need. If you are interested in providing any translations for this project please contact me.<\/p>\n\n<h3>With Thanks<\/h3>\n\n<p>Many thanks to seifertim and his effort <a href=\"http:\/\/wordpress.org\/extend\/plugins\/wow-armory\/\">WoW Armory<\/a> for providing the\ninspiration (and base upon which to work).<\/p>\n\n<h3>Development Version<\/h3>\n\n<p>The development version, as well as all the tagged releases of this project, are hosted on \n<a href=\"https:\/\/github.com\/cooperaj\/wow-armory-character\">github.com<\/a> and merely pushed to \nthe Wordpress plugin repository for distribution purposes.<\/p>\n\n<p>Should you need to use the development version (perhaps to fix a bug, or test a feature) please \ndownload it from the <a href=\"https:\/\/github.com\/cooperaj\/wow-armory-character\/zipball\/master\">github website<\/a>.<\/p>\n\n<p>I also maintain a more  comprehensive issue\/bug list at github so if you have anything to report it would \nbe very helpful if you could post the problem there.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload 'wow-armory-character' to the <code>\/wp-content\/plugins\/<\/code> directory<\/li>\n<li>Ensure your webserver has write permissions to the <code>\/wp-content\/plugins\/wow-armory-character\/cache<\/code> directory<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<li>Configure a widget and add it to your site or use the <code>[armory-character]<\/code> shortcode.<\/li>\n<\/ol>\n\n<h4>Shortcode Use<\/h4>\n\n<p>The shortcode can be added to any page or post and can be configured in an identical fashion to the\nwidget. At a minimum you will need to specify the realm and character name for it to work - though this will assume\nthat you wish to show all the details of character from the EU region in English.<\/p>\n\n<pre><code>[armory-character realm=\"Terokkar\" name=\"Grokknar\"]\n<\/code><\/pre>\n\n<p>The configuration parameters available to use are:<\/p>\n\n<ul>\n<li><strong>region<\/strong> - <em>EU<\/em>, <em>US<\/em>, <em>KO<\/em> and <em>TW<\/em> currently supported<\/li>\n<li><strong>show_portrait<\/strong> - <em>1<\/em> or <em>0<\/em><\/li>\n<li><strong>show_title<\/strong> - <em>1<\/em> or <em>0<\/em><\/li>\n<li><strong>show_talents<\/strong> - <em>1<\/em> or <em>0<\/em><\/li>\n<li><strong>show_items<\/strong> - <em>1<\/em> or <em>0<\/em><\/li>\n<li><strong>show_profs<\/strong> - This is a bitwise field. To get the setting you want add together the numbers below.\n\n<ul>\n<li><em>1<\/em> - Show profession badges<\/li>\n<li><em>2<\/em> - Show secondary professions<\/li>\n<\/ul><\/li>\n<li><strong>show_achievs<\/strong> - This is a bitwise field. To get the setting you want add together the numbers below.\n\n<ul>\n<li><em>1<\/em> - Show achievement bar<\/li>\n<li><em>2<\/em> - Show achievement list<\/li>\n<li><em>4<\/em> - Show descriptions on the achievement list.<\/li>\n<\/ul><\/li>\n<li><strong>show_feed<\/strong> - This is a bitwise field. To get the setting you want add together the numbers below.\n\n<ul>\n<li><em>1<\/em> - Show items (loot).<\/li>\n<li><em>2<\/em> - Show acheivements gained.<\/li>\n<li><em>4<\/em> - Show acheivement criteria.<\/li>\n<li><em>8<\/em> - Show icons next to each item.<\/li>\n<\/ul><\/li>\n<li><strong>locale<\/strong> - <em>en_GB<\/em>, <em>en_US<\/em>, <em>de_DE<\/em>, <em>es_ES<\/em>, <em>es_MX<\/em>, <em>fr_FR<\/em>, <em>it_IT<\/em>, <em>ru_RU<\/em>, <em>ko_KR<\/em>, <em>zh_TW<\/em> or <em>zh_CN<\/em><\/li>\n<\/ul>\n\n<p>Note: Certain locale choices are only available when selecting some regions.<\/p>\n\n<h4>Available Filters<\/h4>\n\n<p>For more capable\/adventurous developers there are a number of hooks that allow you to change the way the\nplugin functions without altering its code. This means you get to upgrade in the future without worrying\nabout breaking any changes you may have made.<\/p>\n\n<p><strong>wow-armory-character-template<\/strong><br \/>\nAllows you to specify an alternate template file to use to display your profile. Defaults to <code>view-wow-armory-character.php<\/code><\/p>\n\n<pre><code>function my_function_name($file_path) {\n  \/\/ e.g. return realpath(__FILE__) . '\/view-wow-armory-character.php'\n  return \"THE_PATH_TO_YOUR_TEMPLATE_FILE\";\n}\nadd_filter('wow-armory-character-template','my_function_name');\n<\/code><\/pre>\n\n<p><strong>wow-armory-character-display<\/strong><br \/>\nYour profile once the template has been processed. It may be quicker to alter the display at runtime rather \nthan duplicate the template when making only minor changes. As well as the output that will be displayed \nthe Character data as retireved from the Community API is also passed. This should allow you to make any changes\nyou need.<\/p>\n\n<pre><code>function my_function_name($output, $character_data) {\n  \/\/ Do something to the $output, perhaps using the $character_data\n  return $output;\n}\nadd_filter('wow-armory-character-display','my_function_name');\n<\/code><\/pre>\n\n<p><strong>wow-armory-character-css<\/strong>\nAllows you to specify an alternate stylesheet. This is the replacement for the tickbox provided in the administration\nscreen. You should now consider that option as deprecated and it will be removed in a future release.\nThe rationale behind this is that if you're overriding the css completely you will have access to your theme to be able\nto add this hook.<\/p>\n\n<pre><code>function my_function_name($file_path) {\n  \/\/ e.g. return realpath(__FILE__) . '\/wowcss.css'\n  return \"THE_PATH_TO_YOUR_CSS_FILE\";\n}\nadd_filter('wow-armory-character-css','my_function_name');\n<\/code><\/pre>\n\n<!--section=faq-->\n<dl>\n<dt>The plugin is displaying old information. How do I update it?<\/dt>\n<dd><p>The plugin will cache the characters it retrieves from the community API for 12 hours. This ensures that \nyour website will make no more then 2 requests per character in any 24 hour period. In order to force your character\ndisplay to update you are able to clear the cache.<\/p>\n\n<ol>\n<li>Navigate to the <em>Armory Character<\/em> section within the <em>Settings<\/em> area of your wordpress admin area.<\/li>\n<li>Tick the checkbox next to the character you wish to refresh and click the <em>Clear selected cache items<\/em> button.<\/li>\n<\/ol>\n\n<p>When you next look at your character fresh information will be pulled from the community API. It may be that the \ncommunity API is returning old information, in this case you will need to wait until your armory page is updated.<\/p><\/dd>\n<dt>How do I change the styling of the character display<\/dt>\n<dd><p>There are two ways you can do this. You can use a pure CSS based approach or alter the html output using either of\nthe two display filters that have been made available.<\/p>\n\n<p>To use the filters please create the necessary function (perhaps in your template.php file) and alter the html as\nyou see fit. You can either alter the html after it has been created or you can override the template that produces\nthe output.<\/p>\n\n<p>The CSS can be overridden by using the global setting 'Add plugin css to the page'. Unticking this box will allow\nyou to provide your own CSS as part of your theme. <em>NOTE<\/em> This option is now deprecated. It will be replaced in a future\nrelease by the filter documented in the installation tab. For simple edits I suggest you add the necessary tweaks to\nyour themes CSS and keep the basic styling the plugin provides.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.1<\/h4>\n\n<ul>\n<li>Updated the wowhead tooltips to work with the new way of handling item ID's.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Allow the clearing of all the cached items. Possible fix for the issue with acheivements reported by SilverCha0s<\/li>\n<li>Include Italian language configuration options.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Starting at the big 1.0. Is stable enough for that I reckon.<\/li>\n<li>Tooltip updates to show item upgrades\/reforges.<\/li>\n<li>Reworked achievements to calculate based on API - not using a hardcoded value.<\/li>\n<li>Fixed a large number of bugs<\/li>\n<li>Styling tweaks to work better in Twenty Fourteen<\/li>\n<li>The activity feed for your character can now be shown. This is just like the one from your armory page and shows\nthe last 5 items, achievements and achievement criteria you gained. PLEASE NOTE: If you're upgrading to this release\nyour widgets may give errors until their settings are adjusted.<\/li>\n<li>Realms are now chosen from a dropdown list rather then typed. This should help where the slug varies from the\nrealm name.<\/li>\n<li><em>DEPRECATED<\/em> setting for css inclusion. A filter is now available for theme authors.<\/li>\n<li>Moved to grunt for building.<\/li>\n<li>New banner!<\/li>\n<\/ul>\n\n<h4>0.9.6<\/h4>\n\n<ul>\n<li>Update for patch 5.0.4 talent changes.<\/li>\n<li>Achievement count update<\/li>\n<li>Include Portugese language configuration options.<\/li>\n<\/ul>\n\n<h4>0.9.5<\/h4>\n\n<ul>\n<li>New global settings introduced. Including the ability to disable the built in stylesheet and wowhead integration.<\/li>\n<li>Professions now show.<\/li>\n<li>Shoulder slot items now show correctly. Thanks to xsherbearx for reporting the issue.<\/li>\n<li>Numerous other bug fixes and code cleanups.<\/li>\n<\/ul>\n\n<h4>0.9.4<\/h4>\n\n<ul>\n<li>Achievements are now available to be shown.<\/li>\n<li>New filter added to allow you to change the template file location.<\/li>\n<\/ul>\n\n<h4>0.9.3<\/h4>\n\n<ul>\n<li>Fixed usages of <strong>DIR<\/strong> which is PHP5.3 only. The plugin should now work on PHP5.2+ Thanks to @Flavio_Torelli\nfor reporting the issue.<\/li>\n<\/ul>\n\n<h4>0.9.2<\/h4>\n\n<ul>\n<li>Retagging since I messed it up. Give us a break it's my first plugin :)<\/li>\n<\/ul>\n\n<h4>0.9.1<\/h4>\n\n<ul>\n<li>Changed file address from <strong>FILE<\/strong> since it does not work well with symlinks<\/li>\n<li>Enforced correct language choices per region<\/li>\n<li>Fixed realms with spaces in their names<\/li>\n<li>Fixed some images not working in a non-english locale<\/li>\n<li>Added KR and TW regions<\/li>\n<\/ul>\n\n<h4>0.9<\/h4>\n\n<ul>\n<li>The initial release of the plugin.<\/li>\n<\/ul>","raw_excerpt":"Pulls character information from the WoW community API and displays it.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/14320","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=14320"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/blueajcooper"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=14320"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=14320"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=14320"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=14320"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=14320"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=14320"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}