@@ -20,7 +20,7 @@ $sapi_type = substr(php_sapi_name(), 0, 3);
// Instantiate the class library
if ( $armory = new phpArmory5($areaName = $areaName) ) {
- $ach = $armory->getAchievementData($characterName, $characterRealmName);
+ $ach = $armory->getAchievementData($characterName, $characterRealmName, 'Dungeons & Raids');
if ($sapi_type == 'cli') {
var_dump ($ach);
} else {
examples/characterAchievements.php
@@ -544,30 +544,58 @@ class phpArmory5 {
}
- public function getAchievementData($characterName = NULL, $realmName = NULL) {
+ /**
+ * Provides information on all of a specific character's achievements.
+ * @access public
+ * @param string $characterName The character's name.
+ * @param string $realmName The character's realm name.
+ * @param int|string $category An achievement category ID or name.
+ * @return array $result Returns an array containing achievement data if $characterName and $realmName are valid, otherwise FALSE.
+ */
+ public function getAchievementData($characterName = NULL, $realmName = NULL, $category = NULL) {
if (is_string($characterName) && is_string($realmName)) {
- $characterName = ucfirst($characterName);
- $realmName = ucfirst($realmName);
-
- $armoryBaseURL = $this->armory."character-achievements.xml?r=".urlencode($realmName)."&n=".urlencode($characterName)."&c=";
+ if (is_string($category)) {
+ // Try to convert a category string into its integer ID
+ $category = strtolower($category);
+ $map = array(
+ 'general' => 92,
+ 'quests' => 96,
+ 'exploration' => 97,
+ 'player vs. player' => 95,
+ 'dungeons & raids' => 168,
+ 'professions' => 169,
+ 'reputation' => 201,
+ 'world events' => 155,
+ 'feats of strength' => 81
+ );
+ $category = ( isset($map[$category]) ) ? $map[$category] : NULL;
+ }
- $ach = $this->getCharacterPage($characterName, $realmName, 'achievements');
+ if (is_int($category)) {
+ $characterName = ucfirst($characterName);
+ $realmName = ucfirst($realmName);
+ $armoryBaseURL = $this->armory."character-achievements.xml?r=".urlencode($realmName)."&n=".urlencode($characterName)."&c=";
- if (isset($ach['achievements']['rootcategories'])) {
- $retval = array();
+ $tempXML = $this->getXmlData($armoryBaseURL . $category);
+ if (is_array($tempXML) && array_key_exists('XmlData', $tempXML)) {
+ return $this->convertXmlToArray($tempXML['XmlData']);
+ }
+ } else {
+ $ach = $this->getCharacterPage($characterName, $realmName, 'achievements');
+
+ if (isset($ach['achievements']['rootcategories'])) {
+ $retval = array();
- foreach ($ach['achievements']['rootcategories'] as $cats) {
- foreach ($cats as $cat) {
- if (isset($cat['id'])) {
- $tempXML = $this->getXmlData($armoryBaseURL . $cat['id']);
- if (is_array($tempXML) && array_key_exists('XmlData', $tempXML)) {
- $retval[$cat['name']] = $this->convertXmlToArray($tempXML['XmlData']);
+ foreach ($ach['achievements']['rootcategories'] as $cats) {
+ foreach ($cats as $cat) {
+ if (isset($cat['id'])) {
+ $retval[$cat['name']] = $this->getAchievementData($characterName, $realmName, $cat['id']);
}
}
}
- }
- return $retval;
+ return $retval;
+ }
}
}
phpArmory.class.php
22d1256f5c61ed965ba612f3f92370bfaaaa9805
rspeicher
rspeicher@gmail.com
http://github.com/marenkay/phparmory/commit/bb854dc88c6e5fc3de39a1a20a2b967afbb7ca9d
bb854dc88c6e5fc3de39a1a20a2b967afbb7ca9d
2009-02-23T14:10:33-08:00
2009-01-20T12:31:34-08:00
Allow for fetching one specific achievement category, either by name or by its ID
Signed-off-by: Daniel S. Reichenbach <daniel.s.reichenbach@mac.com>
5018b60833fb47542618ad3a3d9553b3636b6c2a
Daniel S. Reichenbach
daniel.s.reichenbach@mac.com