Templatepack

Ein Templatepack bildet die Grundlage zur Formular-Generierung. Also zur Template-Generierung für die Formulareingaben. Erstellen Sie immer vor der Bearbeitung eines Sicherheitskopie (zum Beispiel durch einen Export).
Es wird empfohlen für die Erstellung eigener Templatepacks, ein bereits bestehendes zu nutzen.
Beachten Sie, das die Templatepackerstellung als Programmierung angesehen werden kann.

Menü: Einstellungen -> Templatepacks

Grundsätzlich wird auch hier vollständig die Template-Engine Smarty (http://www.smarty.net) genutzt. Eine Ausnahme bilden die Templateengine-Befehle, sie werden in den Template-Packs in {{ doppelte geschweifte Klammern }} gehült. Dieser Schritt ist notwendig, um die späteren Template-Befehle zu unterscheiden, die standardisiert von einer einzelnen geschweiften Klammer umgeben werden.

Eine IF Prüfung würde im Template-Pack wie folgt aussehen:

{{if $variable=='xyz'}} 
    Todo 1 
{{else}} 
    Todo 2 
{{/if}}

Wichtig: Template-Befehle mit einfach geschweifter Klammer werden im Templatepack -nicht- ausgewertet. Diese werden 1:1 in die Formular-Generierung übernommen und später zur Formular-Nutzung ausgewertet.

Das Standard-Templatepack "Standard" ist hier als Referenzgrundlage zu nutzen.

Zwingend erforderliche Templates!

Jedes Templatepack muss über einige Templates zwingend verfügen.

mail_admin_html.tpl - Administrator-Email (HTML)
mail_admin_txt.tpl - Administrator-Email (Text)
mail_user_html.tpl - Benutzer-Email (HTML)
mail_user_txt.tpl - Benutzer-Email (Text)
page.tpl - Formulareingabeseite
save.tpl - Abschlusseite
accessdenied.tpl - Gesperrte Formulare

Die verschiedenen Zusatzmodule können weitere Templates zwingend notwendig machen.

Was passiert bei einer Formular-Generierung mit den Templatepacks?

Wenn für ein Formular die einzelnen Formular-Seiten generiert werden, werden die im Templatepack vorhandenen Templates genutzt. Aus diesem Grund muss vor der Generierung ein Templatepack zwingend gewählt werden. Existiert dieses Templatepack inzwischen nicht mehr, werden im Fehlerfall keine Formularseiten ausgegeben.

Alle Templatepack-Dateien werden vollständig für das Formular zur Generierung herangezogen. Jedes Template wird einzeln ausgewertet. Greift ein Template auf ein weiteres Template zu (zum Beispiel mit include) wird auch dieses übernommen und daurch im Formular selbst verfügbar.

Können eigene Templates erstellt werden?

Ein Templatepack kann aus unbegrenzt vielen einzelnen Templates bestehen. Sie können einzeln zusammengesetzt, und dadurch Teilprobleme in Extra-Templates ausgegliedert, werden. Beachten Sie aber, dass solche Templates bei einer "vollständigen Formulargenerierung" ebenfalls generiert und für das Formular übernommen werden. Versuchen Sie daher die Templateanzahl gering zu halten.

Ein typisches Beispiel könnten CSS-Informationen darstellen. Sie werden auf allen Formularseiten genutzt, müssten aber nur an einer Stelle definiert werden.

Es kann die vollständige Smarty-Templateengine genutzt werden.

Templatepack exportieren/importieren/kopieren

Auf der letzten Katei eines Templatepacks, können alle Templates exportiert werden.
Im Templatepackauswahlmenü (linke Seite) kann über "Importieren" eine weitere Maske zum importieren aufgerufen werden. Die zuvor exportierten Templatepacks, können dort wieder importiert werden.
Möchte man ein Templatepack kopieren, muss man es erst exportieren und anschließend importieren.
Templatepacks sind in der Regel Versionsgebunden, also zugehörig zu einer ScarFormManager Version.