se/SE/se-lib/UI.php

<?php


class UI {

	public static function getTitle() {
		$title = 'SE';

		$host = $_SERVER['SERVER_NAME'];
		if (substr($host, 0, 5) == 'biuro') {
			$host = substr($host, 6);
		}

		$title = "{$host}-SE";

		return $title;
	}

	public static function gora() {
		UI::startHtml();
	}

	public static function startHtml() {
		Lib::loadClass('S');
		UI::loadTemplate('_layout_gora');
	}

	public static function dol() {
		UI::endHtml();
	}

	public static function fixFooterPosition($type) {
		$fixFooterPosition = true;// from config?
		if (!$fixFooterPosition) return;
		switch ($type) {
			case 'footer_style': return 'position:absolute; bottom:0; left:0; width:100%; ';
			case 'body_style': return 'position:relative; padding-bottom:32px;';
			case 'footer_js_tag': return "\n<script>document.body.style.minHeight = '' + (window.innerHeight - 2) + 'px';</script>";
		}
	}

	public static function endHtml() {
		$version = (file_exists(APP_PATH_ROOT . '/VERSION'))? file_get_contents(APP_PATH_ROOT . '/VERSION') : null;
		if ($version) {
			echo '<div style="' . UI::fixFooterPosition('footer_style') . 'border-top:1px solid #ddd; margin-top:10px; padding:0 30px; font-size:xx-small; color:#888">version: '.$version.'</div>';
		}
		echo UI::fixFooterPosition('footer_js_tag');
		echo "\n</body></html>";
	}

	public static function menu() {
		if (!User::logged()) return;

		if (User::hasAccess('menu')) {
			Lib::loadClass('ProcesMenu');
			$procesMenu = ProcesMenu::getInstance();
			$procesMenu->show();

			// if (!V::get('MENU_INIT', '', $_GET)) {
			// 	Lib::loadClass('UserActivity');
			// 	//echo UserActivity::showListInContainer();
			// }
		}
		else {
			UI::loadTemplate('menuLevel6');
		}
	}

	public static function loadTemplate($tmplName, $data = array()) {
		if (is_array($data) && !empty($data)) {
			extract($data);
		}
		include APP_PATH_LIB . "/tmpl/{$tmplName}.php";
	}

	public static function hotKeyDBG($str) {
		if (User::hasAccess('dbg')) {
			echo '<span class="hidden-dbg">' . htmlspecialchars($str) . '</span>';
		}
	}

	public static function showMessagesForTable($tblName) {
		if (empty($tblName)) return;

		Lib::loadClass('Router');
		$msgsRoute = Router::getRoute('Msgs');
		$msgs = $msgsRoute->getActiveMessagesForTable($tblName);
		if (!empty($msgs)) {
			self::loadTemplate('msgsForTable', array('msgs' => $msgs));
		}
	}

	public static function alert($alertType, $msg, $outputHtml = true) {
		if (!$outputHtml) {
			$type = ('danger' == $alertType) ? "ERROR" : strtoupper($alertType);
			echo "{$type}: {$msg}\n";
			return;
		}
		UI::tag('div', ['class'=>"alert alert-{$alertType}"], $msg, "\n");
	}

	public static function setTitleJsTag($title) { self::setTitle($title); }
	public static function setTitle($title) { self::tag('script', null, "document.title = '{$title}';", "\n"); }

