This extension enables adding Transpromo or transpromotional content to documents generated with XF Ultrascale 2011 . The term "transpromotional" refers to the merging of promotional content and transactional print pieces and is a technique companies can use to add promotion or even advertising onto existing transaction-related documents, such as statements, invoices, or bills.
The extension that XF Ultrascale 2011 uses to implement Transpromo is xf:trans-promo. It can reside as a child of fo:page-sequence. The following attributes are supported:
| • | all fo:external-graphic attributes - will need to be prefixed with fo to be recognized correctly: fo:src, fo:content-width, fo:content-height, fo:scaling |
| • | all fo:external-graphic extensions - will not need any prefix as they are already in the xf namespace: filter, no-clip, compat-id, scaling-reference |
| • | page-constraint - transpromo content will appear only on pages satisfying this constraint; possible values are: any (default, no constraint applied), odd, even, first, last |
| • | alignment-constraint - transpromo content will appear only on the side of the page satisfying this constraint; possible values are: none (default, no constraint applied), top, bottom, center, left, right |
| • | column-constraint - transpromo content will be constrained into appearing only on a specific column, given by its index; the default is -1, meaning no constraint is applied, positive values indicate one of the columns: 0 for first column, 1 for second, etc |
| • | region-constraint - transpromo content will be constrained into appearing only on a specific region, determined by its name; the default value is an empty string, meaning no constraint is applied |
| • | rect-constraint - - transpromo content will not exceed the boundaries of the rectangle defined; the generic form is rect(X, Y, Width, Height), where X, Y, Width and Height are floating point numbers which give the respective coordinates of the rectangle in pixels |
| • | rule - the rule to be satisfied in order for this transpromo content to appear; possible values are: none (default, this transpromo will appear whenever possible) and FIND_KEYWORD(StringToFind) (this transpromo will only appear if StringToFind appears in the page) |
