Различия

Здесь показаны различия между двумя версиями данной страницы.

--- abills:docs:manual:admin:form_templates [2016/02/03 17:01]
asmodeus
+++ abills:docs:manual:admin:form_templates [2017/10/23 16:09] (текущий)
anton [Шаблоны системы]
@@ Строка 1: / Строка 1: @@
-====Шаблоны системы====
+=====Шаблоны системы=====
-''/ System configuration/ Misc/ Template/''
+''/ Настройка / Другое / Шаблоны /''
-Правка шаблонов. Вся визуализация систему построена на темплейтах поэтому можно изменять вид за своим усмотрением. После изменения шаблонов они сохраняются в каталоге abills/Abills/templates и загружаются вместо системных. Чтобы опять вернутся к системным темплейтам нужно просто вытереть Вами созданные темплейты.\\ Система поддерживает шаблоны в формате HTML и PDF.
+**Правка шаблонов**.
-Для удобства был создан редактор HTML  шаблонов. Система разрешает загружать уже готовые шаблоны через веб интерфейс администратора.
+Большая часть HTML видов системы написана на шаблонах, и благодаря этому, можно изменять вид за своим усмотрением. \\
-\\
+Для удобства был создан редактор HTML шаблонов. Система разрешает загружать уже готовые шаблоны через веб интерфейс администратора. \\
-Переменные в шаблоне указываются в следующего вида %VARIABLE%. В процессе отображения они заменяются значениями.\\
+После изменения шаблонов они сохраняются в каталоге abills/Abills/templates и загружаются вместо системных. Чтобы опять вернуться к системным шаблонам нужно, просто удалить созданные Вами шаблоны.\\
+Система поддерживает шаблоны в формате HTML и PDF.
+\\
+** Переменные в шаблонах **\\
+Доступны все языковые переменные загруженного словаря. Для подстановки укажите имя переменной в формате ''_{KEY_NAME}_'' \\
+Пример:
+<code>
+  <p>_{CITY}_</p>
+</code>
+Переменные, которые приходят из билинга, в шаблоне указываются в формате %VARIABLE%. В процессе отображения они заменяются значениями.\\
 **Например:**\\
   <input type=text name=FIO value='%FIO%'>
-Если в переменной указать знак равно ( = ) то значение после него будет использоваться как значение по умолчанию при не заполненном поле.\\
+Если в переменной указать знак равно ( = ), то значение после знака будет использоваться как значение по умолчанию при не заполненном поле.\\
 **Пример:**\\
@@ Строка 23: / Строка 36: @@
 \\
-В редакторе HTML шаблонов теги <textarea... конвертируются в <__textarea__.., а при сохранени шаблона конвертируются в обратном порядке: <__textarea__.. на  <textarea... .\\
+В редакторе HTML шаблонов теги <textarea... конвертируются в <_textarea_.., а при сохранени шаблона конвертируются в обратном порядке: <_ textarea_.. на  <textarea... .\\
 Для добавления дополнительных информационных полей в шаблон нужно указывать названия поля в базе В ВЕРХНЕМ РЕГИСТРЕ.\\
@@ Строка 46: / Строка 59: @@
 ''abills/Abills/templates/Cards_cards_print.tpl'' \\ \\