	/**
	 * $params - Array
	 *	 $params['caption'] (optional) -> <caption>...</caption>
	 *	 $params['cols'] (optional) -> cols, if not set read from first row
	 *	 $params['rows'] -> rows, if not set - empty table
	 *	 $params['rows'] -> rows, if not set - empty table
	 *	 $params['disable_lp'] -> disable lp. col
	 */
	public static function table($params) {
		$cols = V::get('cols', array(), $params);
		$rows = V::get('rows', array(), $params);
		$cols_help = V::get('cols_help', array(), $params);
		$caption = V::get('caption', '', $params);
		$cellPadding = V::get('cell_padding', 2, $params, 'int');
		$showLp = (!V::get('disable_lp', false, $params));
		$countCols = 1;
		if (empty($cols) && !empty($rows)) {
			$firstRow = array();
			foreach ($rows as $row) {
				$firstRow = $row;
				break;
			}
			$cols = array_filter(
				array_keys((array)$firstRow),
				function ($col) {
					return ('@' != substr($col, 0, 1));
				}
			);
		}
		$countCols = count($cols);
		$countCols = ($showLp) ? $countCols + 1 : $countCols;
		{
			$help = array();
			foreach ($cols as $name) {
				$helpMsg = V::get($name, '', $cols_help);
				if (empty($helpMsg)) continue;
				$help[$name] = self::h('i', [
					'class' => "glyphicon glyphicon-question-sign",
					'title' => $helpMsg
				], "");
			}
		}
		// if (empty($cols)) return;
		$hiddenCols = V::get('hidden_cols', array(), $params);

		$tableAttrs = [ 'class' => "table table-bordered table-hover" ];
		$html_id = V::get('__html_id', '', $params);
		if ($html_id) $tableAttrs['id'] = $html_id;
		self::startTag('table', $tableAttrs); echo "\n";
		if ($caption) { self::tag('caption', null, $caption); echo "\n"; }
		if (!empty($cols)) {
			self::startTag('thead', null); echo "\n";
			self::startTag('tr', null); echo "\n";
			if ($showLp) { self::tag('th', [ 'style' => "padding:2px" ], "Lp.");	echo "\n"; }
			foreach ($cols as $colName) {
				if (in_array($colName, $hiddenCols)) continue;
				echo self::h('th', [ 'style' => "padding:2px" ], [
					$colName,
					" " . V::get($colName, '', $help)
				]);
				echo "\n";
			}
			self::endTag('tr'); echo "\n";
			self::endTag('thead'); echo "\n";
		}
		$tbodyAttrs = [];
		if (array_key_exists('@tbody.id', $params)) $tbodyAttrs['id'] = $params['@tbody.id'];
		self::startTag('tbody', $tbodyAttrs); echo "\n";
		if (empty($rows)) {
			self::startTag('tr'); echo "\n";
				self::tag('td', [ 'style' => "padding:2px", 'colspan' => $countCols ], V::get('empty_msg', "Brak danych", $params)); echo "\n";
			self::endTag('tr'); echo "\n";
		} else {
			$i = 0;
			foreach ($rows as $row) {
				$i++;
				$trAttrs = array();
				if (!empty($row['@onClick'])) $trAttrs['onClick'] = $row['@onClick'];
				if (!empty($row['@class'])) $trAttrs['class'] = $row['@class'];
				if (!empty($row['@style'])) $trAttrs['style'] = $row['@style'];
				self::startTag('tr', $trAttrs); echo "\n";
				if ($showLp) { self::tag('th', [ 'style' => "padding:2px; color:#ccc" ], $i); echo "\n"; }
				foreach ($cols as $colName) {
					$rowAttrs = [ 'style' => "padding:{$cellPadding}px" ];
					if (!empty($row["@onClick[{$colName}]"])) $rowAttrs['onClick'] = $row["@onClick[{$colName}]"];
					if (!empty($row["@class[{$colName}]"])) $rowAttrs['class'] = $row["@class[{$colName}]"];
					if (!empty($row["@style[{$colName}]"])) $rowAttrs['style'] .= "; " . $row["@style[{$colName}]"];
					if (in_array($colName, $hiddenCols)) continue;
					self::tag('td', $rowAttrs, V::get($colName, '', $row)); echo "\n";
				}
				self::endTag('tr'); echo "\n";
			}
		}
		self::endTag('tbody'); echo "\n";
		self::endTag('table'); echo "\n";
	}

