Это старая версия документа.


Шаблоны системы

/ 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%

Кастомные меню

client_menu.tpl - Настраиваемое меню абонента

admin_menu.tpl - Настраиваемое меню администраторов

Формат

10:0:$_USER_INFO:form_info:::
40:0:$_FINANCES:form_finance:::

Описание параметров

10 Номер меню
0Номер основного меню
$_USER_INFOНазвание меню
form_infoНазвание функции

Дополнительно