Personal tools
HylaFAX The world's most advanced open source fax server

Handbook:Advanced Server Configuration:Email Templating

Revision as of 05:57, 23 December 2006 by Pfournier (talk | contribs) (New Email Templating page)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

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/


This page was last edited on 23 December 2006, at 05:57.

Powered by MediaWiki
Attribution-ShareAlike 2.5

Project hosted by iFAX Solutions