===== 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]]. 


для 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%