tag
* @param string $layout
* @param bool $trackSubmit (optional) Whether to track if the form was
* submitted by adding a special hidden field (default = true)
*/
public function __construct(
$name,
$method = 'post',
$action = '',
$target = '',
$attributes = [],
$layout = self::LAYOUT_HORIZONTAL,
$trackSubmit = true
) {
// Default form class.
if (is_array($attributes) && !isset($attributes['class']) || empty($attributes)) {
$attributes['class'] = 'form-horizontal';
}
if (isset($attributes['class']) && strpos($attributes['class'], 'form-search') !== false) {
$layout = 'inline';
}
$this->setLayout($layout);
switch ($layout) {
case self::LAYOUT_HORIZONTAL:
$attributes['class'] = 'form-horizontal';
break;
case self::LAYOUT_INLINE:
case self::LAYOUT_BOX:
$attributes['class'] = 'form-inline';
break;
}
parent::__construct($name, $method, $action, $target, $attributes, $trackSubmit);
// Modify the default templates
$renderer = &$this->defaultRenderer();
// Form template
$formTemplate = $this->getFormTemplate();
$renderer->setFormTemplate($formTemplate);
// Element template
if (isset($attributes['class']) && $attributes['class'] == 'form-inline') {
$elementTemplate = ' {label} {element} ';
$renderer->setElementTemplate($elementTemplate);
} elseif (isset($attributes['class']) && $attributes['class'] == 'form-search') {
$elementTemplate = ' {label} {element} ';
$renderer->setElementTemplate($elementTemplate);
} else {
$renderer->setElementTemplate($this->getDefaultElementTemplate());
// Display a gray div in the buttons
$templateSimple = '
{label} {element}
';
$renderer->setElementTemplate($templateSimple, 'submit_in_actions');
//Display a gray div in the buttons + makes the button available when scrolling
$templateBottom = '
{label} {element}
';
$renderer->setElementTemplate($templateBottom, 'submit_fixed_in_bottom');
//When you want to group buttons use something like this
/* $group = array();
$group[] = $form->createElement('button', 'mark_all', get_lang('MarkAll'));
$group[] = $form->createElement('button', 'unmark_all', get_lang('UnmarkAll'));
$form->addGroup($group, 'buttons_in_action');
*/
$renderer->setElementTemplate($templateSimple, 'buttons_in_action');
$templateSimpleRight = '
EOT;
$renderer->setRequiredNoteTemplate($noteTemplate);
}
/**
* @return string
*/
public function getFormTemplate()
{
return '';
}
/**
* @todo this function should be added in the element class
*
* @return string
*/
public function getDefaultElementTemplate()
{
return '
{icon}
{element}
{label_2}
{error}
{label_3}
';
}
/**
* @return string
*/
public function getLayout()
{
return $this->layout;
}
/**
* @param string $layout
*/
public function setLayout($layout)
{
$this->layout = $layout;
}
/**
* Adds a text field to the form.
* A trim-filter is attached to the field.
*
* @param string|array $label The label for the form-element
* @param string $name The element name
* @param bool $required (optional) Is the form-element required (default=true)
* @param array $attributes (optional) List of attributes for the form-element
*
* @return HTML_QuickForm_text
*/
public function addText($name, $label, $required = true, $attributes = [], $createElement = false)
{
if ($createElement) {
$element = $this->createElement('text', $name, $label, $attributes);
} else {
$element = $this->addElement('text', $name, $label, $attributes);
}
$this->applyFilter($name, 'trim');
if ($required) {
$this->addRule($name, get_lang('ThisFieldIsRequired'), 'required');
}
return $element;
}
/**
* Add hidden course params.
*/
public function addCourseHiddenParams()
{
$this->addHidden('cidReq', api_get_course_id());
$this->addHidden('id_session', api_get_session_id());
}
/**
* The "date_range_picker" element creates 2 hidden fields
* "elementName" + "_start" and "elementName" + "_end"
* For example if the name is "range", you will have 2 new fields
* when executing $form->getSubmitValues()
* "range_start" and "range_end".
*
* @param string $name
* @param string $label
* @param bool $required
* @param array $attributes
*/
public function addDateRangePicker($name, $label, $required = true, $attributes = [])
{
$this->addElement('date_range_picker', $name, $label, $attributes);
$this->addElement('hidden', $name.'_start');
$this->addElement('hidden', $name.'_end');
if ($required) {
$this->addRule($name, get_lang('ThisFieldIsRequired'), 'required');
}
}
/**
* @param string $name
* @param string $label
* @param array $attributes
*
* @return mixed
*/
public function addDatePicker($name, $label, $attributes = [])
{
return $this->addElement('DatePicker', $name, $label, $attributes);
}
/**
* @param string $name
* @param string $label
* @param array $attributes
*
* @return mixed
*/
public function addSelectLanguage($name, $label, $options = [], $attributes = [])
{
return $this->addElement('SelectLanguage', $name, $label, $options, $attributes);
}
/**
* @param string $name
* @param string $label
* @param array $options
* @param array $attributes
*
* @throws
*/
public function addSelectAjax($name, $label, $options = [], $attributes = [])
{
if (!isset($attributes['url'])) {
throw new \Exception('select_ajax needs an URL');
}
$this->addElement(
'select_ajax',
$name,
$label,
$options,
$attributes
);
}
/**
* @param string $name
* @param string|array $label
* @param array $attributes
*
* @return DateTimePicker
*/
public function addDateTimePicker($name, $label, $attributes = [])
{
return $this->addElement('DateTimePicker', $name, $label, $attributes);
}
/**
* @param string $name
* @param string|array $label
* @param array $attributes
*
* @return DateTimeRangePicker
*/
public function addDateTimeRangePicker($name, $label, $attributes = [])
{
return $this->addElement('DateTimeRangePicker', $name, $label, $attributes);
}
/**
* @param string $name
* @param string $value
* @param array $attributes
*/
public function addHidden($name, $value, $attributes = [])
{
$this->addElement('hidden', $name, $value, $attributes);
}
/**
* @param string $name
* @param string|array $label
* @param array $attributes
* @param bool $required
*
* @return HTML_QuickForm_textarea
*/
public function addTextarea($name, $label, $attributes = [], $required = false)
{
$element = $this->addElement('textarea', $name, $label, $attributes);
if ($required) {
$this->addRule($name, get_lang('ThisFieldIsRequired'), 'required');
}
return $element;
}
/**
* @param string $name
* @param string $label
* @param string $icon font-awesome
* @param string $style default|primary|success|info|warning|danger|link
* @param string $size large|default|small|extra-small
* @param string $class Example plus is transformed to icon fa fa-plus
* @param array $attributes
* @param bool $createElement
*
* @return HTML_QuickForm_button
*/
public function addButton(
$name,
$label,
$icon = 'check',
$style = 'default',
$size = 'default',
$class = null,
$attributes = [],
$createElement = false
) {
if ($createElement) {
return $this->createElement(
'button',
$name,
$label,
$icon,
$style,
$size,
$class,
$attributes
);
}
return $this->addElement(
'button',
$name,
$label,
$icon,
$style,
$size,
$class,
$attributes
);
}
/**
* Returns a button with the primary color and a check mark.
*
* @param string $label Text appearing on the button
* @param string $name Element name (for form treatment purposes)
* @param bool $createElement Whether to use the create or add method
*
* @return HTML_QuickForm_button
*/
public function addButtonSave($label, $name = 'submit', $createElement = false)
{
return $this->addButton(
$name,
$label,
'check',
'primary',
null,
null,
[],
$createElement
);
}
/**
* Returns a cancel button.
*
* @param string $label Text appearing on the button
* @param string $name Element name (for form treatment purposes)
* @param bool $createElement Whether to use the create or add method
*
* @return HTML_QuickForm_button
*/
public function addButtonCancel($label, $name = 'submit', $createElement = false)
{
return $this->addButton(
$name,
$label,
'times',
'danger',
null,
null,
[],
$createElement
);
}
/**
* Returns a button with the primary color and a "plus" icon.
*
* @param string $label Text appearing on the button
* @param string $name Element name (for form treatment purposes)
* @param bool $createElement Whether to use the create or add method
* @param array $attributes Additional attributes
*
* @return HTML_QuickForm_button
*/
public function addButtonCreate($label, $name = 'submit', $createElement = false, $attributes = [])
{
return $this->addButton(
$name,
$label,
'plus',
'primary',
null,
null,
$attributes,
$createElement
);
}
/**
* Returns a button with the primary color and a pencil icon.
*
* @param string $label Text appearing on the button
* @param string $name Element name (for form treatment purposes)
* @param bool $createElement Whether to use the create or add method
*
* @return HTML_QuickForm_button
*/
public function addButtonUpdate($label, $name = 'submit', $createElement = false)
{
return $this->addButton(
$name,
$label,
'pencil',
'primary',
null,
null,
[],
$createElement
);
}
/**
* Returns a button with the danger color and a trash icon.
*
* @param string $label Text appearing on the button
* @param string $name Element name (for form treatment purposes)
* @param bool $createElement Whether to use the create or add method
*
* @return HTML_QuickForm_button
*/
public function addButtonDelete($label, $name = 'submit', $createElement = false)
{
return $this->addButton(
$name,
$label,
'trash',
'danger',
null,
null,
[],
$createElement
);
}
/**
* Returns a move style button.
*
* @param string $label Text appearing on the button
* @param string $name Element name (for form treatment purposes)
* @param bool $createElement Whether to use the create or add method
*
* @return HTML_QuickForm_button
*/
public function addButtonMove($label, $name = 'submit', $createElement = false)
{
return $this->addButton(
$name,
$label,
'arrow-circle-right',
'primary',
null,
null,
[],
$createElement
);
}
/**
* Returns a button with the primary color and a paper-plane icon.
*
* @param string $label Text appearing on the button
* @param string $name Element name (for form treatment purposes)
* @param bool $createElement Whether to use the create or add method
* @param array $attributes
*
* @return HTML_QuickForm_button
*/
public function addButtonSend($label, $name = 'submit', $createElement = false, $attributes = [])
{
return $this->addButton(
$name,
$label,
'paper-plane',
'primary',
null,
null,
$attributes,
$createElement
);
}
/**
* Returns a button with the default (grey?) color and a magnifier icon.
*
* @param string $label Text appearing on the button
* @param string $name Element name (for form treatment purposes)
*
* @return HTML_QuickForm_button
*/
public function addButtonSearch($label = null, $name = 'submit')
{
if (empty($label)) {
$label = get_lang('Search');
}
return $this->addButton($name, $label, 'search', 'default');
}
/**
* Returns a button with the primary color and a right-pointing arrow icon.
*
* @param string $label Text appearing on the button
* @param string $name Element name (for form treatment purposes)
* @param array $attributes Additional attributes
*
* @return HTML_QuickForm_button
*/
public function addButtonNext($label, $name = 'submit', $attributes = [])
{
return $this->addButton(
$name,
$label,
'arrow-right',
'primary',
null,
null,
$attributes
);
}
/**
* Returns a button with the primary color and a check mark icon.
*
* @param string $label Text appearing on the button
* @param string $name Element name (for form treatment purposes)
* @param bool $createElement Whether to use the create or add method
*
* @return HTML_QuickForm_button
*/
public function addButtonImport($label, $name = 'submit', $createElement = false)
{
return $this->addButton(
$name,
$label,
'check',
'primary',
null,
null,
[],
$createElement
);
}
/**
* Returns a button with the primary color and a check-mark icon.
*
* @param string $label Text appearing on the button
* @param string $name Element name (for form treatment purposes)
* @param bool $createElement Whether to use the create or add method
*
* @return HTML_QuickForm_button
*/
public function addButtonExport($label, $name = 'submit', $createElement = false)
{
return $this->addButton(
$name,
$label,
'check',
'primary',
null,
null,
[],
$createElement
);
}
/**
* Shortcut to filter button.
*
* @param string $label Text appearing on the button
* @param string $name Element name (for form treatment purposes)
* @param bool $createElement Whether to use the create or add method
*
* @return HTML_QuickForm_button
*/
public function addButtonFilter($label, $name = 'submit', $createElement = false)
{
return $this->addButton(
$name,
$label,
'filter',
'primary',
null,
null,
[],
$createElement
);
}
/**
* Shortcut to reset button.
*
* @param string $label Text appearing on the button
* @param string $name Element name (for form treatment purposes)
* @param bool $createElement Whether to use the create or add method
*
* @return HTML_QuickForm_button
*/
public function addButtonReset($label, $name = 'reset', $createElement = false)
{
$icon = 'eraser';
$style = 'default';
$size = 'default';
$class = null;
$attributes = [];
if ($createElement) {
return $this->createElement(
'reset',
$name,
$label,
$icon,
$style,
$size,
$class,
$attributes
);
}
return $this->addElement(
'reset',
$name,
$label,
$icon,
$style,
$size,
$class,
$attributes
);
}
/**
* Returns a button with the primary color and an upload icon.
*
* @param string $label Text appearing on the button
* @param string $name Element name (for form treatment purposes)
* @param bool $createElement Whether to use the create or add method
*
* @return HTML_QuickForm_button
*/
public function addButtonUpload($label, $name = 'submit', $createElement = false)
{
return $this->addButton(
$name,
$label,
'upload',
'primary',
null,
null,
[],
$createElement
);
}
/**
* Returns a button with the primary color and a download icon.
*
* @param string $label Text appearing on the button
* @param string $name Element name (for form treatment purposes)
* @param bool $createElement Whether to use the create or add method
*
* @return HTML_QuickForm_button
*/
public function addButtonDownload($label, $name = 'submit', $createElement = false)
{
return $this->addButton(
$name,
$label,
'download',
'primary',
null,
null,
[],
$createElement
);
}
/**
* Returns a button with the primary color and a magnifier icon.
*
* @param string $label Text appearing on the button
* @param string $name Element name (for form treatment purposes)
* @param bool $createElement Whether to use the create or add method
*
* @return HTML_QuickForm_button
*/
public function addButtonPreview($label, $name = 'submit', $createElement = false)
{
return $this->addButton(
$name,
$label,
'search',
'primary',
null,
null,
[],
$createElement
);
}
/**
* Returns a button with the primary color and a copy (double sheet) icon.
*
* @param string $label Text appearing on the button
* @param string $name Element name (for form treatment purposes)
* @param bool $createElement Whether to use the create or add method
*
* @return HTML_QuickForm_button
*/
public function addButtonCopy($label, $name = 'submit', $createElement = false)
{
return $this->addButton(
$name,
$label,
'copy',
'primary',
null,
null,
[],
$createElement
);
}
/**
* @param string $name
* @param string $label
* @param string $text
* @param array $attributes
*
* @return HTML_QuickForm_checkbox
*/
public function addCheckBox($name, $label, $text = '', $attributes = [])
{
return $this->addElement('checkbox', $name, $label, $text, $attributes);
}
/**
* @param string $name
* @param string $label
* @param array $options
* @param array $attributes
*
* @return HTML_QuickForm_group
*/
public function addCheckBoxGroup($name, $label, $options = [], $attributes = [])
{
$group = [];
foreach ($options as $value => $text) {
$attributes['value'] = $value;
$group[] = $this->createElement(
'checkbox',
$value,
null,
$text,
$attributes
);
}
return $this->addGroup($group, $name, $label);
}
/**
* @param string $name
* @param string $label
* @param array $options
* @param array $attributes
*
* @return HTML_QuickForm_group
*/
public function addRadio($name, $label, $options = [], $attributes = [])
{
$group = [];
foreach ($options as $key => $value) {
$group[] = $this->createElement('radio', null, null, $value, $key, $attributes);
}
return $this->addGroup($group, $name, $label);
}
/**
* @param string $name
* @param string $label
* @param array $options
* @param array $attributes
*
* @return HTML_QuickForm_select
*/
public function addSelect($name, $label, $options = [], $attributes = [])
{
return $this->addElement('select', $name, $label, $options, $attributes);
}
/**
* @param $name
* @param $label
* @param $collection
* @param array $attributes
* @param bool $addNoneOption
* @param string $textCallable set a function getStringValue() by default __toString()
*
* @return HTML_QuickForm_element
*/
public function addSelectFromCollection(
$name,
$label,
$collection,
$attributes = [],
$addNoneOption = false,
$textCallable = ''
) {
$options = [];
if ($addNoneOption) {
$options[0] = get_lang('None');
}
if (!empty($collection)) {
foreach ($collection as $item) {
$text = $item;
if (!empty($textCallable)) {
$text = $item->$textCallable();
}
$options[$item->getId()] = $text;
}
}
return $this->addElement('select', $name, $label, $options, $attributes);
}
/**
* @param string $label
* @param string $text
* @param bool $createElement
*
* @return HTML_QuickForm_Element
*/
public function addLabel($label, $text, $createElement = false)
{
if ($createElement) {
return $this->createElement(
'label',
$label,
$text
);
}
return $this->addElement('label', $label, $text);
}
/**
* @param string $text
*/
public function addHeader($text)
{
if (!empty($text)) {
$this->addElement('header', $text);
}
}
/**
* @param string $name
* @param string $label
* @param array $attributes
*
* @throws Exception if the file doesn't have an id
*
* @return HTML_QuickForm_file
*/
public function addFile($name, $label, $attributes = [])
{
$element = $this->addElement('file', $name, $label, $attributes);
if (isset($attributes['crop_image'])) {
$id = $element->getAttribute('id');
if (empty($id)) {
throw new Exception('If you use the crop functionality the element must have an id');
}
$this->addHtml(
'
'
);
$this->addHidden($id.'_crop_result', '');
$this->addHidden($id.'_crop_image_base_64', '');
}
return $element;
}
/**
* @param string $snippet
*/
public function addHtml($snippet)
{
$this->addElement('html', $snippet);
}
/**
* Draws a panel of options see the course_info/infocours.php page.
*
* @param string $name internal name
* @param string $title visible title
* @param array $groupList list of group or elements
*/
public function addPanelOption($name, $title, $groupList)
{
$this->addHtml('
');
foreach ($groupList as $groupName => $group) {
// Add group array
if (!empty($groupName) && is_array($group)) {
$this->addGroup($group, '', $groupName);
}
// Add element
if ($group instanceof HTML_QuickForm_element) {
$this->addElement($group);
}
}
$this->addHtml('
');
$this->addHtml('
');
}
/**
* Adds a HTML-editor to the form.
*
* @param string $name
* @param string|array $label The label for the form-element
* @param bool $required (optional) Is the form-element required (default=true)
* @param bool $fullPage (optional) When it is true, the editor loads completed html code for a full page
* @param array $config (optional) Configuration settings for the online editor
*/
public function addHtmlEditor(
$name,
$label,
$required = true,
$fullPage = false,
$config = []
) {
$attributes = [];
$attributes['rows'] = isset($config['rows']) ? $config['rows'] : 15;
$attributes['cols'] = isset($config['cols']) ? $config['cols'] : 80;
$attributes['cols-size'] = isset($config['cols-size']) ? $config['cols-size'] : [];
$attributes['class'] = isset($config['class']) ? $config['class'] : [];
$this->addElement('html_editor', $name, $label, $attributes, $config);
$this->applyFilter($name, 'trim');
if ($required) {
$this->addRule($name, get_lang('ThisFieldIsRequired'), 'required');
}
/** @var HtmlEditor $element */
$element = $this->getElement($name);
$config['style'] = isset($config['style']) ? $config['style'] : false;
if ($fullPage) {
$config['fullPage'] = true;
// Adds editor_content.css in ckEditor
$config['style'] = true;
}
if ($element->editor) {
$element->editor->processConfig($config);
}
}
/**
* Adds a Google Maps Geolocalization field to the form.
*
* @param $name
* @param $label
* @param bool $hideGeoLocalizationDetails
*/
public function addGeoLocationMapField($name, $label, $dataValue, $hideGeoLocalizationDetails = false)
{
$gMapsPlugin = GoogleMapsPlugin::create();
$geolocalization = $gMapsPlugin->get('enable_api') === 'true';
if ($geolocalization && $gMapsPlugin->javascriptIncluded === false) {
$gmapsApiKey = $gMapsPlugin->get('api_key');
$url = '//maps.googleapis.com/maps/api/js?key='.$gmapsApiKey;
$this->addHtml('');
$gMapsPlugin->javascriptIncluded = true;
}
$this->addElement(
'text',
$name,
$label,
['id' => $name]
);
$this->addHidden(
$name.'_coordinates',
'',
['id' => $name.'_coordinates']
);
$this->applyFilter($name, 'stripslashes');
$this->applyFilter($name, 'trim');
$this->addHtml(Extrafield::getLocalizationJavascript($name, $dataValue));
if ($hideGeoLocalizationDetails) {
$this->addHtml('
');
}
$this->addHtml(
Extrafield::getLocalizationInput($name, $label)
);
if ($hideGeoLocalizationDetails) {
$this->addHtml('
');
}
}
/**
* @param string $name
* @param string $label
*
* @return mixed
*/
public function addButtonAdvancedSettings($name, $label = '')
{
$label = !empty($label) ? $label : get_lang('AdvancedParameters');
return $this->addElement('advanced_settings', $name, $label);
}
/**
* Adds a progress loading image to the form.
*/
public function addProgress($delay = 2, $label = '')
{
if (empty($label)) {
$label = get_lang('PleaseStandBy');
}
$this->with_progress_bar = true;
$id = $this->getAttribute('id');
$this->updateAttributes("onsubmit=\"javascript: addProgress('".$id."')\"");
$this->addHtml('');
}
/**
* This function has been created for avoiding changes directly within QuickForm class.
* When we use it, the element is threated as 'required' to be dealt during validation.
*
* @param array $elements The array of elements
* @param string $message The message displayed
*/
public function add_multiple_required_rule($elements, $message)
{
$this->_required[] = $elements[0];
$this->addRule($elements, $message, 'multiple_required');
}
/**
* Displays the form.
* If an element in the form didn't validate, an error message is showed
* asking the user to complete the form.
*/
public function display()
{
echo $this->returnForm();
}
/**
* Returns the HTML code of the form.
*
* @return string $return_value HTML code of the form
*/
public function returnForm()
{
$returnValue = '';
/** @var HTML_QuickForm_element $element */
foreach ($this->_elements as $element) {
$elementError = parent::getElementError($element->getName());
if (!is_null($elementError)) {
$returnValue .= Display::return_message($elementError, 'warning').' ';
break;
}
}
$returnValue .= parent::toHtml();
// Add div-element which is to hold the progress bar
$id = $this->getAttribute('id');
if (isset($this->with_progress_bar) && $this->with_progress_bar) {
// Deprecated
// $icon = Display::return_icon('progress_bar.gif');
// @todo improve UI
$returnValue .= '
';
}
return $returnValue;
}
/**
* Returns the HTML code of the form.
* If an element in the form didn't validate, an error message is showed
* asking the user to complete the form.
*
* @return string $return_value HTML code of the form
*
* @author Patrick Cool , Ghent University, august 2006
* @author Julio Montoya
*
* @deprecated use returnForm()
*/
public function return_form()
{
return $this->returnForm();
}
/**
* @return HTML_QuickForm_Renderer_Default
*/
public static function getDefaultRenderer()
{
return
isset($GLOBALS['_HTML_QuickForm_default_renderer']) ?
$GLOBALS['_HTML_QuickForm_default_renderer'] : null;
}
/**
* Adds a input of type url to the form.
*
* @param string $name The label for the form-element
* @param string $label The element name
* @param bool $required Optional. Is the form-element required (default=true)
* @param array $attributes Optional. List of attributes for the form-element
*/
public function addUrl($name, $label, $required = true, $attributes = [])
{
$this->addElement('url', $name, $label, $attributes);
$this->applyFilter($name, 'trim');
$this->addRule($name, get_lang('InsertAValidUrl'), 'url');
if ($required) {
$this->addRule($name, get_lang('ThisFieldIsRequired'), 'required');
}
}
/**
* Adds a text field for letters to the form.
* A trim-filter is attached to the field.
*
* @param string $name The element name
* @param string $label The label for the form-element
* @param bool $required Optional. Is the form-element required (default=true)
* @param array $attributes Optional. List of attributes for the form-element
*/
public function addTextLettersOnly(
$name,
$label,
$required = false,
$attributes = []
) {
$attributes = array_merge(
$attributes,
[
'pattern' => '[a-zA-ZñÑ]+',
'title' => get_lang('OnlyLetters'),
]
);
$this->addElement(
'text',
$name,
[
$label,
get_lang('OnlyLetters'),
],
$attributes
);
$this->applyFilter($name, 'trim');
if ($required) {
$this->addRule($name, get_lang('ThisFieldIsRequired'), 'required');
}
$this->addRule(
$name,
get_lang('OnlyLetters'),
'regex',
'/^[a-zA-ZñÑ]+$/'
);
}
/**
* Adds a text field for alphanumeric characters to the form.
* A trim-filter is attached to the field.
*
* @param string $name The element name
* @param string $label The label for the form-element
* @param bool $required Optional. Is the form-element required (default=true)
* @param array $attributes Optional. List of attributes for the form-element
*/
public function addTextAlphanumeric(
$name,
$label,
$required = false,
$attributes = []
) {
$attributes = array_merge(
$attributes,
[
'pattern' => '[a-zA-Z0-9ñÑ]+',
'title' => get_lang('OnlyLettersAndNumbers'),
]
);
$this->addElement(
'text',
$name,
[
$label,
get_lang('OnlyLettersAndNumbers'),
],
$attributes
);
$this->applyFilter($name, 'trim');
if ($required) {
$this->addRule($name, get_lang('ThisFieldIsRequired'), 'required');
}
$this->addRule(
$name,
get_lang('OnlyLettersAndNumbers'),
'regex',
'/^[a-zA-Z0-9ÑÑ]+$/'
);
}
/**
* @param string $name
* @param $label
* @param bool $required
* @param array $attributes
* @param bool $allowNegative
* @param int $minValue
* @param null $maxValue
*/
public function addFloat(
$name,
$label,
$required = false,
$attributes = [],
$allowNegative = false,
$minValue = null,
$maxValue = null
) {
$this->addElement(
'FloatNumber',
$name,
$label,
$attributes
);
$this->applyFilter($name, 'trim');
if ($required) {
$this->addRule($name, get_lang('ThisFieldIsRequired'), 'required');
}
// Rule allows "," and "."
/*$this->addRule(
$name,
get_lang('OnlyNumbers'),
'regex',
'/(^-?\d\d*\.\d*$)|(^-?\d\d*$)|(^-?\.\d\d*$)|(^-?\d\d*\,\d*$)|(^-?\,\d\d*$)/'
);*/
if ($allowNegative == false) {
$this->addRule(
$name,
get_lang('NegativeValue'),
'compare',
'>=',
'server',
false,
false,
0
);
}
if (!is_null($minValue)) {
$this->addRule(
$name,
get_lang('UnderMin'),
'compare',
'>=',
'server',
false,
false,
$minValue
);
}
if (!is_null($maxValue)) {
$this->addRule(
$name,
get_lang('OverMax'),
'compare',
'<=',
'server',
false,
false,
$maxValue
);
}
}
/**
* Adds a text field for letters and spaces to the form.
* A trim-filter is attached to the field.
*
* @param string $name The element name
* @param string $label The label for the form-element
* @param bool $required Optional. Is the form-element required (default=true)
* @param array $attributes Optional. List of attributes for the form-element
*/
public function addTextLettersAndSpaces(
$name,
$label,
$required = false,
$attributes = []
) {
$attributes = array_merge(
$attributes,
[
'pattern' => '[a-zA-ZñÑ\s]+',
'title' => get_lang('OnlyLettersAndSpaces'),
]
);
$this->addElement(
'text',
$name,
[
$label,
get_lang('OnlyLettersAndSpaces'),
],
$attributes
);
$this->applyFilter($name, 'trim');
if ($required) {
$this->addRule($name, get_lang('ThisFieldIsRequired'), 'required');
}
$this->addRule(
$name,
get_lang('OnlyLettersAndSpaces'),
'regex',
'/^[a-zA-ZñÑ\s]+$/'
);
}
/**
* Adds a text field for alphanumeric and spaces characters to the form.
* A trim-filter is attached to the field.
*
* @param string $name The element name
* @param string $label The label for the form-element
* @param bool $required Optional. Is the form-element required (default=true)
* @param array $attributes Optional. List of attributes for the form-element
*/
public function addTextAlphanumericAndSpaces(
$name,
$label,
$required = false,
$attributes = []
) {
$attributes = array_merge(
$attributes,
[
'pattern' => '[a-zA-Z0-9ñÑ\s]+',
'title' => get_lang('OnlyLettersAndNumbersAndSpaces'),
]
);
$this->addElement(
'text',
$name,
[
$label,
get_lang('OnlyLettersAndNumbersAndSpaces'),
],
$attributes
);
$this->applyFilter($name, 'trim');
if ($required) {
$this->addRule($name, get_lang('ThisFieldIsRequired'), 'required');
}
$this->addRule(
$name,
get_lang('OnlyLettersAndNumbersAndSpaces'),
'regex',
'/^[a-zA-Z0-9ñÑ\s]+$/'
);
}
/**
* @param string $url
* @param string $urlToRedirect after upload redirect to this page
*/
public function addMultipleUpload($url, $urlToRedirect = '')
{
$inputName = 'input_file_upload';
$this->addMultipleUploadJavascript($url, $inputName, $urlToRedirect);
$this->addHtml('