LDAPAccountManager/lam/lib/html.inc

2183 lines
61 KiB
PHP
Raw Normal View History

2010-05-23 10:35:33 +00:00
<?php
/*
$Id$
This code is part of LDAP Account Manager (http://www.ldap-account-manager.org/)
Copyright (C) 2010 - 2011 Roland Gruber
2010-05-23 10:35:33 +00:00
This program 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 2 of the License, or
(at your option) any later version.
This program 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 this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
/**
* Interface between modules and other parts of LAM.
*
2010-06-06 18:15:35 +00:00
* @package metaHTML
2010-05-23 10:35:33 +00:00
* @author Roland Gruber
*/
/**
* Represents a HTML element.
* This is used to build HTML code by using objects.
*
2010-06-06 18:15:35 +00:00
* @package metaHTML
2010-05-23 10:35:33 +00:00
*/
2010-06-13 12:34:52 +00:00
abstract class htmlElement {
const OPTION_ALIGN = 0;
2010-06-06 18:15:35 +00:00
const ALIGN_TOP = 0;
const ALIGN_LEFT = 1;
const ALIGN_RIGHT = 2;
const ALIGN_BOTTOM = 3;
2010-09-29 16:47:08 +00:00
const ALIGN_CENTER = 4;
2010-06-13 12:34:52 +00:00
2010-08-02 19:23:39 +00:00
/** alignment when inside a table */
2010-06-13 12:34:52 +00:00
public $alignment = null;
2010-08-02 19:23:39 +00:00
/** colspan if inside a table */
public $colspan = null;
/** rowspan if inside a table */
public $rowspan = null;
2010-05-23 10:35:33 +00:00
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
2010-06-13 12:34:52 +00:00
abstract function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope);
2010-08-02 19:23:39 +00:00
/**
* Returns the HTML attributes for the alignment.
*
* @return String alignment HTML attributes (e.g. align="right" valign="top")
*/
public function getAlignmentString() {
$align = '';
if ($this->alignment !== null) {
switch ($this->alignment) {
case htmlElement::ALIGN_BOTTOM:
$align = 'valign="bottom"';
break;
case htmlElement::ALIGN_TOP:
$align = 'valign="top"';
break;
case htmlElement::ALIGN_LEFT:
$align = 'align="left"';
break;
case htmlElement::ALIGN_RIGHT:
$align = 'align="right"';
break;
2010-09-29 16:47:08 +00:00
case htmlElement::ALIGN_CENTER:
$align = 'align="center"';
break;
2010-08-02 19:23:39 +00:00
}
}
return $align;
}
/**
* Returns the HTML attribute for the colspan.
*
* @return String colspan HTML attribute (e.g. colspan=3)
*/
public function getColspanString() {
if ($this->colspan == null) {
return '';
}
else return 'colspan="' . $this->colspan . '"';
}
/**
* Returns the HTML attribute for the rowspan.
*
* @return String rowspan HTML attribute (e.g. rowspan=3)
*/
public function getRowspanString() {
if ($this->rowspan == null) {
return '';
}
else return 'rowspan="' . $this->rowspan . '"';
}
2010-05-23 10:35:33 +00:00
}
2010-06-06 18:15:35 +00:00
/**
* Structures elements using a table.
*
* @package metaHTML
*/
2010-06-13 12:34:52 +00:00
class htmlTable extends htmlElement {
2010-06-06 18:15:35 +00:00
/** table footer */
2010-06-21 16:23:44 +00:00
const footer = "</table>\n";
2010-06-12 19:38:26 +00:00
/** new line */
const newLine = "</tr><tr>\n";
2010-06-06 18:15:35 +00:00
2010-06-13 12:34:52 +00:00
/** list of subelements */
2010-06-06 18:15:35 +00:00
private $elements = array();
2010-06-21 16:23:44 +00:00
/** specifies if currently a row is open */
private $rowOpen = false;
/** additional CSS classes */
private $CSSClasses = '';
2010-06-06 18:15:35 +00:00
/**
* Adds an element to the table. The element may be a htmlElement object or a simple String.
*
* @param mixed $element htmlElement object or a simple String
2010-06-10 15:37:58 +00:00
* @param boolean $newLine adds a new line after the element (optional, default false)
* @param boolean $isTableHeadElement specifies if this is a head or body element (default: body)
2010-06-06 18:15:35 +00:00
*/
public function addElement($element, $newLine = false, $isTableHeadElement = false) {
2010-06-21 16:23:44 +00:00
// add row element
if ($element instanceof htmlTableRow) {
// check if a row needs to be closed
if ($this->rowOpen) {
$this->elements[] = "</tr>\n";
$this->rowOpen = false;
}
$this->elements[] = $element;
}
// add cell element
elseif ($element instanceof htmlElement) {
// check if a row needs to be opened
if (!$this->rowOpen) {
$this->elements[] = "<tr>\n";
$this->rowOpen = true;
}
2010-06-13 12:34:52 +00:00
// check if alignment option was given
2010-08-02 19:23:39 +00:00
$align = $element->getAlignmentString();
$colspan = $element->getColspanString();
$rowspan = $element->getRowspanString();
$tagName = 'td';
if ($isTableHeadElement) {
$tagName = 'th';
}
$this->elements[] = "<$tagName $align $colspan $rowspan>\n";
2010-06-06 18:15:35 +00:00
$this->elements[] = $element;
$this->elements[] = "</$tagName>\n";
2010-06-10 15:37:58 +00:00
if ($newLine) {
$this->addNewLine();
}
2010-06-06 18:15:35 +00:00
}
else {
StatusMessage('ERROR', 'Invalid element', print_r($element, true));
}
}
/**
* Adds another line to the table.
*/
public function addNewLine() {
2010-06-21 16:23:44 +00:00
if (!$this->rowOpen) {
$this->elements[] = "<tr>\n";
}
else {
$this->elements[] = htmlTable::newLine;
}
2010-06-06 18:15:35 +00:00
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
2010-09-25 14:28:37 +00:00
public function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
2010-06-06 18:15:35 +00:00
$return = array();
echo "<table $this->CSSClasses>\n";
2010-06-06 18:15:35 +00:00
// print all contained elements
for ($i = 0; $i < sizeof($this->elements); $i++) {
// print htmlElement objects
if ($this->elements[$i] instanceof htmlElement) {
$fields = $this->elements[$i]->generateHTML($module, $input, $values, $restricted, $tabindex, $scope);
$return = array_merge($return, $fields);
}
// print simple Strings
else {
2010-06-12 19:38:26 +00:00
if ($i != (sizeof($this->elements) - 1) || !($this->elements[$i] == htmlTable::newLine) ) {
echo $this->elements[$i];
}
2010-06-06 18:15:35 +00:00
}
}
2010-06-21 16:23:44 +00:00
if ($this->rowOpen) {
echo "</tr>\n";
}
2010-06-06 18:15:35 +00:00
echo htmlTable::footer;
return $return;
}
2010-09-25 14:28:37 +00:00
/**
* Merges the content of another htmlTable object into this table.
*
* @param $table table to get elements
*/
public function mergeTableElements($table) {
if (is_null($table) || !($table instanceof htmlTable)) {
return;
}
2010-09-26 11:10:28 +00:00
// remove obsolete new lines at the end
if ($table->elements[sizeof($table->elements) - 1] == htmlTable::newLine) {
unset($table->elements[sizeof($table->elements) - 1]);
}
// close last row of other table if needed
if ($table->rowOpen) {
$table->elements[] = "</tr>\n";
}
// close last own row if needed
if ($this->rowOpen) {
if ($this->elements[sizeof($this->elements) - 1] == htmlTable::newLine) {
unset($this->elements[sizeof($this->elements) - 1]);
}
else {
$this->elements[] = "</tr>\n";
}
$this->rowOpen = false;
}
2010-09-25 14:28:37 +00:00
$this->elements = array_merge($this->elements, $table->elements);
}
2010-06-06 18:15:35 +00:00
/**
* Sets the CSS classes for the table.
*
* @param String $CSSClasses CSS class names (e.g. "userlist smallPadding")
*/
public function setCSSClasses($CSSClasses) {
$this->CSSClasses = 'class="' . htmlspecialchars($CSSClasses) . '"';
}
2010-06-06 18:15:35 +00:00
}
2010-06-21 16:23:44 +00:00
/**
* A row inside a htmlTable.
*
* @see htmlTable
* @package metaHTML
*/
class htmlTableRow extends htmlElement {
private $cells;
/** additional CSS classes */
private $CSSClasses = '';
2010-06-21 16:23:44 +00:00
/**
* Constructor
*
* @param array $cells list of htmlElements
* @see htmlElement
*/
function __construct($cells) {
$this->cells = $cells;
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
$types = array();
echo "<tr $this->CSSClasses>\n";
2010-06-21 16:23:44 +00:00
for ($i = 0; $i < sizeof($this->cells); $i++) {
2010-07-03 12:31:34 +00:00
// check if alignment option was given
2010-08-02 19:23:39 +00:00
$align = $this->cells[$i]->getAlignmentString();
$colspan = $this->cells[$i]->getColspanString();
$rowspan = $this->cells[$i]->getRowspanString();
echo "<td $align $colspan $rowspan>\n";
2010-06-21 16:23:44 +00:00
$types = array_merge($types, $this->cells[$i]->generateHTML($module, $input, $values, $restricted, $tabindex, $scope));
echo "</td>\n";
}
echo "</tr>";
return $types;
}
/**
* Sets the CSS classes for the table.
*
* @param String $CSSClasses CSS class names (e.g. "userlist smallPadding")
*/
public function setCSSClasses($CSSClasses) {
$this->CSSClasses = 'class="' . htmlspecialchars($CSSClasses) . '"';
}
2010-06-21 16:23:44 +00:00
}
2010-06-06 18:15:35 +00:00
/**
2010-07-03 12:31:34 +00:00
* A standard input field.
2010-06-06 18:15:35 +00:00
*
* @package metaHTML
*/
2010-07-03 12:31:34 +00:00
class htmlInputField extends htmlElement {
2010-06-06 18:15:35 +00:00
/** unique field name */
private $fieldName;
/** field value */
private $fieldValue;
/** field size (default 30) */
private $fieldSize = 30;
/** field max length (default 255) */
private $fieldMaxLength = 255;
2010-07-03 13:16:30 +00:00
/** password field */
private $isPassword = false;
2010-09-13 19:30:57 +00:00
/** enabled or disabled */
private $isEnabled = true;
2011-07-23 15:01:20 +00:00
/** indicates that the value should be saved in obfuscated form */
private $obfuscate = false;
2010-06-06 18:15:35 +00:00
/**
* Constructor
*
* @param String $fieldName unique field name
* @param String $fieldValue value of input field (optional)
*/
2011-05-17 18:55:20 +00:00
function __construct($fieldName, $fieldValue = null, $fieldSize = null) {
2011-07-23 15:01:20 +00:00
if (isObfuscatedText($fieldValue)) {
$fieldValue = deobfuscateText($fieldValue);
}
2010-06-06 18:15:35 +00:00
$this->fieldName = htmlspecialchars($fieldName);
$this->fieldValue = htmlspecialchars($fieldValue);
2011-05-17 18:55:20 +00:00
if ($fieldSize != null) {
$this->fieldSize = $fieldSize;
}
2010-06-06 18:15:35 +00:00
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
2010-06-10 15:37:58 +00:00
if (isset($values[$this->fieldName])) {
2011-07-23 15:01:20 +00:00
if (isObfuscatedText($values[$this->fieldName][0])) {
$this->fieldValue = deobfuscateText($values[$this->fieldName][0]);
}
else {
$this->fieldValue = $values[$this->fieldName][0];
}
2010-06-10 15:37:58 +00:00
}
2010-06-06 18:15:35 +00:00
// print input field
$name = ' name="' . $this->fieldName . '"';
$value = '';
if ($this->fieldValue != null) {
$value = ' value="' . $this->fieldValue . '"';
}
$maxLength = '';
if ($this->fieldMaxLength != null) {
$maxLength = ' maxlength="' . $this->fieldMaxLength . '"';
}
$size = ' size="' . $this->fieldSize . '"';
$fieldTabIndex = ' tabindex="' . $tabindex . '"';
$tabindex++;
2010-07-03 13:16:30 +00:00
$inputType = 'text';
if ($this->isPassword) {
$inputType = 'password';
}
2010-09-13 19:30:57 +00:00
$disabled = '';
if (!$this->isEnabled) {
$disabled = ' disabled';
}
echo '<input type="' . $inputType . '"' . $name . $value . $maxLength . $size . $fieldTabIndex . $disabled . '>';
2011-07-23 15:01:20 +00:00
if ($this->obfuscate) {
return array($this->fieldName => 'text_obfuscated');
}
else {
return array($this->fieldName => 'text');
}
2010-07-03 12:31:34 +00:00
}
/**
* Sets the maximum field length.
*
* @param int $fieldMaxLength length
*/
public function setFieldMaxLength($fieldMaxLength) {
$this->fieldMaxLength = $fieldMaxLength;
}
/**
* Sets the field size.
*
* @param int $fieldSize size
*/
public function setFieldSize($fieldSize) {
$this->fieldSize = $fieldSize;
}
2010-07-03 13:16:30 +00:00
/**
* Specifies if this is a password field.
*
* @param boolean $isPassword password field
*/
public function setIsPassword($isPassword) {
$this->isPassword = $isPassword;
}
2010-09-13 19:30:57 +00:00
/**
* Specifies if this component is enabled and accepts user modification.
*
* @param boolean $isEnabled enabled if true
*/
public function setIsEnabled($isEnabled) {
$this->isEnabled = $isEnabled;
}
2011-07-23 15:01:20 +00:00
/**
* Specifies if the value should be saved in obfuscated form (e.g. self service profile).
*
* @param boolean $obfuscate obfuscate value
*/
public function setObfuscate($obfuscate) {
$this->obfuscate = $obfuscate;
}
2010-07-03 12:31:34 +00:00
}
/**
* An extended input field that combines label, input field and help.
*
* @package metaHTML
*/
class htmlTableExtendedInputField extends htmlInputField {
/** Descriptive label */
private $label;
/** help ID */
private $helpID;
/** required field */
private $required = false;
/**
* Constructor
*
* @param String $label descriptive label
* @param String $fieldName unique field name
* @param String $fieldValue value of input field (optional)
* @param String $helpID help ID (optional)
*/
function __construct($label, $fieldName, $fieldValue = null, $helpID = null) {
parent::__construct($fieldName, $fieldValue);
$this->label = htmlspecialchars($label);
$this->helpID = $helpID;
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
// print label text
echo '<div class="nowrap">';
2010-07-03 12:31:34 +00:00
echo $this->label;
if ($this->required) {
$graphicsPath = "../../graphics";
if (is_dir("../graphics")) $graphicsPath = "../graphics";
echo '<img src="' . $graphicsPath . '/required.png" alt="required" width=16 height=16 title="' . _('required') . '">';
2010-07-03 12:31:34 +00:00
}
echo '</div>';
2010-07-03 12:31:34 +00:00
echo "\n</td>\n<td>\n";
// print input field
$return = parent::generateHTML($module, $input, $values, $restricted, $tabindex, $scope);
2010-06-06 18:15:35 +00:00
// print help link
if ($this->helpID != null) {
echo "\n</td>\n<td>\n";
$helpLink = new htmlHelpLink($this->helpID);
$helpLink->generateHTML($module, $input, $values, $restricted, $tabindex, $scope);
}
2010-07-03 12:31:34 +00:00
return $return;
2010-06-06 18:15:35 +00:00
}
/**
* Specifies if this input field must be filled.
*
* @param boolean $required required or not
*/
public function setRequired($required) {
$this->required = $required;
}
}
/**
* Renders a help link.
*
* @package metaHTML
*/
2010-06-13 12:34:52 +00:00
class htmlHelpLink extends htmlElement {
2010-06-06 18:15:35 +00:00
/** help ID */
private $helpID;
/** module name if it should be forced */
private $module;
/** account type if it should be forced */
private $scope;
2010-06-06 18:15:35 +00:00
/**
* Constructor
*
* @param String $helpID help ID
* @param String $module module name (optional, only if value from generateHTML() should be overwritten)
* @param String $scope account type (e.g. user) (optional, only if value from generateHTML() should be overwritten)
2010-06-06 18:15:35 +00:00
*/
function __construct($helpID, $module = null, $scope = null) {
2010-06-06 18:15:35 +00:00
$this->helpID = $helpID;
$this->module = $module;
$this->scope = $scope;
2010-06-06 18:15:35 +00:00
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
// overwrite module and scop if needed
if ($this->module != null) {
$module = $this->module;
}
if ($this->scope != null) {
$scope = $this->scope;
}
// print link
2010-06-06 18:15:35 +00:00
$helpEntry = getHelp($module, $this->helpID, $scope);
printHelpLink($helpEntry, $this->helpID, $module, $scope);
return array();
}
}
/**
* Simple button.
*
* @package metaHTML
*/
2010-06-13 12:34:52 +00:00
class htmlButton extends htmlElement {
2010-06-06 18:15:35 +00:00
/** button name */
protected $name;
/** button text or image */
protected $value;
/** image button or text button */
protected $isImageButton;
2010-09-07 18:11:33 +00:00
/** title */
private $title = null;
2010-09-13 19:30:57 +00:00
/** enabled or disabled */
private $isEnabled = true;
2010-11-14 20:35:34 +00:00
/** icon class (CSS) for buttons with icon + text */
private $iconClass = null;
2010-06-06 18:15:35 +00:00
/**
* Constructor.
*
* @param String $name button name
* @param String $value button text or image (16x16px, relative to graphics folder)
* @param String $isImageButton image or text button (default text)
*/
function __construct($name, $value, $isImageButton = false) {
$this->name = htmlspecialchars($name);
$this->value = htmlspecialchars($value);
$this->isImageButton = $isImageButton;
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
2010-09-15 20:03:59 +00:00
if ($restricted) {
// no buttons in restricted mode
logNewMessage(LOG_ERR, 'Meta HTML: Requested button in restricted mode.');
return array();
}
2010-06-06 18:15:35 +00:00
$style = '';
$class = '';
2010-09-07 18:11:33 +00:00
$title = '';
2010-06-06 18:15:35 +00:00
$name = ' name="' . $this->name . '"';
// image button
if ($this->isImageButton) {
2010-06-10 15:37:58 +00:00
$class = ' class="smallImageButton"';
$style = ' style="background-image: url(../../graphics/' . $this->value . ');"';
2010-06-06 18:15:35 +00:00
}
// text button
2010-11-14 20:35:34 +00:00
elseif ($this->iconClass == null) {
2010-09-17 18:27:05 +00:00
$class = ' class="smallPadding"';
2010-06-06 18:15:35 +00:00
}
2010-09-07 18:11:33 +00:00
if ($this->title != null) {
$title = ' title="' . $this->title . '"';
}
2010-09-13 19:30:57 +00:00
$disabled = '';
if (!$this->isEnabled) {
$disabled = ' disabled';
}
2010-09-17 18:39:53 +00:00
if ($this->isImageButton) {
echo '<input type="submit" id="btn_' . $this->name . '" value=" "' . $name . $style . $class . $title . $disabled . '>';
}
else {
echo '<button id="btn_' . $this->name . '"' . $name . $style . $class . $title . $disabled . '>' . $this->value . '</button>';
2010-09-17 18:27:05 +00:00
// text buttons get JQuery style
2010-11-14 20:35:34 +00:00
$icon = '';
if ($this->iconClass != null) {
$icon = '{ icons: { primary: \'' . $this->iconClass . '\' } }';
}
2010-09-17 18:27:05 +00:00
echo '<script type="text/javascript">';
echo ' jQuery(document).ready(function() {';
2010-11-14 20:35:34 +00:00
echo "jQuery('#btn_" . $this->name . "').button(" . $icon . ");";
2010-09-17 18:27:05 +00:00
echo '});';
echo '</script>';
}
2010-06-12 18:01:55 +00:00
return array($this->name => 'submit');
2010-06-06 18:15:35 +00:00
}
2010-09-07 18:11:33 +00:00
/**
* Sets the button title (tooltip).
*
* @param String $title title
*/
public function setTitle($title) {
$this->title = htmlspecialchars($title);
}
2010-09-13 19:30:57 +00:00
/**
* Specifies if this component is enabled and accepts user modification.
*
* @param boolean $isEnabled enabled if true
*/
public function setIsEnabled($isEnabled) {
$this->isEnabled = $isEnabled;
}
2010-11-14 20:35:34 +00:00
/**
* Sets an additional icon for a text button.
* The icon class is a CSS class that specifies the icon image (e.g. "deleteButton" in layout.css).
*
* @param String $iconClass icon class
*/
public function setIconClass($iconClass) {
$this->iconClass = htmlspecialchars($iconClass);
}
2010-06-06 18:15:35 +00:00
}
/**
* Prints a button for the account pages.
*
* @package metaHTML
*/
2010-06-13 12:34:52 +00:00
class htmlAccountPageButton extends htmlButton {
2010-06-06 18:15:35 +00:00
/**
* Constructor
*
* @param String $targetModule module name which renders next page
* @param String $targetPage name of next page
* @param String $identifier identifier for button
* @param String $value button text or image (16x16px, relative to graphics folder)
* @param String $isImageButton image or text button (default text)
*/
function __construct($targetModule, $targetPage, $identifier, $value, $isImageButton = false) {
$this->name = htmlspecialchars('form_subpage_' . $targetModule . '_' . $targetPage . '_' . $identifier);
$this->value = $value;
$this->isImageButton = $isImageButton;
}
}
/**
* Represents a select box.
*
* @package metaHTML
*/
2010-06-13 12:34:52 +00:00
class htmlSelect extends htmlElement {
2010-06-06 18:15:35 +00:00
/** name of select field */
private $name;
/** size */
private $size;
/** allows multi-selection */
private $multiSelect = false;
/** elements */
private $elements;
/** selected elements */
2010-10-28 18:56:03 +00:00
private $selectedElements = array();
2010-06-06 18:15:35 +00:00
/** descriptive elements */
private $hasDescriptiveElements = false;
2010-10-12 17:47:20 +00:00
/** contains optgroups */
private $containsOptgroups = false;
2010-06-06 18:15:35 +00:00
/** sorting enabled */
private $sortElements = true;
2010-08-23 19:21:50 +00:00
/** right to left text direction */
private $rightToLeftTextDirection = false;
2010-09-13 19:30:57 +00:00
/** enabled or disabled */
private $isEnabled = true;
2010-10-18 19:45:35 +00:00
/** width of input element */
private $width = '';
2010-11-14 20:35:34 +00:00
/** transform select boxes with one element to text */
private $transformSingleSelect = true;
2011-01-02 13:56:37 +00:00
/** onchange event */
private $onchangeEvent = null;
2010-06-06 18:15:35 +00:00
/**
* Constructor.
2010-10-12 17:47:20 +00:00
*
* <br>Examples:
* <br>
* <br>$select = new htmlSelect('myName', array('value1', 'value2'), array('value1'));
* <br>
* <br>$select = new htmlSelect('myName', array('label1' => 'value1', 'label2' => 'value2'), array('value1'));
* <br>$select->setHasDescriptiveElements(true);
* <br>
* <br>$select = new htmlSelect('myName', array('optgroupLabel' => array('value1', 'value2')), array('value1'));
* <br>$select->setHasDescriptiveElements(true);
* <br>$select->setContainsOptgroups(true);
*
2010-06-06 18:15:35 +00:00
* @param String $name element name
2010-10-12 17:47:20 +00:00
* @param array $elements list of elements array(label => value) or array(value1, value2) or array('optgroup' => array(...))
2010-07-03 13:16:30 +00:00
* @param array $selectedElements list of selected elements (optional, default none)
2010-06-06 18:15:35 +00:00
* @param int $size size (optional, default = 1)
*/
2010-07-03 13:16:30 +00:00
function __construct($name, $elements, $selectedElements = array(), $size = 1) {
2010-06-06 18:15:35 +00:00
$this->name = htmlspecialchars($name);
$this->elements = $elements;
2010-10-28 18:56:03 +00:00
if ($selectedElements != null) {
$this->selectedElements = $selectedElements;
}
2010-06-06 18:15:35 +00:00
$this->size = htmlspecialchars($size);
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
2010-06-10 15:37:58 +00:00
if (isset($values[$this->name])) {
$this->selectedElements = $values[$this->name];
}
2010-06-06 18:15:35 +00:00
$multi = '';
2011-02-21 17:12:59 +00:00
$name = ' name="' . $this->name . '"';
2010-06-06 18:15:35 +00:00
if ($this->multiSelect) {
$multi = ' multiple';
2011-02-21 17:12:59 +00:00
$name = ' name="' . $this->name . '[]"';
2010-06-06 18:15:35 +00:00
}
2010-06-12 17:54:37 +00:00
$size = ' size="' . $this->size . '"';
2010-08-23 19:21:50 +00:00
$class = '';
if ($this->rightToLeftTextDirection) {
$class = ' class="rightToLeftText"';
}
2010-09-13 19:30:57 +00:00
$disabled = '';
if (!$this->isEnabled) {
$disabled = ' disabled';
}
2010-10-18 19:45:35 +00:00
$style = '';
if ($this->width != '') {
$style = ' style="width: ' . $this->width . '"';
}
2011-01-02 13:56:37 +00:00
$onchange = '';
if ($this->onchangeEvent != null) {
$onchange = ' onchange="' . $this->onchangeEvent . '"';
}
// hide select boxes that contain less than 2 elements
2010-11-14 20:35:34 +00:00
if ((sizeof($this->elements) < 2) && $this->transformSingleSelect) {
echo '<div class="hidden">';
}
// print select box
2011-01-02 13:56:37 +00:00
echo '<select' . $class . $style . $name . $size . $multi . $disabled . $onchange . ' tabindex="' . $tabindex . "\">\n";
2010-06-06 18:15:35 +00:00
$tabindex++;
2010-10-12 17:47:20 +00:00
if ($this->containsOptgroups) {
foreach ($this->elements as $label => $elements) {
if (sizeof($elements) > 0) {
echo '<optgroup label="' . $label . '">';
$this->printOptionsHTML($elements);
echo '</optgroup>';
}
}
}
else {
$this->printOptionsHTML($this->elements);
}
echo "</select>\n";
// if select box has only one element then show it as text
2010-11-14 20:35:34 +00:00
if ((sizeof($this->elements) == 1) && $this->transformSingleSelect) {
echo '</div>';
if ($this->hasDescriptiveElements) {
$keys = array_keys($this->elements);
echo $keys[0];
}
else {
echo $this->elements[0];
}
}
2010-11-14 20:35:34 +00:00
elseif (sizeof($this->elements) == 0) {
echo '</div>';
}
2010-10-12 17:47:20 +00:00
if ($this->multiSelect) {
return array($this->name => 'multiselect');
}
else {
return array($this->name => 'select');
}
}
/**
* Prints the HTML code of the option tags.
*
* @param array $elements list of options
*/
private function printOptionsHTML($elements) {
2010-06-06 18:15:35 +00:00
// sorting
if ($this->sortElements) {
if ($this->hasDescriptiveElements) {
2010-10-12 17:47:20 +00:00
$labels = array_keys($elements);
2010-06-06 18:15:35 +00:00
natcasesort($labels);
$newElements = array();
foreach ($labels as $label) {
2010-10-12 17:47:20 +00:00
$newElements[$label] = $elements[$label];
2010-06-06 18:15:35 +00:00
}
2010-10-12 17:47:20 +00:00
$elements = $newElements;
2010-06-06 18:15:35 +00:00
}
else {
2010-10-12 17:47:20 +00:00
natcasesort($elements);
2010-06-06 18:15:35 +00:00
}
}
2010-10-12 17:47:20 +00:00
foreach ($elements as $key => $value) {
2010-06-06 18:15:35 +00:00
$selected = '';
if ($this->hasDescriptiveElements) {
if (in_array($value, $this->selectedElements)) {
$selected = ' selected';
}
echo "<option value=\"" . htmlspecialchars($value) . "\"$selected>" . htmlspecialchars($key) . "</option>\n";
}
else {
if (in_array($value, $this->selectedElements)) {
$selected = ' selected';
}
echo "<option$selected>" . htmlspecialchars($value) . "</option>\n";
}
}
}
/**
* Specifies if the elements are just a simple list or an assoziative array (default: simple list).
*
* @param boolean $hasDescriptiveElements activates descriptive elements
*/
public function setHasDescriptiveElements($hasDescriptiveElements) {
$this->hasDescriptiveElements = $hasDescriptiveElements;
}
2010-10-12 17:47:20 +00:00
/**
* Specifies if the elements are divided into optgroups.
*
* @param boolean $containsOptgroups activates optgroups
*/
public function setContainsOptgroups($containsOptgroups) {
$this->containsOptgroups = $containsOptgroups;
}
2010-06-06 18:15:35 +00:00
/**
* Specifies if multi-selection is enabled (default: disabled).
*
* @param boolean $multiSelect allows multi-selection
*/
public function setMultiSelect($multiSelect) {
$this->multiSelect = $multiSelect;
}
/**
* Specifies if the elemets should be sorted (default: sort).
*
2010-06-10 15:37:58 +00:00
* @param boolean $sortElements sort elements
2010-06-06 18:15:35 +00:00
*/
public function setSortElements($sortElements) {
$this->sortElements = $sortElements;
}
2010-08-23 19:21:50 +00:00
/**
* Specifies if the text direction should be set to right to left.
*
* @param boolean $rightToLeftTextDirection if true use right to left direction
*/
public function setRightToLeftTextDirection($rightToLeftTextDirection) {
$this->rightToLeftTextDirection = $rightToLeftTextDirection;
}
2010-09-13 19:30:57 +00:00
/**
* Specifies if this component is enabled and accepts user modification.
*
* @param boolean $isEnabled enabled if true
*/
public function setIsEnabled($isEnabled) {
$this->isEnabled = $isEnabled;
}
2010-10-18 19:45:35 +00:00
/**
* Specifies the width of this selection box.
*
* @param String $width width (e.g. 20em)
*/
public function setWidth($width) {
$this->width = htmlspecialchars($width);
}
2010-11-14 20:35:34 +00:00
/**
* Specifies if select boxes that contain only a single element should be transformed to a simple text field.
*
* @param boolean $transformSingleSelect transform single options to text
*/
public function setTransformSingleSelect($transformSingleSelect) {
$this->transformSingleSelect = $transformSingleSelect;
}
2011-01-02 13:56:37 +00:00
/**
* Sets the JavaScript code for the onchange event.
*
* @param String $onchangeEvent onchange event code (e.g. myfunction();)
*/
public function setOnchangeEvent($onchangeEvent) {
$this->onchangeEvent = htmlspecialchars($onchangeEvent);
}
2010-06-06 18:15:35 +00:00
}
2010-05-23 10:35:33 +00:00
2010-06-11 19:40:26 +00:00
/**
* Select with label and help link.
*
* @package metaHTML
*/
class htmlTableExtendedSelect extends htmlSelect {
/** descriptive label */
private $label;
/** help ID */
private $helpID;
/**
* Constructor.
*
* @param String $name element name
* @param array $elements list of elememts
* @param array $selectedElements list of selected elements
* @param String $label descriptive label
* @param String $helpID help ID (optional, default none)
* @param int $size size (optional, default = 1)
*/
function __construct($name, $elements, $selectedElements, $label, $helpID = null, $size = 1) {
parent::__construct($name, $elements, $selectedElements, $size);
$this->label = htmlspecialchars($label);
$this->helpID = $helpID;
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
echo '<div class="nowrap">';
2010-06-11 19:40:26 +00:00
echo $this->label;
echo '</div>';
2010-06-11 19:40:26 +00:00
echo "\n</td>\n<td>\n";
$return = parent::generateHTML($module, $input, $values, $restricted, $tabindex, $scope);
// print help link
if ($this->helpID != null) {
echo "\n</td>\n<td>\n";
$helpLink = new htmlHelpLink($this->helpID);
$helpLink->generateHTML($module, $input, $values, $restricted, $tabindex, $scope);
}
return $return;
}
}
2010-11-06 09:38:47 +00:00
/**
* Represents a radio selection.
*
* @package metaHTML
*/
class htmlRadio extends htmlElement {
/** name of select field */
private $name;
/** elements */
private $elements;
/** selected element */
private $selectedElement = null;
/** enabled or disabled */
private $isEnabled = true;
/**
* Constructor.
*
* <br>Examples:
* <br>
* <br>$radio = new htmlRadio('myName', array('label1' => 'value1', 'label2' => 'value2'), array('value1'));
*
* @param String $name element name
* @param array $elements list of elements array(label => value)
* @param array $selectedElement value of selected element (optional, default none)
*/
function __construct($name, $elements, $selectedElement = null) {
$this->name = htmlspecialchars($name);
$this->elements = $elements;
if ($selectedElement != null) {
$this->selectedElement = $selectedElement;
}
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
if (isset($values[$this->name][0])) {
$this->selectedElement = $values[$this->name][0];
}
$name = ' name="' . $this->name . '"';
$disabled = '';
if (!$this->isEnabled) {
$disabled = ' disabled';
}
// print radio list
foreach ($this->elements as $label => $value) {
$selected = '';
if ($value == $this->selectedElement) {
$selected = ' checked';
}
echo '<input type="radio"' . $name . $disabled . $selected . ' value="' . $value . '" tabindex="' . $tabindex . '"> ' . $label . '<br>';
$tabindex++;
}
return array($this->name => 'select');
}
/**
* Specifies if this component is enabled and accepts user modification.
*
* @param boolean $isEnabled enabled if true
*/
public function setIsEnabled($isEnabled) {
$this->isEnabled = $isEnabled;
}
}
2010-11-18 19:29:24 +00:00
/**
* Radio list with descriptive label and help link.
*
* @package metaHTML
*/
class htmlTableExtendedRadio extends htmlRadio {
/** descriptive label */
private $label;
/** help ID */
private $helpID;
/**
* Constructor.
*
* @param String $label descriptive label
* @param String $name element name
* @param array $elements list of elements array(label => value)
* @param array $selectedElement value of selected element (optional, default none)
* @param String $helpID help ID
*/
function __construct($label, $name, $elements, $selectedElement = null, $helpID = null) {
parent::__construct($name, $elements, $selectedElement);
$this->label = htmlspecialchars($label);
$this->helpID = $helpID;
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
echo '<div class="nowrap">';
2010-11-18 19:29:24 +00:00
echo $this->label;
echo '</div>';
2010-11-18 19:29:24 +00:00
echo "\n</td>\n<td>\n";
$return = parent::generateHTML($module, $input, $values, $restricted, $tabindex, $scope);
// print help link
if ($this->helpID != null) {
echo "\n</td>\n<td>\n";
$helpLink = new htmlHelpLink($this->helpID);
$helpLink->generateHTML($module, $input, $values, $restricted, $tabindex, $scope);
}
return $return;
}
}
2010-06-10 15:37:58 +00:00
/**
* Prints the text and escapes contained HTML code by default.
*
* @package metaHTML
*/
2010-06-13 12:34:52 +00:00
class htmlOutputText extends htmlElement {
2010-06-10 15:37:58 +00:00
/** the text to print */
private $string;
/** specifies if HTML code should be escaped */
private $escapeHTML;
2010-11-14 20:35:34 +00:00
/** bold text */
private $isBold = false;
/** mark as required */
private $markAsRequired = false;
2011-05-20 17:43:31 +00:00
/** no wrap */
private $noWrap = false;
2010-06-10 15:37:58 +00:00
/**
* Constructor.
*
* @param String $string output text
* @param boolean $escapeHTML escape HTML code (default yes)
*/
function __construct($string, $escapeHTML = true) {
$this->string = $string;
$this->escapeHTML = $escapeHTML;
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
2011-05-20 17:43:31 +00:00
if ($this->noWrap) {
echo "<div class=\"nowrap\">";
}
2010-11-14 20:35:34 +00:00
if ($this->isBold) {
echo "<b>";
}
2010-06-10 15:37:58 +00:00
if ($this->escapeHTML) {
echo htmlspecialchars($this->string);
}
else {
echo $this->string;
}
if ($this->markAsRequired) {
$graphicsPath = "../../graphics";
if (is_dir("../graphics")) $graphicsPath = "../graphics";
echo '<img src="' . $graphicsPath . '/required.png" alt="required" width=16 height=16 title="' . _('required') . '">';
}
2010-11-14 20:35:34 +00:00
if ($this->isBold) {
echo "</b>";
}
2011-05-20 17:43:31 +00:00
if ($this->noWrap) {
echo "</div>";
}
2010-06-10 15:37:58 +00:00
return array();
}
2010-11-14 20:35:34 +00:00
/**
* Specifies if the whole text should be printed in bold.
*
* @param boolean $isBold bold text
*/
public function setIsBold($isBold) {
$this->isBold = $isBold;
}
/**
* Adds a marker that indicates a required field.
*
* @param boolean $markAsRequired add marker
*/
public function setMarkAsRequired($markAsRequired) {
$this->markAsRequired = $markAsRequired;
2011-05-20 17:43:31 +00:00
}
/**
* Specifies if word wrap is allowed for this text.
*
* @param boolean $noWrap no wrapping if set to true (default false)
*/
public function setNoWrap($noWrap) {
$this->noWrap = $noWrap;
}
2010-06-10 15:37:58 +00:00
}
/**
* Prints the HTML code for a checkbox.
*
* @package metaHTML
*/
2010-06-13 12:34:52 +00:00
class htmlInputCheckbox extends htmlElement {
2010-06-10 15:37:58 +00:00
/** unique name of input element */
private $name;
/** value */
private $checked;
2010-09-13 19:30:57 +00:00
/** enabled or disabled */
private $isEnabled = true;
2010-06-10 15:37:58 +00:00
/**
* Constructor.
*
* @param String $name unique name
* @param boolean $checked checked
*/
function __construct($name, $checked) {
$this->name = htmlspecialchars($name);
$this->checked = $checked;
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
if (isset($values[$this->name])) {
if ($values[$this->name][0] == 'true') {
$this->checked = true;
}
else {
$this->checked = false;
}
}
$checked = '';
if ($this->checked) {
$checked = ' checked';
}
$tabindexValue = ' tabindex="' . $tabindex . '"';
$tabindex++;
2010-09-13 19:30:57 +00:00
$disabled = '';
if (!$this->isEnabled) {
$disabled = ' disabled';
}
echo '<input type="checkbox" name="' . $this->name . '"' . $tabindexValue . $checked . $disabled . '>';
2010-06-10 15:37:58 +00:00
return array($this->name => 'checkbox');
}
2010-09-13 19:30:57 +00:00
/**
* Specifies if this component is enabled and accepts user modification.
*
* @param boolean $isEnabled enabled if true
*/
public function setIsEnabled($isEnabled) {
$this->isEnabled = $isEnabled;
}
2010-06-10 15:37:58 +00:00
}
/**
* Checkbox with descriptive label and help link.
*
* @package metaHTML
*/
class htmlTableExtendedInputCheckbox extends htmlInputCheckbox {
/** descriptive label */
private $label;
/** help ID */
private $helpID;
2010-06-11 19:40:26 +00:00
/** specifies if label is printed before the checkbox */
private $labelFirst;
2010-06-10 15:37:58 +00:00
/**
* Constructor.
*
* @param String $name unique name
* @param boolean $checked checked
* @param String $label descriptive label
* @param String $helpID help ID
2010-06-21 16:23:44 +00:00
* @param boolean $labelFirst specifies if the label is at the beginning or at the end (optional, default beginning)
2010-06-10 15:37:58 +00:00
*/
2010-06-11 19:40:26 +00:00
function __construct($name, $checked, $label, $helpID = null, $labelFirst = true) {
2010-06-10 15:37:58 +00:00
parent::__construct($name, $checked);
$this->label = htmlspecialchars($label);
$this->helpID = $helpID;
2010-06-11 19:40:26 +00:00
$this->labelFirst = $labelFirst;
2010-06-10 15:37:58 +00:00
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
2010-06-11 19:40:26 +00:00
if ($this->labelFirst) {
echo '<div class="nowrap">';
2010-06-11 19:40:26 +00:00
echo $this->label;
echo '</div>';
2010-06-11 19:40:26 +00:00
echo "\n</td>\n<td>\n";
$return = parent::generateHTML($module, $input, $values, $restricted, $tabindex, $scope);
}
else {
$return = parent::generateHTML($module, $input, $values, $restricted, $tabindex, $scope);
echo "\n</td>\n<td>\n";
echo '<div class="nowrap">';
2010-06-11 19:40:26 +00:00
echo $this->label;
echo '</div>';
2010-06-11 19:40:26 +00:00
}
2010-06-10 15:37:58 +00:00
// print help link
if ($this->helpID != null) {
echo "\n</td>\n<td>\n";
$helpLink = new htmlHelpLink($this->helpID);
$helpLink->generateHTML($module, $input, $values, $restricted, $tabindex, $scope);
}
return $return;
}
}
2010-06-21 16:23:44 +00:00
/**
* Prints the HTML code for a file upload field.
*
* @package metaHTML
*/
class htmlInputFileUpload extends htmlElement {
/** unique name of input element */
private $name;
2010-09-13 19:30:57 +00:00
/** enabled or disabled */
private $isEnabled = true;
2010-06-21 16:23:44 +00:00
/**
* Constructor.
*
* @param String $name unique name
*/
function __construct($name) {
$this->name = htmlspecialchars($name);
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
$tabindexValue = ' tabindex="' . $tabindex . '"';
$tabindex++;
2010-09-13 19:30:57 +00:00
$disabled = '';
if (!$this->isEnabled) {
$disabled = ' disabled';
}
echo '<input type="file" name="' . $this->name . '"' . $tabindexValue . $disabled . '>';
2010-06-21 16:23:44 +00:00
return array($this->name => 'file');
}
2010-09-13 19:30:57 +00:00
/**
* Specifies if this component is enabled and accepts user modification.
*
* @param boolean $isEnabled enabled if true
*/
public function setIsEnabled($isEnabled) {
$this->isEnabled = $isEnabled;
}
2010-06-21 16:23:44 +00:00
}
/**
* File upload with descriptive label and help link.
*
* @package metaHTML
*/
class htmlTableExtendedInputFileUpload extends htmlInputFileUpload {
/** descriptive label */
private $label;
/** help ID */
private $helpID;
/**
* Constructor.
*
* @param String $name unique name
* @param String $label descriptive label
* @param String $helpID help ID
*/
function __construct($name, $label, $helpID = null) {
parent::__construct($name);
$this->label = htmlspecialchars($label);
$this->helpID = $helpID;
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
echo '<div class="nowrap">';
2010-06-21 16:23:44 +00:00
echo $this->label;
echo '</div>';
2010-06-21 16:23:44 +00:00
echo "\n</td>\n<td>\n";
$return = parent::generateHTML($module, $input, $values, $restricted, $tabindex, $scope);
// print help link
if ($this->helpID != null) {
echo "\n</td>\n<td>\n";
$helpLink = new htmlHelpLink($this->helpID);
$helpLink->generateHTML($module, $input, $values, $restricted, $tabindex, $scope);
}
return $return;
}
}
2010-06-10 15:37:58 +00:00
/**
* Prints the HTML code for a textarea.
*
* @package metaHTML
*/
2010-06-13 12:34:52 +00:00
class htmlInputTextarea extends htmlElement {
2010-06-10 15:37:58 +00:00
/** unique name of input element */
private $name;
/** value */
private $value;
/** column count */
private $colCount;
/** row count */
private $rowCount;
2010-09-13 19:30:57 +00:00
/** enabled or disabled */
private $isEnabled = true;
2010-06-10 15:37:58 +00:00
/**
* Constructor.
*
* @param String $name unique name
* @param String $value value
* @param int $colCount number of characters per line
* @param int $rowCount number of rows
*/
function __construct($name, $value, $colCount, $rowCount) {
$this->name = htmlspecialchars($name);
$this->value = htmlspecialchars($value);
$this->colCount = $colCount;
$this->rowCount = $rowCount;
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
if (isset($values[$this->name])) {
$this->value = implode("\r\n", $values[$this->name]);
}
$colCount = ' cols="' . $this->colCount . '"';
$rowCount = ' rows="' . $this->rowCount . '"';
$tabindexValue = ' tabindex="' . $tabindex . '"';
$tabindex++;
2010-09-13 19:30:57 +00:00
$disabled = '';
if (!$this->isEnabled) {
$disabled = ' disabled';
}
echo '<textarea name="' . $this->name . '"' . $tabindexValue . $colCount . $rowCount . $disabled . '>' . $this->value . '</textarea>';
2010-06-10 15:37:58 +00:00
return array($this->name => 'textarea');
}
2010-09-13 19:30:57 +00:00
/**
* Specifies if this component is enabled and accepts user modification.
*
* @param boolean $isEnabled enabled if true
*/
public function setIsEnabled($isEnabled) {
$this->isEnabled = $isEnabled;
}
2010-06-10 15:37:58 +00:00
}
/**
* Text area with label and help link.
*
* @package metaHTML
*/
class htmlTableExtendedInputTextarea extends htmlInputTextarea {
/** descriptive label */
private $label;
/** help ID */
private $helpID;
/** required field */
private $required = false;
/**
* Constructor.
*
* @param String $name unique name
* @param String $value value
* @param int $colCount number of characters per line
* @param int $rowCount number of rows
* @param String $label descriptive label
* @param String $helpID help ID
*/
function __construct($name, $value, $colCount, $rowCount, $label, $helpID) {
parent::__construct($name, $value, $colCount, $rowCount);
$this->label = htmlspecialchars($label);
$this->helpID = $helpID;
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
echo '<div class="nowrap">';
2010-06-10 15:37:58 +00:00
echo $this->label;
if ($this->required) {
$graphicsPath = "../../graphics";
if (is_dir("../graphics")) $graphicsPath = "../graphics";
echo '<img src="' . $graphicsPath . '/required.png" alt="required" width=16 height=16 title="' . _('required') . '">';
2010-06-10 15:37:58 +00:00
}
echo '</div>';
2010-06-10 15:37:58 +00:00
echo "\n</td>\n<td>\n";
$return = parent::generateHTML($module, $input, $values, $restricted, $tabindex, $scope);
// print help link
if ($this->helpID != null) {
echo "\n</td>\n<td>\n";
$helpLink = new htmlHelpLink($this->helpID);
$helpLink->generateHTML($module, $input, $values, $restricted, $tabindex, $scope);
}
return $return;
}
/**
* Specifies if this input field must be filled.
*
* @param boolean $required required or not
*/
public function setRequired($required) {
$this->required = $required;
}
}
2010-06-11 19:40:26 +00:00
/**
* Prints the HTML code for an image.
*
* @package metaHTML
*/
2010-06-13 12:34:52 +00:00
class htmlImage extends htmlElement {
2010-06-11 19:40:26 +00:00
/** path to image */
private $path;
/** width */
private $width;
/** height */
private $height;
/** alt text */
private $alt;
/**
* Constructor.
*
* @param String $path image location
* @param int $width image width (optional, default original size)
* @param int $height image height (optional, default original size)
* @param String $alt alt text (optional)
*/
function __construct($path, $width = null, $height = null, $alt = ' ') {
$this->path = htmlspecialchars($path);
$this->width = $width;
$this->height = $height;
$this->alt = htmlspecialchars($alt);
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
$path = ' src="' . $this->path . '"';
$width = '';
if ($this->width != null) {
$width = ' width="' . $this->width . '"';
}
$height = '';
if ($this->height != null) {
$height = ' height="' . $this->height . '"';
}
$alt = ' alt="' . $this->alt . '"';
echo '<img' . $path . $width . $height . $alt . ">\n";
return array();
}
}
2010-06-13 12:34:52 +00:00
/**
* Adds an empty space with given width and height.
*
* @package metaHTML
*/
class htmlSpacer extends htmlElement {
private $width;
private $height;
/**
* Constructor.
*
* @param String $width width (e.g. 10px)
* @param String $height height (e.g. 10px)
*/
function __construct($width, $height) {
$this->width = htmlspecialchars($width);
$this->height = htmlspecialchars($height);
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
$width = '';
if ($this->width != null) {
$width = 'width: ' . $this->width . ';';
}
$height = '';
if ($this->height != null) {
$height = 'height: ' . $this->height . ';';
}
echo "<div style=\"$width $height\"></div>\n";
return array();
}
}
2010-08-20 13:23:29 +00:00
/**
* Prints a status message (e.g. error message).
*
* @package metaHTML
*/
class htmlStatusMessage extends htmlElement {
private $type;
private $title;
private $text;
2010-09-20 17:36:42 +00:00
private $params;
2010-08-20 13:23:29 +00:00
/**
* Constructor.
*
* @param String $type message type (e.g. ERROR)
* @param String $title message title
* @param String $text message (optional)
2010-08-20 13:23:29 +00:00
*/
2010-09-20 17:36:42 +00:00
function __construct($type, $title, $text = null, $params = null) {
2010-08-20 13:23:29 +00:00
$this->type = $type;
$this->title = $title;
$this->text = $text;
2010-09-20 17:36:42 +00:00
$this->params = $params;
2010-08-20 13:23:29 +00:00
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
2010-09-20 17:36:42 +00:00
StatusMessage($this->type, $this->title, $this->text, $this->params);
2010-08-20 13:23:29 +00:00
return array();
}
2010-08-29 16:02:27 +00:00
}
/**
2010-09-04 12:40:42 +00:00
* Generates a fieldset.
2010-08-29 16:02:27 +00:00
*
* @package metaHTML
*/
class htmlFieldset extends htmlElement {
/** fieldset content */
private $content;
/** descriptive label */
private $label = null;
/** label image */
private $labelImage = null;
/**
* Constructor.
*
* @param htmlElement $content content to display inside fieldset
* @param String $label label
* @param String $labelImage image to put before label
*/
function __construct($content, $label = null, $labelImage = null) {
$this->content = $content;
$this->label = htmlspecialchars($label);
$this->labelImage = htmlspecialchars($labelImage);
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
$class = 'ui-corner-all';
if ($scope != null) {
$class .= ' ' . $scope . 'edit';
}
echo "<fieldset class=\"$class\">\n";
2010-08-29 16:02:27 +00:00
// generate legend
if (($this->label != null) || ($this->labelImage != null)) {
echo "<legend>";
if ($this->labelImage != null) {
echo "<img align=\"middle\" src=\"" . $this->labelImage . "\" alt=\"\"> ";
}
if ($this->label != null) {
echo $this->label;
}
echo "</legend>\n";
}
$return = $this->content->generateHTML($module, $input, $values, $restricted, $tabindex, $scope);
echo "</fieldset>\n";
return $return;
}
2010-08-20 13:23:29 +00:00
}
2010-10-17 13:37:22 +00:00
/**
* Generates a title line. This is used for page titles.
*
* @package metaHTML
*/
class htmlTitle extends htmlElement {
/** descriptive label */
private $label = null;
/**
* Constructor.
*
* @param String $label label
*/
function __construct($label) {
$this->label = htmlspecialchars($label);
// the title should not end at a table cell
$this->colspan = 100;
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
echo "<div class=\"title\">\n";
echo "<h2 class=\"titleText\">\n";
echo $this->label;
echo "</h2>\n";
echo "</div>\n";
return array();
}
}
2010-09-04 12:40:42 +00:00
/**
* Generates a subtitle line. This is used to group multiple fields.
*
* @package metaHTML
*/
class htmlSubTitle extends htmlElement {
/** descriptive label */
private $label = null;
2010-11-14 20:35:34 +00:00
/** optional image */
private $image = null;
2010-09-04 12:40:42 +00:00
/**
* Constructor.
*
* @param String $label label
* @param String $image optional image
2010-09-04 12:40:42 +00:00
*/
2010-11-14 20:35:34 +00:00
function __construct($label, $image = null) {
2010-09-04 12:40:42 +00:00
$this->label = htmlspecialchars($label);
2010-11-14 20:35:34 +00:00
$this->image = htmlspecialchars($image);
2010-09-04 12:40:42 +00:00
// the title should not end at a table cell
$this->colspan = 100;
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
echo "<div class=\"subTitle\">\n";
2010-10-17 13:37:22 +00:00
echo "<h4 class=\"subTitleText\">\n";
2010-11-14 20:35:34 +00:00
if ($this->image != null) {
echo '<img src="' . $this->image . '" alt="' . $this->label . '">&nbsp;';
}
2010-09-04 12:40:42 +00:00
echo $this->label;
2010-10-17 13:37:22 +00:00
echo "</h4>\n";
2010-09-04 12:40:42 +00:00
echo "</div>\n";
return array();
}
}
2010-09-18 11:36:57 +00:00
/**
* Generates a hidden input field.
*
* @package metaHTML
*/
class htmlHiddenInput extends htmlElement {
/** field name */
private $name = null;
/** field value */
private $value = null;
/**
* Constructor.
*
2010-10-16 16:55:31 +00:00
* @param String $name input name
* @param String $value input value
2010-09-18 11:36:57 +00:00
*/
function __construct($name, $value) {
2010-10-16 16:55:31 +00:00
$this->name = htmlspecialchars($name);
$this->value = htmlspecialchars($value);
2010-09-18 11:36:57 +00:00
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
echo '<input type="hidden" name="' . $this->name . '" value="' . $this->value . '">';
return array();
}
}
2010-10-16 16:55:31 +00:00
/**
* Generates a link.
* The link can include an optional image in front of the link text.
*
* @package metaHTML
*/
class htmlLink extends htmlElement {
/** link text */
private $text = null;
/** link target */
private $target = null;
/** optional image */
private $image = null;
/** title */
private $title = null;
/** target window */
private $targetWindow = null;
2011-04-25 17:47:52 +00:00
/** onClick event */
private $onClick = null;
2010-10-16 16:55:31 +00:00
/**
* Constructor.
*
2010-12-03 21:06:36 +00:00
* @param String $text label
* @param String $target target URL
* @param String $image URL of optional image
2010-10-16 16:55:31 +00:00
*/
function __construct($text, $target, $image = null) {
$this->text = htmlspecialchars($text);
$this->target = htmlspecialchars($target);
$this->image = htmlspecialchars($image);
}
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
$image = '';
if ($this->image != null) {
$image = '<img src="' . $this->image . '" alt="' . $this->text . '">&nbsp;';
}
$title = '';
if ($this->title != null) {
$title = ' title="' . $this->title . '"';
}
$targetWindow = '';
if ($this->targetWindow != null) {
$targetWindow = ' target="' . $this->targetWindow . '"';
}
2011-04-25 17:47:52 +00:00
$onClick = '';
if ($this->onClick != null) {
$onClick = ' onclick="' . $this->onClick . '"';
}
echo '<a href="' . $this->target . '"' . $title . $targetWindow . $onClick . '>' . $image . $this->text . '</a>';
2010-10-16 16:55:31 +00:00
return array();
}
/**
* Sets the link title.
*
* @param String $title title
*/
public function setTitle($title) {
$this->title = htmlspecialchars($title);
}
/**
* Sets the target window (e.g. _blank).
*
* @param String $window target window (e.g. _blank)
*/
public function setTargetWindow($window) {
$this->targetWindow = htmlspecialchars($window);
}
2011-04-25 17:47:52 +00:00
/**
* Sets the onClick event.
*
* @param String $event JavaScript code
*/
public function setOnClick($event) {
$this->onClick = htmlspecialchars($event);
}
}
/**
* Groups multiple htmlElements.
* This is useful if multiple elements should be included in a single table cell.
* The HTML code of the subelements is printed in the order they were added. No additional code is added.
*
* @package metaHTML
*/
class htmlGroup extends htmlElement {
/** link text */
private $subelements = array();
2010-10-16 16:55:31 +00:00
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
$return = array();
for ($i = 0; $i < sizeof($this->subelements); $i++) {
$return = array_merge($return, $this->subelements[$i]->generateHTML($module, $input, $values, $restricted, $tabindex, $scope));
}
return $return;
}
/**
* Adds a subelement.
*
* @param htmlElement $sub subelement
*/
public function addElement($sub) {
$this->subelements[] = $sub;
}
2010-10-16 16:55:31 +00:00
}
/**
* Prints a horizontal line.
*
* @package metaHTML
*/
class htmlHorizontalLine extends htmlElement {
/**
* Prints the HTML code for this element.
*
* @param string $module Name of account module
* @param array $input List of meta-HTML elements
* @param array $values List of values which override the defaults in $input (name => value)
* @param boolean $restricted If true then no buttons will be displayed
* @param integer $tabindex Start value of tabulator index for input fields
* @param string $scope Account type
* @return array List of input field names and their type (name => type)
*/
function generateHTML($module, $input, $values, $restricted, &$tabindex, $scope) {
$return = array();
echo "<hr>";
return $return;
}
}
2010-06-13 12:34:52 +00:00
?>