	public static function startContainer($attrs = array()) {// echo '<div class="container">' . "\n";
		$attrs['class'] = (!empty($attrs['class']))
			? $attrs['class'] . ' ' . 'container'
			: 'container';
		self::startTag('div', $attrs, "\n");
	}
	public static function endContainer() { self::endTag('div', "\n"); }
	public static function startTag($tag, $attrs = array(), $addWhiteSpace = false) {
		$outAttrs = '';
		if (is_array($attrs)) {
			foreach ($attrs as $attrName => $val) $outAttrs .= " {$attrName}=\"{$val}\"";
		}
		echo '<' . $tag . $outAttrs . '>' . self::whiteSpace($addWhiteSpace);
	}
	public static function whiteSpace($addWhiteSpace = false) {
		return (!$addWhiteSpace)
			? ''
			: (true === $addWhiteSpace) ? " " : $addWhiteSpace;
	}
	public static function endTag($tag, $addWhiteSpace = false) {
		echo '</' . $tag . '>' . self::whiteSpace($addWhiteSpace);
	}
	public static function tag($tag, $attrs = array(), $childrens = array(), $addWhiteSpace = false) {
		$whiteSpace = self::whiteSpace($addWhiteSpace);
		self::startTag($tag, $attrs);
		echo $whiteSpace;
		if (!empty($childrens) && is_array($childrens)) throw new Exception("UI::tag() children as nodes not implemented".json_encode($childrens));
		if (is_scalar($childrens)) echo $childrens;
		echo $whiteSpace;
		self::endTag($tag);
		echo $whiteSpace;
	}
	public static function emptyTag($tag, $attrs = array(), $addWhiteSpace = false) {
		$outAttrs = '';
		if (is_array($attrs)) {
			foreach ($attrs as $attrName => $val) $outAttrs .= " {$attrName}=\"{$val}\"";
		}
		echo '<' . $tag . $outAttrs . '/>' . self::whiteSpace($addWhiteSpace);
	}
	public static function link($type, $content, $href, $attrs = array()) {
		$attrs['class'] = V::get('class', '', $attrs);
		$attrs['class'] .= "btn btn-{$type}";
		if (!empty($attrs['className'])) {
			foreach ($attrs['className'] as $cls => $bool) {
				if ($bool) $attrs['class'] .= " {$cls}";
			}
			unset($attrs['className']);
		}
		$attrs['href'] = $href;
		UI::tag('a', $attrs, $content);
	}

	public static function jsAjaxTable($params) {

	}

	public static function price($value, $dec = ',') {
		// TODO: if not number type - string wwith wrong format - try to convert?
		return number_format($value, 2, $dec, ' ');
	}

	public static function inlineJS($jsFile, $jsonVars = []) {
		if (!file_exists($jsFile)) throw new Exception("js file '" . basename($jsFile) . "' not exists!");
		UI::startTag('script', [], "\n");
		echo "(function (global) {" . "\n";
		foreach ($jsonVars as $name => $var) {
			echo "var {$name} = " . json_encode($var) . ";\n";
		}
		include $jsFile;
		echo "})(window)" . "\n";
		UI::endTag('script', "\n");
	}

	public static function inlineRawJS($jsFile) {
		if (!file_exists($jsFile)) throw new Exception("js file '" . basename($jsFile) . "' not exists!");
		UI::startTag('script', [], "\n");
		include $jsFile;
		UI::endTag('script', "\n");
	}

	public static function inlineCSS($cssFile) {
		UI::startTag('style', ['type'=>"text/css"], "\n");
		include $cssFile;
		UI::endTag('style', "\n");
	}

	public static function includeView($viewPath, $data = array()) {
		if (!file_exists($viewPath)) throw new Exception("view file '" . basename($viewPath) . "' not exists!");
		if (false === strpos($viewPath, APP_PATH_ROOT)) throw new Exception("Access Denied to include view '" . basename($viewPath) . "'!");
		if (is_array($data) && !empty($data)) {
			extract($data);
		}
		include $viewPath;
	}

