Handbook:Advanced Server Configuration:Email Templating

Server administrators have complete control over the 'look and feel' of the email messages HylaFAX sends. Current HylaFAX releases use templates only for internationalization, but much more can be done with templates.

How To Use
By default, HylaFAX uses the en family of templates. To select a non-default template family, you must set the TEMPLATE variable in etc/FaxDispatch, etc/FaxNotify and/or etc/PollDispatch to the template family you want to use.

For example, to use the distributed French templates for received faxes, you need to add the following line to etc/FaxDispatch:

TEMPLATE=fr

Of course, different recipients can use different template families.

Distributed Templates
HylaFAX is distributed with templates in the following languages:


 * 1) English
 * 2) French
 * 3) German
 * 4) Italian
 * 5) Polish
 * 6) Portuguese
 * 7) Brazilian Portuguese
 * 8) Romanian
 * 9) Spanish

and can be easily extended to support many others.

Template Customization
''You should never edit a distributed template directly nor create them in a directory consisting of "two letters" or "two letters, '_' and two letters" unless you don't mind losing your changes during HylaFAX upgrades. You should copy the templates in a new directory and use that instead.''

Templates are located in subdirectories of etc/templates. Each template family has it's own subdirectory.

pollrcvd will use faxrcvd templates if pollrcvd specific templates don't exist.

A line beginning with #INCLUDE will be replaced by the content of the file specified by the next argument.

For an example of what can be done with a little bit of HTML, check out the hylafax-html templates at: http://people.ifax.com/~aidan/hylafax/templates/