Это старая версия документа.
Шаблоны системы
/ System configuration/ Misc/ Template/
Правка шаблонов. Вся визуализация систему построена на темплейтах поэтому можно изменять вид за своим усмотрением. После изменения шаблонов они сохраняются в каталоге abills/Abills/templates и загружаются вместо системных. Чтобы опять вернутся к системным темплейтам нужно просто вытереть Вами созданные темплейты.
Система поддерживает шаблоны в формате HTML и PDF.
Для удобства был создан редактор HTML шаблонов. Система разрешает загружать уже готовые шаблоны через веб интерфейс администратора.
Переменные в шаблоне указываются в следующего вида %VARIABLE%. В процессе отображения они заменяются значениями.
Например:
<input type=text name=FIO value='%FIO%'>
Если в переменной указать знак равно ( = ) то значение после него будет использоваться как значение по умолчанию при не заполненном поле.
Пример:
<input type=text name=ZIP value='%ZIP=78200%'>
Если после переменной идёт конструкция =expr: то данные поле конструкции считаются регулярным выражением и применяются к значению переменной
Пример :
Удаление префикса 1C: с переменной перед выводом
<input type=text name=EXT_ID value='%EXT_ID=expr:1С:/%'>
Удаление буквенных префиксов перед двоеточием:
<input type=text name=EXT_ID value='%EXT_ID=expr:[a-zA-Z]:/%'>
В редакторе HTML шаблонов теги <textarea… конвертируются в <textarea.., а при сохранени шаблона конвертируются в обратном порядке: <textarea.. на <textarea… .
Для добавления дополнительных информационных полей в шаблон нужно указывать названия поля в базе В ВЕРХНЕМ РЕГИСТРЕ.
Например:
для поля - _inn
%_INN%
Перед созданием шаблонов установите на папку abills/Abills/templates для записи веб сервером. При создание пользовательский шаблонов они записываются в каталог abills/Abills/templates в формате НазваниеМодуля_Название_Шаблона
Также система создаёт полнофункциональные поля ввода с маркером 'FORM_'
%FORM__INN%
будет выглядеть так
<input type=text name=EXT_ID value='%EXT_ID=expr:1С:/%'>
Например
для шаблона cards_print.tpl из модуля Cards индивидуальный шаблон должен выглядеть так:
abills/Abills/templates/Cards_cards_print.tpl
PDF шаблоны
В системе имеется возможность работы с шаблонами в PDF формате. Для работы с PDF файлами нужно установить в системе модуль PDF::API2. Шаблоны PDF состоят из 2 частей сам шаблон - файл с расширением .pdf и описание шаблона файл с расширением .dsc. Для преобразования документов с формата MS Word в PDF лучше всего использовать программу OpenOffice Writer из пакета OpenOffice.
для 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%