summaryrefslogtreecommitdiff
path: root/lib/prado/framework/Web/UI/WebControls/TReCaptcha2Validator.php
blob: 2cd4b6d12bb9bc1f95ae5d0ad46b000e7c53db9a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
<?php

/**
 * TReCaptcha2Validator class file
 *
 * @author Cristian Camilo Naranjo Valencia
 * @link http://icolectiva.co
 * @copyright Copyright &copy; 2005-2016 The PRADO Group
 * @license https://github.com/pradosoft/prado/blob/master/COPYRIGHT
 * @package System.Web.UI.WebControls
 */

Prado::using('System.Web.UI.WebControls.TBaseValidator');
Prado::using('System.Web.UI.WebControls.TReCaptcha2');

/**
 * TReCaptcha2Validator class
 *
 * TReCaptcha2Validator validates a reCAPTCHA represented by a {@link TReCaptcha} control.
 * The input control fails validation if th user did not pass the humanity test.
 *
 * To use TReCaptcha2Validator, specify the {@link setCaptchaControl CaptchaControl}
 * to be the ID path of the {@link TReCaptcha} control.
 *
 * @author Cristian Camilo Naranjo Valencia
 * @package System.Web.UI.WebControls
 * @since 3.3.1
 */

class TReCaptcha2Validator extends TBaseValidator
{
    protected $_isvalid = null;

    protected function getClientClassName()
    {
        return 'Prado.WebUI.TReCaptcha2Validator';
    }
    public function getEnableClientScript()
    {
        return true;
    }
    protected function getCaptchaControl()
    {
        $control = $this->getValidationTarget();
        if (!$control)
            throw new Exception('No target control specified for TReCaptcha2Validator');
        if (!($control instanceof TReCaptcha2))
            throw new Exception('TReCaptcha2Validator only works with TReCaptcha2 controls');
        return $control;
    }
    public function getClientScriptOptions()
    {
        $options = parent::getClientScriptOptions();
        $options['ResponseFieldName'] = $this->getCaptchaControl()->getResponseFieldName();
        return $options;
    }
    /**
     * This method overrides the parent's implementation.
     * The validation succeeds if the input control has the same value
     * as the one displayed in the corresponding RECAPTCHA control.
     *
     * @return boolean whether the validation succeeds
     */
    protected function evaluateIsValid()
    {
        // check validity only once (if trying to evaulate multiple times, all redundant checks would fail)
        if (is_null($this->_isvalid))
        {
            $control = $this->getCaptchaControl();
            $this->_isvalid = $control->validate();
        }
        return ($this->_isvalid==true);
    }
    public function onPreRender($param)
    {
        parent::onPreRender($param);

        $cs = $this->Page->getClientScript();
        $cs->registerPradoScript('validator');

        // communicate validation status to the client side
        $value = $this->_isvalid===false ? '0' : '1';
        $cs->registerHiddenField($this->getClientID().'_1',$value);

        // update validator display
        if ($control = $this->getValidationTarget())
        {
            $fn = 'captchaUpdateValidatorStatus_'.$this->getClientID();

            $cs->registerEndScript($this->getClientID().'::validate', implode(' ',array(
                // this function will be used to update the validator
                'function '.$fn.'(valid)',
                '{',
                '  jQuery('.TJavaScript::quoteString('#'.$this->getClientID().'_1').').val(valid);',
                '  Prado.Validation.validateControl('.TJavaScript::quoteString($control->ClientID).'); ',
                '}',
                '',
                // update the validator to the result if we're in a callback 
                // (if we're in initial rendering or a postback then the result will be rendered directly to the page html anyway)
                $this->Page->IsCallback ? $fn.'('.$value.');' : '',
                '',
                // install event handler that clears the validation error when user changes the captcha response field
                'jQuery("#'.$control->getClientID().'").on("change", '.TJavaScript::quoteString('#'.$control->getResponseFieldName()).', function() { ',
                    $fn.'("1");',
                '});',
            )));
        }
    }
}