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
abills/Abills/templates/Cards_cards_print.tpl

.tpl-шаблон, это признак кастомного шаблона. Он может быть пустым, но создать его нужно обязательно.

формат файла .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= Иногда возникает необходимость отображать слова с интервалами между буквами. Расстояние указывается в пикселях

для загруженных шрифтов нужно указывать полный путь

font_name=/usr/abills/Abills/templates/fonts/ArianAMU.ttf

Вставка текста из файла

text Название текстового файла. Файл должен быть размещён в каталоге $conf{TPL_DIR}. При отсутствии файла система сообщает об ошибке
text_height Высота текстового поля
text_width Ширина текстового поля

Вставка изображений в формате .jpg

img Название графического файла. Файл должен быть размещён в каталоге $conf{TPL_DIR}. При отсутствии файла система сообщает об ошибке
img_height Высота картинки
img_width ширина картинки

Дополнительные параметры шаблонов писем

Если шаблон письма нужно дополнить какой то служебно информацией (Subject, X-Priority и т.д.), нужно в самом верху шаблона указать данные переменные по одной в каждой строке. После дополнительных переменных нужно отступить два пробела и только тогда начинать тело письма. Если строка начинается на решётку # её система не обрабатывает. Переменные указанные в шаблоне имеют более высокий приоритет чем эти же значения в системе.
Пример
Нужно изменить тему писем

Subject: Новая тема

Здравствуйте %FIO%,
Ваш депозит %DEPOSIT%