Comfunctions


NAME

Comfunctions.pl — Модуль общих функций (работа с БД, системой, перевод дат и т.д.)

Наверх


SYNOPSIS

Модуль общих функций (работа с БД, системой, перевод дат и т.д.)

Наверх


DESCRIPTION

Модуль общих функций (работа с БД, системой, перевод дат и т.д.). Присутствуют функции, нужные всем остальным модулям.

[SOAP]downlist

Заполнение раскрывающегося списка набором элементов из таблицы. Если задан исключенный_элемент, то он не выводится.

Вызов:
&downlist("имя_таблицы без _tbl","имя_смыслового_поля"[,"исключенный_элемент_(id)"]);

Примеры вызова:
 &downlist("interface","interface_fld");
 &downlist("interface","interface_fld","43");
Примечания:
Нет.

Зависимости:
Нет.

[SOAP]downlist_sel

Заполнение раскрывающегося списка набором элементов из таблицы и выбором элемента по умолчанию.

Вызов:
&downlist_sel("имя_таблицы без _tbl","имя_смыслового_поля","выделенный_элемент_(id)");

Пример вызова:
 &downlist_sel("template","template_fld",$th{'template_id'});
Примечания:
Нет.

Зависимости:
Нет.

downlist_sel

Заполнение раскрывающегося списка набором элементов из таблицы и выбором элемента по умолчанию.

Вызов:
&downlist_sel("имя_таблицы без _tbl","имя_смыслового_поля","выделенный_элемент_(id)");

Пример вызова:
 &downlist_sel("template","template_fld",$th{'template_id'});
Примечания:
Нет.

Зависимости:
Нет.

[SOAP]downlist2

Заполнение раскрывающегося списка набором элементов из таблицы (два смысловых поля).

Вызов:
&downlist2("имя_таблицы без _tbl","имя_смыслового_поля1","имя_смыслового_поля2","исключенный_элемент_(id)");

Пример вызова:
 &downlist2("template","template_id","template_fld","43");
Примечания:
Нет.

Зависимости:
Нет.

[SOAP]downlist2_sel

Заполнение раскрывающегося списка набором элементов из таблицы (два смысловых поля) и выбором элемента по умолчанию.

Вызов:
&downlist2_sel("имя_таблицы без _tbl","имя_смыслового_поля1","имя_смыслового_поля2","выделенный_элемент_(id)");

Пример вызова:
 &downlist2_sel("template","template_id","template_fld","43");
Примечания:
Нет.

Зависимости:
Нет.

add_record

Добавление записи в таблицу (SOAP). M-версия делает то же, но с локальной БД.

Вызов:
&add_record("имя_таблицы");

Пример вызова:
 &add_record("page_tbl");
Примечания:
Данные полей записи задаются %FORM.

Зависимости:
decrypt.

edit_record

Изменение записи в таблице (SOAP). M-версия делает то же, но с локальной БД.

Вызов:
&edit_record("имя таблицы");

Пример вызова:
 &edit_record("page_tbl");
Примечания:
Данные полей записи задаются %FORM.

Зависимости:
decrypt.

[M]del_record

Удаление записи из таблицы (SOAP). M-версия делает то же, но с локальной БД.

Вызов:
&del_record("имя таблицы");

Пример вызова:
 &del_record("page_tbl");
Примечания:
Данные полей записи задаются %FORM.

Зависимости:
decrypt.

feature_down_sep

Вывод таблицы для назначения набора характеристик типа ``есть/нет'' с разделением на группы.

Вызов:
&feature_down_sep("имя_таб_объекта без _tbl","имя_таб_свойств без _tbl","имя_таб_соответствия","имя_таб_разделителя без _tbl","имя_поля разделителя","имена_смысловых_полей");

Пример вызова:
 &feature_down_sep("user","function","userfunction_tbl","funcgroup","funcgroup_fld","menuname_fld","function_fld");

Пример вывода появится позже.

Примечания:
Данные полей записи задаются %FORM.

Зависимости:
Нет.

feature_edit

Назначение набора характеристик типа ``есть/нет''.

Вызов:
&feature_edit("имя_таб_объекта без _tbl","имя_таб_свойств без _tbl","имя_таб_соответствия");

Пример вызова:
 &feature_edit("user","function","userfunction_tbl");
Примечания:
Нет.

Зависимости:
decrypt.

del_rel

Удаление записей из таблицы в соответствии с имеющимися параметрами.

Вызов:
&del_rel("имя_таблицы");

Пример вызова:
 &del_rel("page_tbl");
Примечания:
Параметры передаются через %FORM.

Зависимости:
decrypt.

date_to_rus

Возвращает дату, отформатированную в российском стандарте (22.06.2000 г.).

Вызов:
&date_to_rus("дата в формате MySQL (yyyy-mm-dd)");

Пример вызова:
 &date_to_rus("2003-08-05");
Примечания:
Пока без.

Зависимости:
Нет.

timestamp_to_rus

Возвращает дату, отформатированную в российском стандарте (22.06.2000 г.).

Вызов:
&timestamp_to_rus("дата в формате MySQL timestamp (yyyymmddHHMMSS)");

Пример вызова:
 &timestamp_to_rus("20030805132000");
Примечания:
Пока без.

