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_Api2
 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:  * API2 User Admin Class
 29:  *
 30:  * @category   Mage
 31:  * @package    Mage_Api2
 32:  * @author     Magento Core Team <core@magentocommerce.com>
 33:  */
 34: class Mage_Api2_Model_Auth_User_Admin extends Mage_Api2_Model_Auth_User_Abstract
 35: {
 36:     /**
 37:      * User type
 38:      */
 39:     const USER_TYPE = 'admin';
 40: 
 41:     /**
 42:      * Retrieve user human-readable label
 43:      *
 44:      * @return string
 45:      */
 46:     public function getLabel()
 47:     {
 48:         return Mage::helper('api2')->__('Admin');
 49:     }
 50: 
 51:     /**
 52:      * Retrieve user role
 53:      *
 54:      * @return int
 55:      * @throws Exception
 56:      */
 57:     public function getRole()
 58:     {
 59:         if (!$this->_role) {
 60:             if (!$this->getUserId()) {
 61:                 throw new Exception('Admin identifier is not set');
 62:             }
 63: 
 64:             /** @var $collection Mage_Api2_Model_Resource_Acl_Global_Role_Collection */
 65:             $collection = Mage::getModel('api2/acl_global_role')->getCollection();
 66:             $collection->addFilterByAdminId($this->getUserId());
 67: 
 68:             /** @var $role Mage_Api2_Model_Acl_Global_Role */
 69:             $role = $collection->getFirstItem();
 70:             if (!$role->getId()) {
 71:                 throw new Exception('Admin role not found');
 72:             }
 73: 
 74:             $this->setRole($role->getId());
 75:         }
 76: 
 77:         return $this->_role;
 78:     }
 79: 
 80:     /**
 81:      * Retrieve user type
 82:      *
 83:      * @return string
 84:      */
 85:     public function getType()
 86:     {
 87:         return self::USER_TYPE;
 88:     }
 89: 
 90:     /**
 91:      * Set user role
 92:      *
 93:      * @param int $role
 94:      * @return Mage_Api2_Model_Auth_User_Admin
 95:      * @throws Exception
 96:      */
 97:     public function setRole($role)
 98:     {
 99:         if ($this->_role) {
100:             throw new Exception('Admin role has been already set');
101:         }
102:         $this->_role = $role;
103: 
104:         return $this;
105:     }
106: }
107: