Rich Text Editor field
The Rich Text Editor input field allows the end user to apply basic formatting to the entered text. Such as: bold, italic, underline, alignment options and lists.
The entered data is converted into a RTF file. The user input field will contain the path to the RTF file. The PrintShop Mail document should have a variable with the TEXT_FILE() expression. The value parameter of this expression should state the name of the user input data field, e.g. TEXT_FILE([Specification]). For more information about the TEXT_FILE() expression refer to the PrintShop Mail User Guide.
A rich text field
Web Form Parameters
-
Required: Defines the Rich Text Editor field as a required field.
-
Separator Line: Controls whether a separator line will be shown before this field. With this option web forms that have more complex variable data can be arranged more logically.
-
Max. Input Characters: Defines the maximum number of characters that the user may enter. The number of characters is unlimited. By default the value is set to 256 characters.
-
Field Width: The width of the field in the web form. The minimum width of the data entry field is 1 pixel, the maximum width is 2048 pixels. By default the value is set to 300 pixels.
-
Field Height: The height of the field in the web form. The minimum height of the input field is 1 line and the maximum height is 255 lines. By default the value is set to 1 line.
Rich Text Defaults
When the field type is set to Rich Text an additional group of options becomes available. These options are used to set basic formatting of the content or to specify additional parameters of the online editor. The Rich Text Defaults section contains the following properties:
-
Font: Enter the name of the font for text. All text will have the same font applied. Note that this font should be installed and activated on the PrintShop Mail Web server.
-
Font Size: The fonts size applied to the text in the RTF file.
-
Line Spacing: Space between lines of text measured fom baseline to baseline. The value is measured in points.
-
Default Color: Enter the base color for the text (hexadecimal value, e.g. 0099FF).
-
Color Palette: This field defines the contrast colors that can be used to mark ranges of text in the online editor. Colors should be entered using hexadecimal values. The values are comma separated, the #-symbol is not required (e.g. 0099FF, FF0000, 00CC00).
-
Background Color: Enter the background color for the text editor (hexadecimal value, e.g. 0099FF). Change this value when the Default Color is set to white (#FFFFFF) or a light color, to enable the end user to see the entered text clearly.
Default Value
This field type has the following Default Value option:
-
Custom Value: Enter the initial value for the field.
Data conversion
The entered data is converted into a RTF file, which is achieved using a XSLT style sheet. If a document requires specific RTF output an experienced user could change this XSLT style sheet. The xhtml2rtf.xsl is located in the include folder of the PrintShop Mail Web web site.
To create a document specific conversion one should copy this file to the folder of the PrintShop Mail document. The preview process will automatically detect and apply this file. The path to the document folder is stated in the property page of that document.
Note: Before editing the XSLT style sheet create a backup of the file first.
A variable in PrintShop Mail with the TEXT_FILE expression