<?php

# v.1.42 - ключи values - всегда числа с обычной нумерацией
# v.1.41 - исправили баг в вызове htmlspecialchars() 
           # (второй аргумент нельзя было передавать как FALSE)
		   # и заодно убрали ini_get() для сочетания "PHP < 5.6 и не UTF-8"
# v.1.40 - упростили обработку checkbox: убрали вычисление checked, value приняли всегда равным 1
# v.1.35 - attr обрабатываются htmlspecialchars() 
# v.1.34 - ini_get() для PHP меньше 5.6 для п.1.33
# v.1.33 - временный фикс для htmlspecialchars (стр. 119)
# v.1.32* - === strval() вместо == при сравнении
# v.1.31 - string as template
# v.1.30 - wrapper (20.04.2015)
# v.1.20* - values можно указывать в виде функции, которой передается запрос
# v.1.10 - при наличии template в результат добавлен ключ html
# (* - важно даже для сугубо серверной версии)

function make_form_data($config, $query, $templates_lib_dir = FALSE) {
	
	// Note: вложенные ключи и возможность конфигурации по каждому в отдельности:
	// слияние с общей по простому "+"
	
	$form = array();
	
	foreach ($config as $name => $field) {
		
		if ($field === TRUE) 
			$field = array();
		
		if (is_numeric($name)) {
			$name = $field;
			$field = array();
		}
		// elseif ($field === 'checkbox') { // с версии 1.40 checkbox отдельно не обрабатываем
			// $field = array('value' => 1);
		// }
		elseif (is_string($field) AND preg_match("'\[([\w;\s]+)\]'", $field, $matches)) {
			$field = array();
			$field['keys'] = array_map('trim', explode(';', $matches[1]) );
		}
		
		if (!isset($field['name'])) // во вложенный шаблон ^KEY не передашь,
		 	$field['name'] = $name;  // так что дублируем
		else 
			$field['name'] .= '[' . $name . ']'; // рассчитано на рекурсивный вызов
		
		if (isset($field['attr']))
			$field['attr'] = array_map('htmlspecialchars', $field['attr']);
		
		if (isset($field['keys'])) {
			
			// Если поле в запросе соответствует массиву - разбираем рекурсивно
			// ("срезаем" один уровень вложенности: например, если есть price[min],
			// то конструируем массив с конфигурацией полей, состоящий из единственного
			// элмента - 'min' => (здесь конфигурация для price), и "запрос", 
			// тоже из единственного элемента - 'min' => (здесь значение, к примеру,
			// $_GET[price][min]). 
			
			$fn = __FUNCTION__;
			$stub = $field;   // сохраняем полученную конфигурацию в копии,
			$field = array(); // т.к. структура данных поля изменится
			                  // и его нужно набирать заново
			foreach ($stub['keys'] as $n => $k) {
				
				// $nm - имя ключа подмассива
				
				if (!is_array($k)) { // эта ветка массива дальше не имеет вложенности
					$nm = $k;         // имя ключа указано в виде простого скаляра
					$cp = $stub;
					unset($cp['keys']); // дальше рекурсия не нужна - ключи из копии убираем совсем
				}
				else { // следующий уровень - в свою очередь является массивом
					$nm = $n; // от него берем имя ключа и передаём его содержимое, 
					          // дополняя содержимым родительского
					          // Но! Если у дочернего пуст элемент keys - убираем его вовсе
					          // (т.к. он является путем рекурсии)
					$cp = $k + $stub;
					if (!isset($k['keys']))
						unset($cp['keys']);
				}
				
				$tmp_fields = array($nm => $cp);
				
				$tmp_query = (isset($query[$name][$nm]))
					        ? array($nm => $query[$name][$nm])
					        : array();
				
				$field += $fn($tmp_fields, $tmp_query); 
			}
			
		}
		else {
		
			if (isset($field['values'])) {
				// checkbox или любое множественное поле
				
				if (is_callable($field['values'])) 
					$field['values'] = $field['values']($query);
				
				// С версии 1.42 (25.10.2016) в качестве ключей values используем порядковые номера элементов, поскольку использование в качестве ключа самих значений может вызвать проблемы (например, если значением является пустая строка - актуально для первой, "пустой", опции <select>).
				// Для этого нужно переписать массив заново.
				
				$tmp = array();
				
				foreach ($field['values'] as $k => $v) {
					if (!is_array($v)) 
						$v = array(
								'value' => (is_numeric($k) ? $v : $k),
								'title' => $v, 
							);
					
					if (isset($query[$name])) 
						$v['chosen'] = (is_array($query[$name])) // Сразу для множественных полей
										   ? in_array(strval($v['value']), $query[$name], TRUE ) 
										   : strval($v['value']) === $query[$name] ;
						// chosen - компромисс между checked и selected
						// для сравнения нужно использовать именно strval() и ===, а не просто ==
						// т.к. value="" и value="0" - это разные вещи
					
					$tmp[] = $v;
				}
				
				$field['values'] = $tmp;
				
				unset($tmp);
				
				// Добавляем пустой элемент
				if (isset($field['blank']))
					array_unshift(
							$field['values'], 
							array('title' => $field['blank'])
						);
			}
			
			// elseif (isset($field['value'])) // checkbox // убрали с версии 1.40
				// $field['checked'] = (isset($query[$name]) AND $query[$name] == $field['value']);
			
			else // обычное одиночное поле - <input type="text"> или <textarea>
				$field['value'] = (isset($query[$name]))
				                ? htmlspecialchars($query[$name])
				                : '' ;
		}
		
		$form[$name] = $field;
	}
	
	# Экспериментальная возможность - генерация HTML.
	
		// Позволяет писать более короткий код шаблонов засчет сокращения
		// вложенности результирующего массива (каждому полю соответствует
		// конечная HTML-строка вместо массива с данными поля), а также
		// избавляет от необходимости писать длинные пути к дефолтным шаблонам.
		// 
		// Использование wrapper'ов (шаблонов-оберток) позволяет легко менять
		// окружение поля, пользуясь при этом сокращенной записью для его HTML.
		// например, <label>текст {*html*}</label> (не будь предварительной
		// генерации html, пришлось бы писать <label>текст {* + *template* *}</label>)
		
		if (!$templates_lib_dir)
			$templates_lib_dir = __DIR__ . '/form-inputs/';
		
		$fn = 'websun_parse_template';
		
		foreach ($form as &$field) 
			
			if (isset($field['template'])) {
				
				if (preg_match('/^[\w-]+$/', $field['template'])) {
					$tmp = $templates_lib_dir . "$field[template].tpl";
					if (is_file($tmp)) 
						$field['template'] = $tmp;
					unset($tmp);
				}
				
				$fn = 'websun_parse_template';
				if (preg_match('/\.tpl$/', $field['template'])) 
					$fn .= '_path';
				$html = $fn($field, $field['template']);
				unset($fn);
				
				if (isset($field['wrapper']) AND $field['wrapper']) {
					$field['html'] = $html; // для использования внутри wrapper
					$fn = 'websun_parse_template';
					if (preg_match('/\.tpl$/', $field['wrapper']))
						$fn .= '_path';
					$field = $fn($field, $field['wrapper']);
					unset($fn);
				}
				else
					$field = $html;
			}
	
	return $form;
}

?>