	public static function postButton($label, $params = []) {
		UI::startTag('form', [
			'action' => V::get('action', '', $params),
			'method' => V::get('method', 'post', $params),
			'style' => "display:inline"
		]);
			foreach (V::get('data', [], $params, 'array') as $name => $value) {
				UI::emptyTag('input', ['type'=>'hidden', 'name'=>$name, 'value'=>$value]);
			}
			UI::tag('button', ['type'=>'submit', 'class' => 'btn ' . V::get('class', 'btn-default btn-xs', $params)], $label);
		UI::endTag('form');
	}

	public static function hButtonPost($label, $params = [], $childrens = []) {
		if (!empty($params['data'])) foreach ($params['data'] as $k => $v) $childrens[] = self::h('input', ['type'=>'hidden', 'name'=>$k, 'value'=>$v]);
		if (!empty($params['fields'])) {
			foreach ($params['fields'] as $fieldParams) {
				$childrens[] = self::h('input', $fieldParams);
			}
		}
		$childrens[] = self::h('button', array_merge(
			[
				'type'=>'submit',
				'class' => 'btn ' . V::get('class', 'btn-default', $params),
				'style' => V::get('style', '', $params)
			],
			(!empty($params['title'])) ? ['title' => $params['title']] : []
		), $label);
		return self::h('form', [
			'action' => V::get('action', '', $params),
			'method' => V::get('method', 'post', $params),
			'style' => V::get('form.style', 'display:inline', $params),
			'class' => "form-inline"
		], $childrens);
	}

