The tag PFPlaceholder can be used to create text placeholders in order to insert content into an existing text or text frame by form editor in the printformer editor (Strict) or automatically via an external data source.

General functions

  • Placeholders get their content from one or more DataKeys in a row of a data source:

    • a placeholder can include several DataKeys (comma-separated, any blanks are deleted).

      • the contents from the data source are merged with a definable separator character

      • If no content is stored in the data source for a DataKey, or if the content corresponds to an empty string, the DataKey is skipped during merging, so that the separators are not duplicated

    • Placeholder can also be filled with data (DataKeys) from the printformer system (e.g. for automatic page numbers).

  • the content is always trimmed so that no spaces remain at the beginning or end of the string

  • Placeholders have a default value that corresponds to the text from the template. (In the example above from InDesign, the default value is: "Placeholder"). Text only appears there if something has been entered via the form editor.

  • If the text entered as a placeholder in the InDesign document (= default value) should be visible in the printformer template (editor), the attribute "use-standard-text-if-empty": true must be added to the placeholder tag. However, it should be noted that this text is printed if no new text is entered or the content of the placeholder is taken from a data source.

  • A placeholder has only one character format (text style); if individual characters of the placeholder are reformatted, only the format of the first character is applied during processing.

  • Placeholders that have not been filled from formatted catalogue products or StyledText cannot contain bullet points.

The use of placeholders in a group template with content-identifier does not work if they are within a (body) text. Likewise, there must be no spaces outside the placeholder.

A combination of inline text (text editing directly in the text block) and the form editor is not available.

Set up placeholders in InDesign

To simplify editing, the tag marks should first be displayed (View > Structure > Show Tag Marks).

To define a placeholder in the InDesign document, first assign the tag PFBlock to the desired text frame (right click > Tag frame > PFBlock – or via the tag menu window). If desired, the editing of the entire block can be restricted by adding attributes (e.g. block-disable-interactions).

Then the desired text is marked and tagged with PFPlaceholder (right click > Tag text > PFPlaceholder).

In order to be able to assign content to the individual placeholders later, an attribute with one or more data-keys is added (right-click on the tag > New attribute... > Name: data-keys; Value: freely selectable).

Sollte nachträglich der getaggte Text oder die Markierung verändert werden kann der Text auch im Textmodus (Cursor im Text > cmd + y) bearbeitet werden. Dort sind die Marker deutlicher sichtbar und der Cursor kann einfacher gesetzt werden. Auch die Einblendung der “Verborgenen Zeichen” kann für die Bearbeitung hilfreich sein (Menüleiste Schrift > Verborgene Zeichen einblenden).

If the same placeholders (identical data keys) are contained several times in the template (e.g. multi-page templates), the content of a field filled in the editor is used for the other text blocks.

Name
(* = Mandatory field)

Value

Usage

Example of use

Attribute

 

data-keys*

 

One or more DataKeys (comma-separated) used to search for content for the block in the current data sources.
When using the form editor, each DataKey appears as a field to be filled in.
If no DataKeys are stored, the default text from the template is displayed (and cannot be overwritten) regardless of the use-standard-text-if-empty attribute.

If the data source is modifiable, however, multiple DataKeys lead to an implicit non-modifiability of the content. (Exception: If the form editor is activated, it creates its own database).

Creation of business cards (automated data merging) with DataKeys name, address, phone, aso.

separator

 

Definition of the separator character when using multiple DataKeys within one placeholder.

Default value: ", "

The contents of the DataKeys should be separated with a /.
(data-key1/data-key2/…)

is-content-modifiable

true oder false

Content that is loaded into the placeholder via data sources can be overwritten by this attribute.

Default value: false

Articles are loaded into a container template via the feed, which the user can customize in the editor (e.g. prices or description).

use-standard-text-if-empty

true oder false

The text entered as placeholder in the InDesign document (= default text) remains if no other text is entered. (If this attribute is not visible in the editor).

Default value: false
Whitespaces are not considered as content

The placeholder (text) should be always visible in the template.
If this attribute is set, the default text will be printed if no new text is entered.

strip-styles

true oder false

Provides the possibility to insert a placeholder with text from a data source that is already formatted (StyledText) without its text style.
Default value: false

From a designed main title of a book, the title should be taken and placed on the first page of the book block without its formatting.

condition-JSON

JSON-String

Provides the possibility to show the text only if the specified conditions are met.

the word "Mobile" appears only if a mobile number is existing
{    "left": "${[Mobil-Nummer]}",
  "operator": "not-equal",
    "right": ""
}