moodle/moodle
3
0
Fork 0
mirror of https://github.com/moodle/moodle.git synced 2025-08-05 17:06:53 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

MDL-30974 form: Checked and updated docblock for form library

Browse source
This commit is contained in:
Rajesh Taneja 2012-01-06 16:38:06 +08:00 • committed by Rajesh Taneja
parent 5fc420e2ed
commit 6c1fd30484
39 changed files with 2567 additions and 1156 deletions
Download patch file Download diff file Expand all files Collapse all files

74
lib/form/recaptcha.php
View file

@ -1,37 +1,57 @@
<?php
require_once('HTML/QuickForm/input.php');
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
/**
* textarea_counter.php
* recaptcha type form element
*
* @category Admin
* @package admin
* @author Nicolas Connault <nicolasconnault@gmail.com>
* Contains HTML class for a recaptcha type element
*
* @package core_form
* @copyright 2008 Nicolas Connault <nicolasconnault@gmail.com>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
require_once('HTML/QuickForm/input.php');
/**
* @category Admin
* @package admin
* recaptcha type form element
*
* HTML class for a recaptcha type element
*
* @package core_form
* @category form
* @copyright 2008 Nicolas Connault <nicolasconnault@gmail.com>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class MoodleQuickForm_recaptcha extends HTML_QuickForm_input {
/**
* html for help button, if empty then no help
*
* @var string
*/
/** @var string html for help button, if empty then no help */
var $_helpbutton='';
/** @var bool if true, recaptcha will be servered from https */
var $_https=false;
/**
* <code>
* $form->addElement('textarea_counter', 'message', 'Message',
* array('cols'=>60, 'rows'=>10), 160);
* </code>
* constructor
*
* @param string $elementName (optional) name of the recaptcha element
* @param string $elementLabel (optional) label for recaptcha element
* @param mixed $attributes (optional) Either a typical HTML attribute string
* or an associative array
*/
function MoodleQuickForm_recaptcha($elementName = null, $elementLabel = null, $attributes = null) {
global $CFG;
@ -47,9 +67,7 @@ class MoodleQuickForm_recaptcha extends HTML_QuickForm_input {
/**
* Returns the recaptcha element in HTML
*
* @since 1.0
* @access public
* @return string
* @return string
*/
function toHtml() {
global $CFG, $PAGE;
@ -95,9 +113,11 @@ class MoodleQuickForm_recaptcha extends HTML_QuickForm_input {
/**
* set html for help button
*
* @access public
* @param array $help array of arguments to make a help button
* @param array $helpbuttonargs array of arguments to make a help button
* @param string $function function name to call to get html
* @deprecated since Moodle 2.0. Please do not call this function any more.
* @todo MDL-31047 this api will be removed.
* @see MoodleQuickForm::setHelpButton()
*/
function setHelpButton($helpbuttonargs, $function='helpbutton'){
debugging('component setHelpButton() is not used any more, please use $mform->setHelpButton() instead');
@ -106,13 +126,19 @@ class MoodleQuickForm_recaptcha extends HTML_QuickForm_input {
/**
* get html for help button
*
* @access public
* @return string html for help button
* @return string html for help button
*/
function getHelpButton(){
return $this->_helpbutton;
}
/**
* Checks input and challenged field
*
* @param string $challenge_field recaptcha shown to user
* @param string $response_field input value by user
* @return bool
*/
function verify($challenge_field, $response_field) {
global $CFG;
require_once $CFG->libdir . '/recaptchalib.php';