	public static function hButtonAjax($label, $jsEventPrefix, $params = []) {
		if (!empty($params['data'])) foreach ($params['data'] as $k => $v) $childrens[] = self::h('input', ['type'=>'hidden', 'name'=>$k, 'value'=>$v]);
		$query = V::get('data', '', $params);
		return self::h('a', [
			'class' => V::get('class', 'btn btn-default', $params),
			'style' => V::get('style', '', $params),
			'href' => V::get('href', '', $params),
			'onClick' => "return p5UI__hButtonAjax(this, 'p5UIBtnAjax:{$jsEventPrefix}', '', '" . http_build_query($query) . "')",
		], $label);
	}
	public static function hButtonAjaxOnResponse($jsEventPrefix, $jsCode) {
		echo self::h('script', [], "
			jQuery(document).on('p5UIBtnAjax:{$jsEventPrefix}:response', function(e, n, payload) {
				{$jsCode}
			})
		");
	}
	public static function hButtonAjaxJsFunction() {
		echo UI::h('script', [], "
			function p5UI__hButtonAjax(n, eventNamespace, url, query) {
				var dbg = " . ( DBG::isActive() ? 1 : 0 ) . ";
				var jqNode = jQuery(n);
				var state = {
					href: url || n.href,
					data: query || ''
				}
				jQuery(document).trigger('p5UIBtnAjax:' + eventNamespace + ':click', [n, state])
				if (jqNode.hasClass('disabled')) { // bootstrap already prevent this action
					if (dbg) console.log('WARNING: btn disabled - waiting for response - Cancel?')
					return false
				}
				jqNode.addClass('disabled btn-loading')

				window.fetch(state.href, {
					method: 'POST',
					headers: {
						'Content-Type': 'application/x-www-form-urlencoded' // query string
					},
					credentials: 'same-origin',
					body: state.data // new URLSearchParams(state.data)
				}).then(function(response) {
					return response.json()
				}).then(function(payload) {
					jqNode.removeClass('disabled btn-loading');
					jQuery(document).trigger(eventNamespace + ':response', [n, payload]);
				}).catch(function(e) {
					jQuery(document).trigger(eventNamespace + ':response', [n, 'error' + e]);
					jqNode.removeClass('disabled btn-loading');
					p5UI__notifyAjaxCallback({
						type: 'error',
						msg: 'Request error ' + e
					});
					console.log('loadDataAjax:fetch: ERR:', e);
				})
				return false;
			}
		");
	}
	public static function h($tagName, $params = [], $childrens = []) {
		$emptyTags = [];
		$emptyTags[] = 'hr';
		$emptyTags[] = 'br';
		$emptyTags[] = 'input';
		$emptyTags[] = 'link';
		$emptyTags[] = 'area';
		$emptyTags[] = 'base';
		$emptyTags[] = 'col';
		$emptyTags[] = 'embed';
		$emptyTags[] = 'img';
		$emptyTags[] = 'keygen';
		$emptyTags[] = 'meta';
		$emptyTags[] = 'param';
		$emptyTags[] = 'source';
		$emptyTags[] = 'track';
		$emptyTags[] = 'wbr';
		if (in_array($tagName, $emptyTags)) return '<' . $tagName . (empty($params) ? '' : ' ' . self::hAttributes($params)) . '/>';
		return '<' . $tagName . (empty($params) ? '' : ' ' . self::hAttributes($params)) . '>' . self::hChildrens($childrens) . '</' . $tagName . '>';
	}
	public static function hAttributes($params = []) {
		$attr = [];
		foreach ($params as $k => $v) {
			if (is_array($v)) {
				$attr[] = "{$k}=\"" . implode(" ", $v) . "\"";
			} else {
				$attr[] = "{$k}=\"{$v}\"";
			}
		}
		return implode(" ", $attr);
	}
	public static function hChildrens($childrens = []) {
		if (empty($childrens)) return '';
		if (is_string($childrens)) return $childrens;
		if (!is_array($childrens)) throw new Exception("Unsupported children type");
		return array_reduce(
			$childrens,
			function ($curry, $child) {
				return "{$curry}{$child}";
			},
			""
		);
	}

	/**
	 * @param $taskPerm - 'C', 'W'
	 */
	public static function hGetFormItem($acl, $fieldName, $taskPerm, $fieldID, $fName, $fValue, $params = array(), $record = null) {
		Lib::loadClass('Typespecial');

		if (!$acl->isAllowed($fieldID, $taskPerm, $record)) {
			switch ($taskPerm) {
				case 'R': return "Brak uprawnień do odczytu";
				case 'W': return "Brak uprawnień do zapisu";
				default: return "Brak uprawnień do tego pola ({$taskPerm})";
			}
		}

		if ($fieldName == 'ID') return ''; // TODO: hide primaryKey?

		$colType = $acl->getFieldTypeById($fieldID);
		if (!$colType) return "Error - unknown type";

		$html = new stdClass();
		$html->_params = array();
		$html->tag = 'input';
		$html->childrens = [];
		$html->attrs = array();
		$html->attrs['id'] = $fName;
		$html->attrs['name'] = $fName;
		$html->attrs['type'] = 'text';
		$html->attrs['value'] = htmlspecialchars($fValue);
		if (isset($params['tabindex'])) {
			$html->attrs['tabindex'] = $params['tabindex'];
		}
		if (!$acl->hasFieldPerm($fieldID, $taskPerm)) {
			$html->attrs['disabled'] = 'disabled';
		}
		$maxGrid = V::get('maxGrid', 10, $params);

		if (substr($colType['type'], 0, 3) == 'int'
				|| substr($colType['type'], 0, 7) == 'tinyint'
				|| substr($colType['type'], 0, 8) == 'smallint'
				|| substr($colType['type'], 0, 6) == 'bigint'
		) {
			//$h->Type_value = (int)str_replace(array(' ','(',')'), '', substr($h->Type, 4));
			$html->attrs['type'] = 'number';
			$html->attrs['class'][] = 'input-small';
		}
		else if (substr($colType['type'], 0, 6) == 'double') {
			$html->attrs['type'] = 'text';
			$html->attrs['class'][] = 'input-small';
		}
		else if (substr($colType['type'], 0, 7) == 'decimal') {
			$html->attrs['type'] = 'text';
			$html->attrs['class'][] = 'input-small';
		}
		else if (substr($colType['type'], 0, 7) == 'varchar'
				|| substr($colType['type'], 0, 4) == 'char'
			) {
			//$h->Type_value = (int)str_replace(array(' ','(',')'), '', substr($h->Type, 8));
			$html->attrs['type'] = 'text';
			$maxLength = (int)str_replace(array(' ','(',')'), '', substr($colType['type'], strpos($colType['type'], '(') + 1, -1));
			if ($maxLength > 0) {
				$html->attrs['maxlength'] = $maxLength;
			}
			$valLength = strlen($fValue);
			if (isset($params['widthClass'])) {
				if ($params['widthClass'] == 'inside-modal') {
					$html->attrs['style'] = 'width:98%;';
				} else {
					$html->attrs['style'] = 'width:98%;';
				}
			} else {
				/*
				if ($maxLength < 11) {
					$html->attrs['class'][] = 'span2';
				} else if ($maxLength < 31) {
					$html->attrs['class'][] = 'span5';
				} else if ($maxLength < 51) {
					$html->attrs['class'][] = (8 <= $maxGrid)? 'span8' : "span{$maxGrid}";
				} else if ($maxLength < 101) {
					$html->attrs['class'][] = (10 <= $maxGrid)? 'span10' : "span{$maxGrid}";
				} else {
					$html->attrs['class'][] = (12 <= $maxGrid)? 'span12' : "span{$maxGrid}";
				}
				*/
			}

			if ($maxLength > 255) {// Fix for long varchar - use textarea
				$html->tag = 'textarea';
				$html->childrens[] = htmlspecialchars($fValue);
				$html->attrs['rows'] = '3';
				unset($html->attrs['type']);
				unset($html->attrs['value']);
			}
		}
		else if (substr($colType['type'], 0, 4) == 'date') {
			$testDatePicker = true;
			if ($testDatePicker) {
				$html->attrs['type'] = 'text';
				$html->_params[] = 'date';
				if (substr($colType['type'], 0, 8) == 'datetime') {
					$html->attrs['class'][] = 'se_type-datetime';// datetimepicker';
					$html->attrs['data-format'] = 'yyyy-MM-dd hh:mm';
					$html->attrs['maxlength'] = 19;
				} else {
					$html->attrs['class'][] = 'se_type-date';// datetimepicker';
					$html->attrs['maxlength'] = 10;
				}
				if (substr($html->attrs['value'], 0, 10) == '0000-00-00') {
					$html->attrs['value'] = '';
				}
			} else {
				$html->attrs['type'] = 'date';
			}
		}
		else if ($colType['type'] == 'time') {
			$testDatePicker = true;
			if ($testDatePicker) {
				$html->attrs['type'] = 'text';
				$html->_params[] = 'time';
				$html->attrs['class'][] = 'se_type-time';// datetimepicker';
				$html->attrs['data-format'] = 'hh:mm:ss';
				$html->attrs['maxlength'] = 8;
				if (substr($html->attrs['value'], 0, 8) == '00:00:00') {
					$html->attrs['value'] = '';
				}
			} else {
				$html->attrs['type'] = 'time';
			}
		}
		else if ($colType['type'] == 'timestamp') {
			$testDatePicker = true;
			if ($testDatePicker) {
				$html->attrs['type'] = 'text';
				$html->_params[] = 'date';
				$html->attrs['class'][] = 'se_type-datetime';// datetimepicker';
				$html->attrs['data-format'] = 'yyyy-MM-dd hh:mm';
				$html->attrs['maxlength'] = 19;
				if (substr($html->attrs['value'], 0, 10) == '0000-00-00') {
					$html->attrs['value'] = '';
				}
			} else {
				$html->attrs['type'] = 'date';
			}
		}
		else if (substr($colType['type'], 0, 4) == 'enum') {
			unset($html->attrs['type']);
			unset($html->attrs['value']);
			$html->tag = 'select';

			$values = explode(',', str_replace(array('(',')',"'",'"'), '', substr($colType['type'], 5)));
			$selValue = $fValue;
			if (empty($selValue) && $selValue !== '0' && !empty($colType['default'])) {
				if ($taskPerm == 'C') {
					$selValue = $colType['default'];
				} else if ($taskPerm == 'W' && $acl->isAllowed($fieldID, 'R', $record)) {
					$selValue = $colType['default'];
				}
			}

			$html->childrens[] = [ 'option', [ 'value' => "" ], "" ];
			if (!empty($selValue) && !in_array($selValue, $values)) {
				$html->childrens[] = [ 'option', [ 'value' => $selValue, 'selected' => "selected" ], $selValue ];
			}
			foreach ($values as $val) {
				$html->childrens[] = [ 'option', array_merge(
					[ 'value' => $val ],
					($selValue == $val)
						? [ 'selected' => "selected" ]
						: []
				), $val ];
			}
		}
		else if (substr($colType['type'], 0, 4) == 'text'
			|| substr($colType['type'], 0, 8) == 'tinytext'
			|| substr($colType['type'], 0, 10) == 'mediumtext'
			|| substr($colType['type'], 0, 8) == 'longtext'
		) {
			$html->tag = 'textarea';
			$html->childrens[] = htmlspecialchars($fValue);
			if (isset($params['widthClass'])) {
				if ($params['widthClass'] == 'inside-modal') {
					$html->attrs['style'] = 'width:98%;';
				} else {
					$html->attrs['style'] = 'width:98%;';
				}
			} else {
				//$html->attrs['class'][] = (8 <= $maxGrid)? 'span8' : "span{$maxGrid}";
			}
			$html->attrs['rows'] = '3';
			unset($html->attrs['type']);
			unset($html->attrs['value']);
		}
		else if ('polygon' == $colType['type']) { return '...'; }// Wielokąt
		else if ('multipolygon' == $colType['type']) { return '...'; }// Zbiór wielokątów
		else if ('linestring' == $colType['type']) { return '...'; }// Krzywa z interpolacji liniowej pomiędzy punktami
		else if ('point' == $colType['type']) { return '...'; }// Punkt w przestrzeni 2-wymiarowej
		else if ('geometry' == $colType['type']) { return '...'; }// Typy, które mogą przechowywać geometrię dowolnego typu
		else if ('multipoint' == $colType['type']) { return '...'; }// Zbiór punktów
		else if ('multilinestring' == $colType['type']) { return '...'; }// Zbiór krzywych z interpolacji liniowej pomiędzy punktami
		else if ('geometrycollection' == $colType['type']) { return '...'; }// Zbiór obiektów geometrycznych dowolnego typu
		else {
			return 'unknown Type "'.$colType['type'].'"';
		}
		$html->attrs['class'][] = 'form-control';
		if (!empty($html->attrs['class'])) $html->attrs['class'] = implode(" ", $html->attrs['class']);
		$nodeHtml = (in_array($html->tag, array('select', 'textarea')))
			? [ $html->tag, $html->attrs, $html->childrens ]
			: $nodeHtml = [ $html->tag, $html->attrs ]
		;

		if (in_array('date', $html->_params)) {
			$nodeHtml = [ 'div', [ 'class' => "input-group" ], [
				$nodeHtml,
				[ 'span', [ 'class' => "input-group-addon" ], [
					[ 'span', [ 'class' => "glyphicon glyphicon-calendar" ] ]
				] ]
			] ];
		}
		else if (in_array('time', $html->_params)) {
			$nodeHtml = [ 'div', [ 'class' => "input-group" ], [
				$nodeHtml,
				[ 'span', [ 'class' => "input-group-addon" ], [
					[ 'span', [ 'class' => "glyphicon glyphicon-time" ] ]
				] ]
			] ];
		}

		if (true == V::get('appendBack', '', $params)
				&& !in_array('date', $html->_params)
				&& !in_array('time', $html->_params)
			 ) {
			if ($html->tag == 'input' && $taskPerm == 'W') {
				$nodeHtml = [ 'div', [ 'class' => "input-group show-last-value" ], [
					$nodeHtml,
					[ 'span', [ 'class' => "input-group-addon button-appendBack", 'title' => htmlspecialchars($fValue) ], [
						[ 'span', [ 'class' => "glyphicon glyphicon-arrow-left" ] ]
					] ]
				] ];
			}
		}

		$typeSpecial = Typespecial::getInstance($fieldID, $fieldName);
		if ($typeSpecial) {
			$tsParams = array();
			$tsValue = V::get('typespecialValue', '', $params);
			if (!empty($tsValue)) {
				$tsParams['typespecialValue'] = $tsValue;
			}
			$nodeHtml = [ 'div', [ 'class' => "field-with-typespecial" ], [
				$nodeHtml,
				$typeSpecial->hGetFormItem($acl, $fieldName, $acl->_zasobID, $fName, $fValue, $tsParams, $record),
			] ];
		}

		return $nodeHtml;
	}

	public static function convertHtmlToArray($html) {
		$nodes = [];
		// <a href="index.php?_route=Users&_task=userGroups&usrLogin=michal.podejko">ustal stanowisko</a>
		// [ 'a', [ 'href' => "index.php?_route=Users&_task=userGroups&usrLogin=michal.podejko" ], "ustal stanowisko" ]

		$DBG = 0;
		$pos = 0;
		// TODO: while (true)
		if ('<' === substr($html, $pos, 1)) { // parse tag
			$tagName = ''; $attrs = []; $content = [];
			$endTagOpen = strpos($html, '>', $pos + 1);
			$endTagName = min(strpos($html, ' ', $pos + 1), $endTagOpen); // '<tag>' or '<tag attr="..">'
			if (false === $pos) throw new Exception("Error Processing Html - missing tagName");
			$tagName = substr($html, $pos + 1, $endTagName - $pos - 1);
			if($DBG){echo "\ntagName: '{$tagName}'";}
			if ('>' === substr($html, $endTagName, 1)) {

			} else if (' ' === substr($html, $endTagName, 1)) {
				if (false === $endTagOpen) throw new Exception("Error Processing Html - missing open tag end char");
				$attrs = UI::convertHtmlAttrsToArray(trim(substr($html, $endTagName + 1, $endTagOpen - $endTagName - 1)));
			} else {
				throw new Exception("Error Processing Html - unexpected end tag name char '" . substr($html, $endTagName, 1) . "'");
			}
			if($DBG){echo "\nattrs: '" . json_encode($attrs), "'";}
			// TODO: empty tags '<br>', '<br/>', '<br />', '<input ... />', '<input ... >', img, hr, etc.
			// TODO: nested same tags '<tagName> ... <tagName> ... </tagName> ... </tagName>'
			$closeTagStart = strpos($html, "</{$tagName}>", $endTagOpen + 1);
			if (false === $closeTagStart) throw new Exception("Error Processing Html - missing close tagName");
			if($DBG){echo "\nDBG \$endTagOpen: " . substr($html, $endTagOpen, 5) . "...";}
			if($DBG){echo "\nDBG \$endTagOpen: " . substr($html, $endTagOpen) . ".EOL";}
			if($DBG){echo "\nDBG \$closeTagStart strpos(\$html, '</{$tagName}>', {$endTagOpen} + 1) = '{$closeTagStart}': " . substr($html, $closeTagStart, 5) . "...";}
			$content = substr($html, $endTagOpen + 1, $closeTagStart - $endTagOpen - 1);
			$tag = [ $tagName, $attrs, $content ];
			if($DBG){echo "\n\$tag: ";print_r($tag);}
			$nodes = $tag;
		}
		return $nodes;
	}
	public static function convertHtmlAttrsToArray($strAttrs) {
		$attrs = [];
		if (!preg_match_all('((\w+)=\"([^"]*)\")', $strAttrs, $matches)) {
			// echo "DBG:: empty attrs or wrong syntax";
			return [];
		}
		$total = (count($matches) - 1) / 2;
		// echo "\n\$matches (total = {$total}) = ";print_r($matches);
		for ($i = 0; $i < $total; $i++) {
			$idx = $i * 2 + 1;
			// echo "\n\$attrs[ '{$matches[$idx][0]}' ] = '{$matches[$idx+1][0]}';";
			$attrs[ $matches[ $idx ][0] ] = $matches[ $idx + 1 ][0];
		}
		return $attrs;
	}

}