В системе имеется возможность работы с шаблонами в PDF формате. Для работы с PDF файлами нужно установить в системе модуль Perl 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 шаблоны отображались.
Редактор шаблонов
Нужно загрузить pdf файл в abills/Abills/templates/ и в пункте меню настройки -> другое -> шаблоны, внизу страницы нажать на иконку изменения возле нужного pdf файла.
После открытия файлы dsc и tpl создаются автоматически или подгружаются уже создание.
Слева можно добавлять переменные на pdf файл, используя кнопку добавить, после нужная переменная появиться справа, тут можно изменить цвет, размер шрифта и удалить переменною:
Нажав на название нужной переменной можно изменять расположение на странице, вибронная для размещения переменная отмечается галочкой:
и можно нажимать на место где нужно расположить переменною.
После завершения роботы нужно сохранить изменения!
Про параметры
Система учитывает практически все общие переменные, и информационные поля.
(переменные с других модулей не учитывает, кроме Docs)
Особые примечание по переменным:
Если информационное поле имеет тип "Список", то расстановка происходит:
Само название поля — результат из списка, которая присвоена пользователю
Название поле_id — ид выбора результата списка, которая присвоена пользователю
Формат файла .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% |