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_Centinel
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:  * Centinel validation frame
29:  */
30: class Mage_Centinel_Block_Authentication extends Mage_Core_Block_Template
31: {
32:     /**
33:      * Strage for identifiers of related blocks
34:      *
35:      * @var array
36:      */
37:     protected $_relatedBlocks = array();
38: 
39:     /**
40:      * Flag - authentication start mode
41:      * @see self::setAuthenticationStartMode
42:      *
43:      * @var bool
44:      */
45:     protected $_authenticationStartMode = false;
46: 
47:     /**
48:      * Add identifier of related block
49:      *
50:      * @param string $blockId
51:      * @return Mage_Centinel_Block_Authentication
52:      */
53:     public function addRelatedBlock($blockId)
54:     {
55:         $this->_relatedBlocks[] = $blockId;
56:         return $this;
57:     }
58: 
59:     /**
60:      * Return identifiers of related blocks
61:      *
62:      * @return array
63:      */
64:     public function getRelatedBlocks()
65:     {
66:         return $this->_relatedBlocks;
67:     }
68: 
69:     /**
70:      * Check whether authentication is required and prepare some template data
71:      *
72:      * @return string
73:      */
74:     protected function _toHtml()
75:     {
76:         $method = Mage::getSingleton('checkout/session')->getQuote()->getPayment()->getMethodInstance();
77:         if ($method->getIsCentinelValidationEnabled()) {
78:             $centinel = $method->getCentinelValidator();
79:             if ($centinel && $centinel->shouldAuthenticate()) {
80:                 $this->setAuthenticationStart(true);
81:                 $this->setFrameUrl($centinel->getAuthenticationStartUrl());
82:                 return parent::_toHtml();
83:             }
84:         }
85:         return parent::_toHtml();
86:     }
87: }
88: