1: <?php
  2: /**
  3:  * Magento
  4:  *
  5:  * NOTICE OF LICENSE
  6:  *
  7:  * This source file is subject to the Open Software License (OSL 3.0)
  8:  * that is bundled with this package in the file LICENSE.txt.
  9:  * It is also available through the world-wide-web at this URL:
 10:  * http://opensource.org/licenses/osl-3.0.php
 11:  * If you did not receive a copy of the license and are unable to
 12:  * obtain it through the world-wide-web, please send an email
 13:  * to license@magentocommerce.com so we can send you a copy immediately.
 14:  *
 15:  * DISCLAIMER
 16:  *
 17:  * Do not edit or add to this file if you wish to upgrade Magento to newer
 18:  * versions in the future. If you wish to customize Magento for your
 19:  * needs please refer to http://www.magentocommerce.com for more information.
 20:  *
 21:  * @category    Mage
 22:  * @package     Mage_Catalog
 23:  * @copyright   Copyright (c) 2012 Magento Inc. (http://www.magentocommerce.com)
 24:  * @license     http://opensource.org/licenses/osl-3.0.php  Open Software License (OSL 3.0)
 25:  */
 26: 
 27: /**
 28:  * Catalog category api
 29:  *
 30:  * @category   Mage
 31:  * @package    Mage_Catalog
 32:  * @author     Magento Core Team <core@magentocommerce.com>
 33:  */
 34: class Mage_Catalog_Model_Category_Api_V2 extends Mage_Catalog_Model_Category_Api
 35: {
 36:     /**
 37:      * Retrieve category data
 38:      *
 39:      * @param int $categoryId
 40:      * @param string|int $store
 41:      * @param array $attributes
 42:      * @return array
 43:      */
 44:     public function info($categoryId, $store = null, $attributes = null)
 45:     {
 46:         $category = $this->_initCategory($categoryId, $store);
 47: 
 48:         // Basic category data
 49:         $result = array();
 50:         $result['category_id'] = $category->getId();
 51: 
 52:         $result['is_active']   = $category->getIsActive();
 53:         $result['position']    = $category->getPosition();
 54:         $result['level']       = $category->getLevel();
 55: 
 56:         foreach ($category->getAttributes() as $attribute) {
 57:             if ($this->_isAllowedAttribute($attribute, $attributes)) {
 58:                 $result[$attribute->getAttributeCode()] = $category->getDataUsingMethod($attribute->getAttributeCode());
 59:             }
 60:         }
 61:         $result['parent_id']   = $category->getParentId();
 62:         $result['children']           = $category->getChildren();
 63:         $result['all_children']       = $category->getAllChildren();
 64: 
 65:         return $result;
 66:     }
 67: 
 68:     /**
 69:      * Create new category
 70:      *
 71:      * @param int $parentId
 72:      * @param array $categoryData
 73:      * @return int
 74:      */
 75:     public function create($parentId, $categoryData, $store = null)
 76:     {
 77:         $parent_category = $this->_initCategory($parentId, $store);
 78: 
 79:         /* @var $category Mage_Catalog_Model_Category */
 80:         $category = Mage::getModel('catalog/category')
 81:             ->setStoreId($this->_getStoreId($store));
 82: 
 83:         $category->addData(array('path'=>implode('/',$parent_category->getPathIds())));
 84: 
 85:         $category ->setAttributeSetId($category->getDefaultAttributeSetId());
 86: 
 87: 
 88:         foreach ($category->getAttributes() as $attribute) {
 89:             $_attrCode = $attribute->getAttributeCode();
 90:             if ($this->_isAllowedAttribute($attribute)
 91:                 && isset($categoryData->$_attrCode)) {
 92:                 $category->setData(
 93:                     $attribute->getAttributeCode(),
 94:                     $categoryData->$_attrCode
 95:                 );
 96:             }
 97:         }
 98:         $category->setParentId($parent_category->getId());
 99:         try {
100:             $validate = $category->validate();
101:             if ($validate !== true) {
102:                 foreach ($validate as $code => $error) {
103:                     if ($error === true) {
104:                         Mage::throwException(Mage::helper('catalog')->__('Attribute "%s" is required.', $code));
105:                     }
106:                     else {
107:                         Mage::throwException($error);
108:                     }
109:                 }
110:             }
111: 
112:             $category->save();
113:         }
114:         catch (Mage_Core_Exception $e) {
115:             $this->_fault('data_invalid', $e->getMessage());
116:         }
117: 
118:         return $category->getId();
119:     }
120: 
121:     /**
122:      * Update category data
123:      *
124:      * @param int $categoryId
125:      * @param array $categoryData
126:      * @param string|int $store
127:      * @return boolean
128:      */
129:     public function update($categoryId, $categoryData, $store = null)
130:     {
131:         $category = $this->_initCategory($categoryId, $store);
132: 
133:         foreach ($category->getAttributes() as $attribute) {
134:             $_attrCode = $attribute->getAttributeCode();
135:             if ($this->_isAllowedAttribute($attribute)
136:                 && isset($categoryData->$_attrCode)) {
137:                 $category->setData(
138:                     $attribute->getAttributeCode(),
139:                     $categoryData->$_attrCode
140:                 );
141:             }
142:         }
143: 
144:         try {
145:             $validate = $category->validate();
146:             if ($validate !== true) {
147:                 foreach ($validate as $code => $error) {
148:                     if ($error === true) {
149:                         Mage::throwException(Mage::helper('catalog')->__('Attribute "%s" is required.', $code));
150:                     }
151:                     else {
152:                         Mage::throwException($error);
153:                     }
154:                 }
155:             }
156:             $category->save();
157:         } catch (Mage_Core_Exception $e) {
158:             $this->_fault('data_invalid', $e->getMessage());
159:         } catch (Mage_Eav_Model_Entity_Attribute_Exception $e) {
160:             $this->_fault('data_invalid', $e->getMessage());
161:         }
162: 
163:         return true;
164:     }
165: }
166: