Различия

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

--- abills:docs:manual:admin:form_templates [2016/04/22 11:32]
anton
+++ abills:docs:manual:admin:form_templates [2017/10/23 16:09] (текущий)
anton [Шаблоны системы]
@@ Строка 1: / Строка 1: @@
-====Шаблоны системы====
+=====Шаблоны системы=====
 ''/ Настройка / Другое / Шаблоны /''
-Правка шаблонов. Вся HTML часть системы построена на шаблонах поэтому можно изменять вид за своим усмотрением. \\
+**Правка шаблонов**.
-После изменения шаблонов они сохраняются в каталоге abills/Abills/templates и загружаются вместо системных. Чтобы опять вернуться к системным шаблонам нужно, просто удалить созданные Вами шаблоны.\\ Система поддерживает шаблоны в формате HTML и PDF.
+Большая часть HTML видов системы написана на шаблонах, и благодаря этому, можно изменять вид за своим усмотрением. \\
+Для удобства был создан редактор HTML шаблонов. Система разрешает загружать уже готовые шаблоны через веб интерфейс администратора. \\
+После изменения шаблонов они сохраняются в каталоге abills/Abills/templates и загружаются вместо системных. Чтобы опять вернуться к системным шаблонам нужно, просто удалить созданные Вами шаблоны.\\
+Система поддерживает шаблоны в формате HTML и PDF.
 \\
-Для удобства был создан редактор HTML шаблонов. Система разрешает загружать уже готовые шаблоны через веб интерфейс администратора.
-\\
+** Переменные в шаблонах **\\
-Переменные в шаблоне указываются в формате %VARIABLE%. В процессе отображения они заменяются значениями.\\
+Доступны все языковые переменные загруженного словаря. Для подстановки укажите имя переменной в формате ''_{KEY_NAME}_'' \\
+Пример:
+<code>
+  <p>_{CITY}_</p>
+</code>
+Переменные, которые приходят из билинга, в шаблоне указываются в формате %VARIABLE%. В процессе отображения они заменяются значениями.\\
 **Например:**\\
   <input type=text name=FIO value='%FIO%'>
@@ Строка 48: / Строка 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  шаблонов
-''abills/Abills/templates/Cards_cards_print.pdf'' \\
-''abills/Abills/templates/Cards_cards_print.dsc'' \\
-если используете индивидуальные  pdf  шаблоны обязательно нужно создать индивидуальный текстовый шаблон (.tpl) данного вида чтобы созданные pdf шаблоны отображались
-==формат файла .dsc==
-VARIABLE:DESCRIBE:LANGUAGE:PARAMETЕRS:DEFAULT_VALUE:EXPRATION:
-^VARIABLE|переменная подставляемая в шаблоне|
-^DESCRIBE|Описание переменной |
-^LANGUAGE|язык вставки. если шаблоны на нескольких языках|
-^PARAMETЕRS| Дополнительные параметры |
-^DEFAULT_VALUE|Дополнительные параметры (опциональный параметр) |
-^EXPRATION|Выражение преобразует входящее значение  (опциональный параметр). Выражения в формате perl expression\\ **Пример**: \\ Удалить буквенный префикс \\ [a-zA-Z]/\\ |
-==Параметры используемые в шаблонах==
-Параметры шаблона разделяются точкой с запятой (;). Если нужно установить требуемую метку на нескольких страницах параметры шаблона берутся в кавычки и описание каждой метки разделяется запятой (,) \\
-**Пример**\\
-  FIO:Ф.И.О.:russian:(x=105;y=645,x=200;y=578;page=2)
-Общие параметры
-^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%
 ====Кастомные меню====
@@ Строка 154: / Строка 69: @@
 **Формат**
+**Клиентский кабинет**
+: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:::
-:0:$_USER_INFO:form_info:::
-:0:$_FINANCES:form_finance:::
 Описание параметров
@@ Строка 162: / Строка 83: @@
 ^10| Номер меню |
 ^0|Номер основного меню |
-^$_USER_INFO|Название меню |
+^$lang{USER_INFO}|Название меню |
 ^form_info|Название функции  |
+^  |Дополнительные  параметры  |
+^Dv|Модуль функции |
+**Пример**
+В клиентском кабинете отобразится наше меню, которое мы записали в файл:
+{{:abills:docs:manual:admin:custom_client_menu.png|}}
+В админском кабинете отобразится следующее меню, при такой структуре файла admin_menu.tpl:
+{{:abills:docs:manual:admin:custom_admin_menu.png|}}
 ====Дополнительно====
 *  [[abills:docs:docs:photoshop|Альтернативный вариант работы с PDF-шаблонами]]