-===PDF  шаблоны===
+====PDF  шаблоны====
-В системе имеется возможность работы с шаблонами в PDF формате. Для работы с PDF файлами нужно установить в системе модуль [[abills:docs:manual:soft:pdf_api2|PDF::API2]]. Шаблоны PDF состоят из 2 частей сам шаблон - файл с расширением .pdf и описание шаблона файл с расширением .dsc. Для преобразования документов с формата MS Word в PDF лучше всего использовать программу OpenOffice Writer из пакета [[http://www.openoffice.org/ru/|OpenOffice]].
+[[abills:docs:manual:admin:form_templates:pdf| работа с PDF шаблонами ]]
+====Кастомные меню====
-для PDF  шаблонов
+**client_menu.tpl**  - Настраиваемое меню абонента
-''abills/Abills/templates/Cards_cards_print.pdf'' \\
+**admin_menu.tpl** - Настраиваемое меню администраторов
-''abills/Abills/templates/Cards_cards_print.dsc'' \\
-если используете индивидуальные  pdf  шаблоны обязательно нужно создать индивидуальный текстовый шаблон (.tpl) данного вида чтобы созданные pdf шаблоны отображались
+**Формат**
+**Клиентский кабинет**
+:0:$lang{USER_INFO}:form_info:::
+:0:$lang{FINANCES}:form_finance:::
+:0:Интернет:dv_user_info::Dv:
+**Админский кабинет**
+:0:$lang{LOGINS}:form_users_list:::
+:0:$lang{PAYMENTS}:report_payments:::
+Описание параметров
+^10| Номер меню |
+^0|Номер основного меню |
+^$lang{USER_INFO}|Название меню |
+^form_info|Название функции  |
+^  |Дополнительные  параметры  |
+^Dv|Модуль функции |
-==формат файла .dsc==
+**Пример**
-VARIABLE:DESCRIBE:LANGUAGE:PARAMETЕRS:DEFAULT_VALUE:EXPRATION:
-^VARIABLE|переменная подставляемая в шаблоне|
+В клиентском кабинете отобразится наше меню, которое мы записали в файл:
-^DESCRIBE|Описание переменной |
-^LANGUAGE|язык вставки. если шаблоны на нескольких языках|
-^PARAMETЕRS| Дополнительные параметры |
-^DEFAULT_VALUE|Дополнительные параметры (опциональный параметр) |
-^EXPRATION|Выражение преобразует входящее значение  (опциональный параметр). Выражения в формате perl expression\\ **Пример**: \\ Удалить буквенный префикс \\ [a-zA-Z]/\\ |
-==Параметры используемые в шаблонах==
+{{:abills:docs:manual:admin:custom_client_menu.png|}}
-Параметры шаблона разделяются точкой с запятой (;). Если нужно установить требуемую метку на нескольких страницах параметры шаблона берутся в кавычки и описание каждой метки разделяется запятой (,) \\
-**Пример**\\
-  FIO:Ф.И.О.:russian:(x=105;y=645,x=200;y=578;page=2)
-Общие параметры
+В админском кабинете отобразится следующее меню, при такой структуре файла admin_menu.tpl:
-^x,y=    | Координаты метки x,y. Если координаты не заданы метка игнорируется |
-^page= | страница документа. (по умолчанию 1) |
-^font_name= | Название шрифта. |
-Система поддерживает встроенные  Adobe Core Fonts
-      Courier
-      Courier-Bold
-      Courier-BoldOblique
-      Courier-Oblique
-      Helvetica
-      Helvetica-Bold
-      Helvetica-BoldOblique
-      Helvetica-Oblique
-      Symbol
-      Times-Bold
-      Times-BoldItalic
-      Times-Italic
-      Times-Roman
-      ZapfDingbats
-также 'Windows Fonts':
-      Georgia
-      Georgia,Bold
-      Georgia,BoldItalic
-      Georgia,Italic
-      Verdana
-      Verdana,Bold
-      Verdana,BoldItalic
-      Verdana,Italic
-      Webdings
-      Wingdings
-и True-Type Fonts
-которые нужно загружать в папку **/usr/abills/Abills/templates/fonts/**
-^font_size= | Размер шрифта |
-^font_color=| Цвет шрифта. (black, green, blue, yellow, red, #rrggbb, !hhssvv, %ccmmyykk) |
-^encode=    | кодировка шрифта (по умолчанию windiws-1251) |
-^align=     | выравнивание текста |
-^step=     | Иногда возникает необходимость отображать слова с интервалами между буквами. Расстояние указывается в пикселях |
-вставка текста из файла
-^text        | Название текстового файла. Файл должен быть размещён в каталоге $conf{TPL_DIR}. При отсутствии файла система сообщает об ошибке |
-^text_height | Высота текстового поля |
-^text_width  | Ширина текстового поля |
-Вставка изображений в формате .jpg
-^img       | Название графического файла. Файл должен быть размещён в каталоге $conf{TPL_DIR}. При отсутствии файла система сообщает об ошибке|
-^img_height| Высота картинки |
-^img_width | ширина картинки |
-===Дополнительные параметры шаблонов писем===
-Если шаблон письма нужно дополнить какой то служебно информацией (Subject, X-Priority и т.д.), нужно в самом верху шаблона указать данные переменные по одной в каждой строке. После дополнительных переменных нужно отступить два пробела и только тогда начинать тело письма. Если строка начинается на решётку #  её система не обрабатывает. Переменные указанные в шаблоне имеют более высокий приоритет чем эти же значения в системе.
-\\
-**Пример** \\
-Нужно изменить тему писем \\
-  Subject: Новая тема
-  Здравствуйте %FIO%,
-  Ваш депозит %DEPOSIT%
+{{:abills:docs:manual:admin:custom_admin_menu.png|}}
 ====Дополнительно====
 *  [[abills:docs:docs:photoshop|Альтернативный вариант работы с PDF-шаблонами]]