/includes/functions/html_output.php

Модуль представляет собой набор функций, позволяющих формировать отдельные элементы HTML страниц.

function tep_href_link($page = '', $parameters = '', $connection = 'NONSSL', $add_session_id = true, $search_engine_safe = true);
Функция возвращает значение для гипертекстовой ссылки с учетом адреса сайта, страницы $page для перехода, и параметров $parameters для этой страницы. При этом значения параметров очищаются от двойных кавычек - они замещаются на " Кроме этого, по-умолчанию в параметры ссылки добавляется идентификатор сессии клиента. Пример использования: tep_href_link('page.php','user=1&greatings="0"') вернет что-то в виде: http://server.name/page.php?user=1&greatings="0"&osCsid=123kuhy814. При использовании параметра $search_engine_safe вовзращаемый результат видоизменяется - при этом в нем символы '&' и '=' замещаются на '/'.
function tep_image($src, $alt = '', $width = '', $height = '', $parameters = '');
Функция формирует HTML-форматированный тэг для отображения заданной $src картинки с размерами $width х $height. При этом учитывается необходимость масштабирования картинки в соответствии с установками магазина. Значение $parameters вставляется в тэг перед его закрытием, что позволяет, например задавать реакцию бразуера на события: например onClick(). $alt - альтернативное название каритнки, если не браузер не сможет найти ее по оригинальному пути.
function tep_image_resample($src,$width,$height);
Производит при необхолдимости коррекцию имени картинки. При этом определяются параметры исходного изображения, при необходимости создается новый файл с заданными размерами и возвращается ссылка на новое изображение.
function tep_image_submit($image, $alt = '', $parameters = '');
Функция возвращает HTML-тэги для кнопки отправки данных на сервер, используя $image в качестве изображения кнопки, или в виде стандартной книпки с надписью $alt , если изображение не задано. Переменной $parameters  может быть задано дополнительное действие при событиях, связанных с этой кнопкой.
function tep_image_button($image, $alt = '', $parameters = '');
Функция возвращает HTML-тэги для изображения, с учетом текущего языка.
function tep_draw_separator($image = 'pixel_black.gif', $width = '100%', $height = '1');
Функция возвращает HTML-тэги для разделителя.
function tep_draw_form($name, $action, $method = 'post', $parameters = '');
Функция возвращает HTML-тэги для начала формы, спользуя имя формы $name, скрипт, на который надо передать управление $action с учетом заданного метода (post,get). В параметрах можно задать реакцию на события.
function tep_draw_input_field($name, $value = '', $parameters = '', $type = 'text', $reinsert_value = true);
Функция возвращает HTML-тэги поля ввода используя его имя $name, со значением по-умолчанию $value и описанием событий $parameters. По-умолчанию используется тип text - который можно поменять на любой другой со сходным описанием. Если установлен параметр $reinsert_value - то для поля ввода будет определено, были ли на данной странице переданы параметры с заданным именем. Так, если форма ввода имени пользователя при ошибке вернется на страницу, в которой будет строится поле ввода с именем, сходным с параметром, переданным исходной страницей - параметр будет подставлен в поле как значение по-умолчанию.
function tep_draw_password_field($name, $value = '', $parameters = 'maxlength="40"');
Функция использует свойства предыдущей функции для отображения поля "пароля" - т.е. поля со скрытым вводом.
function tep_draw_checkbox_field($name, $value = '', $checked = false, $parameters = '');
Функция возвращает HTML-тэги для поля ввода типа checkbox с заданным именем и заданной меткой. При этом используется его состояние  $checked .
function tep_draw_radio_field($name, $value = '', $checked = false, $parameters = '');
Функция возвращает HTML-тэги для поля ввода типа radio button с заданным именем и заданной меткой. При этом используется его состояние  $checked .
function tep_draw_textarea_field($name, $wrap, $width, $height, $text = '', $parameters = '', $reinsert_value = true);
Функция возвращает HTML-тэги для поля в виде textarea с именем $name, шириной  $width, высотой $height с содержимым $text . Параметр $wrap описывает разрешение переноса строки(hard,soft,off).
function tep_draw_hidden_field($name, $value = '', $parameters = '');
Функция возвращает HTML-тэги для невидимого на странице поля ввода, используя его имя $name и значение $value.
function tep_hide_session_id();
Функция возвращает HTML-тэги для невидимого на странице поля ввода с текущей сессией.
function tep_draw_pull_down_menu($name, $values, $default = '', $parameters = '', $required = false);
Функция возвращает HTML-тэги для поля ввода вида Select (выпадающее меню) с именем $name. В параметре $values передается массив из элементов ассоциативного массива с ключевыми значениями 'id' и значениями 'text'.
function tep_get_country_list($name, $selected = '', $parameters = '');
Функция возвращает HTML-тэги для поля выпадающего меню со списком стран.