Зависимости:
Нет.

logpass

Возвращает в форму поля ID сессии, типа раздела, раздела, предыдущего действия и формы предыдущего возврата.

Вызов:
&logpass();

Пример вывода:
 <input type="hidden" name="CGISESSID" value="ed5499aa992f4f1eff09e8c0b445b005">
 <input type="hidden" name="gc" value="7">
 <input type="hidden" name="fform" value="11">
 <input type="hidden" name="prev_act" value="edit_rel1">
 <input type="hidden" name="prev_returnact" value="edit_page">
Примечания:
Пока без.

Зависимости:
Нет.

logpass_gc

Возвращает в форму поле ID сессии.

Вызов:
&logpass_gc();

Пример вывода:
 <input type="hidden" name="CGISESSID" value="ed5499aa992f4f1eff09e8c0b445b005">
Примечания:
Пока без.

Зависимости:
Нет.

logpass_func

Возвращает в форму поле ID сессии.

Вызов:
&logpass_gc();

Пример вывода:
 <input type="hidden" name="CGISESSID" value="ed5499aa992f4f1eff09e8c0b445b005">
Примечания:
Пока без.

Зависимости:
Нет.

limit_rows_set

Возвращает форму для навигации по результирующему набору порциями.

Вызов:
&limit_rows_set("текст запроса SELECT","количество_записей_в_порции", "дополнительные параметры для вывода формы");

Пример вызова:
 &limit_rows_set("SELECT page_id from page_fld",10,'<input type="hidden" name="act" value="add_record">');
Примечания:
Как дополнительный параметр можно передавать, например, HTML-код полей (как в примере). Всё зависит от деталей реализации. :)

Зависимости:
logpass, rows_count_set.

rows_count_set

Подсчет количества строк в результирующем наборе.

Вызов:
&rows_count_set("текст_запроса");

Пример вызова:
 &rows_count_set("SELECT page_id from page_fld");
Примечания:
Функция учитывает все особенности запроса, т.е. передаётся обычный запрос.

Зависимости:
Нет.

array2in

Преобразование входного массива в список, разделенный запятыми, используется для составления параметра SQL-функции IN.

Вызов:
&array2in("массив");

Пример вызова:
 &array2in(@$refers);
Примечания:
Нет.

Зависимости:
Нет.

get_master_pages

Получение (рекурсивно) ID всех родителей данной страницы.

Вызов:
&get_master_pages($page_id);

Пример вызова:
 &get_master_pages(8);
Примечания:
Рекурсивно вызывает сам себя.

Зависимости:
Нет.

level

Определение уровня страницы (имеется в виду уровень вложенности в структуре меню).

Вызов:
&level($page_id);

Пример вызова:
 &level(8);
Примечания:
Нет.

Зависимости:
Нет.

refers_ary

Составление массива вышестоящих страниц. Возвращает массив с id вышестоящих страниц в порядке от верхнего уровня к нижнему.

Вызов:
&refers_ary("page_id");

Пример вызова:
 &refers_ary("8");
Примечания:
Нет.

Зависимости:
Нет.

extract_content

Извлечение из страницы всего текста между ``тэгами'' <!--\\START\\--> и <!--\\END\\-->.

Вызов:
&extract_content("имя_файла");

Пример вызова:
 &extract_content("/ssi/index.shtml");
Примечания:
Имя файла задаётся в виде абсолютного пути от корня сайта, например, /ssi/index.shtml.

Зависимости:
Нет.

print_template

Печать страницы в принт_шаблоне, если он определён для страницы.

Вызов:
&print_template($page_id);

Пример вызова:
 &print_template(8);
Примечания:
Нет.

Зависимости:
extract_content.

edit_keywords

Получение массива родителей данной страницы и вывод их в таблицу для подключения ключевых слов из них.

Вызов:
&edit_keywords();

Пример вызова:
 &edit_keywords();
Примечания:
Параметры передаются через %FORM.

Зависимости:
get_master_pages, get_setting.

module_settings_list

Получение HTML-кода списка настроек модуля.

Вызов:
&module_settings_list("имя_модуля");

Пример вызова:
 &module_settings_list("poll");
Примечания:
Нет.

Зависимости:
logpass.

get_id_by_URL

Получение из БД ID страницы, максимально подходящей по списку параметров CGI к текущей.

Вызов:
&get_id_by_URL($url);

Пример вызова:
 &get_id_by_URL($url);
Примечания:
Pre-Alpha version. Do not use for production!

Зависимости:
Нет.

get_result_message

Получение результата операции по параметрам.

Вызов:
&get_result_message();

Пример вызова:
 &get_result_message();
Примечания:
Нет.

Зависимости:
extract_fld.

extract_fld

Выдаёт из БД значение ``поле_fld'', соответствующее значению ``поле_id'', по строке вида ``поле_id|поле_fld''.

Вызов:
&extract_fld($строка_вида_"поле_id|поле_fld");

Пример вызова:
 &extract_fld($1);
Примечания:
Нет.

Зависимости:
Нет.

Наверх


AUTHOR

DAY, Method Lab.

Наверх


BUGS

No known ones yet. ;))

Наверх


SEE ALSO

Наверх


COPYRIGHT

© Copyright 2003, Method Lab

Наверх

 Comfunctions