Anmerkung
	In keinem Fall sollten Dateien mit der Endung *.cls oder *.sty geändert werden. Durch Änderungen an diesen Dateien verhindert man Updates auf neuer Versionen. Zwar kopiert kivitendo die Datei und bearbeitet diese beim Update nicht. Allerdings sind sämtliche Änderungen über die Konfigurationsdateien möglich und erhöhen die Wartbarkeit.

Alle dokumententypspezifischen Einstellungen müssen in der jeweiligen Template-Datei modifiziert werden.

Die Grundstruktur besteht je Dokumententyp aus einer Basisdatei und verschiedenen Setup-Dateien.

Die Basis wurde so überarbeitet, dass Dokumente nun generell auf der Dokumentenklasse scrartcl.cls basieren und das Paket kiviletter.sty benutzen.

Mandant*innenspezifische Konfiguration findet sich in der Datei insettings.tex und dem Ordner eines spezifischen Mandant*innen (default=*firma/*).

Um gleiche Vorlagen für verschiedene Firmen verwenden zu können, wird je nach dem Wert der Kivitendo-Variablen \kivivar{kivicompany} ein Firmenverzeichnis ausgewählt (siehe insettings.tex), in dem Briefkopf, Identitäten und Währungs-/Kontoeinstellungen hinterlegt sind. \kivivar{kivicompany} enthält den Namen des verwendeten Mandant*innendaten. Ist kein Firmenname eingetragen, so wird das generische Unterverzeichnis *firma* verwendet.

In jedem Firmen-Unterverzeichnis soll eine Datei ident.tex vorhanden sein, die mit |\newcommand| Werte für |\telefon|, |\fax|, |\firma|, |\strasse|, |\ort|, |\ustid|, |\email| und |\homepage| definiert.

Für jede Währung (siehe insettings.tex) soll eine Datei vorhanden sein, die das Währungssymbol (|\currency|) und folgende Angaben für ein Konto in dieser Währung enthält |\kontonummer|, |\bank|, |\bankleitzahl|, |\bic| und |\iban|. So kann in den Dokumenten je nach Währung ein anderes Konto angegeben werden. Nach demselben Schema können auch weitere, alternative Bankverbindungen angelegt werden, die dann in insettings.tex als Variable in der Fußzeile eingefügt werden.

Als Fallback (falls kivitendo keine Währung an das Druckvorlagen-System übergibt) ist Euro eingestellt. Dies lässt sich in der insettings.tex über das optionale Argument von |\setupCurrencyConfig| anpassen, z.B.

    \setupCurrencyConfig[chf]{\identpath}{\lxcurrency}

für Schweizer Franken als Standardwährung.

Eine Hintergrundgrafik oder ein Logo kann in Abhängigkeit vom Medium (z.B. nur beim Verschicken mit E-Mail) eingebunden werden.

Desweiteren sind (auskommentierte) Beispiele enthalten für eine Grafik als Briefkopf, nur ein Logo, oder ein komplettes A4-PDF als Briefpapier.

Absolute Positionierung innerhalb des Brief-Layouts ist über die entsprechende Dokumentation des scrlayer-Paketes möglich. Da die Voreinstellungen bereits einige Sonderfälle automatisch berücksichtigen ist mit den Anpassungen Vorsicht geboten. Sämtliche Einstellungen sollten jedoch außerhalb der *.sty-Dateien vorgenommen werden. Anpassungen der insettings.tex betreffen hierbei alle Mandant*innen. Spezifischere Einstellungen sind über die zugehörige Konfigurationsdatei (ident.tex) möglich. In diesem Fall kann zum Ende der insettings eine weitere Konfigurationsdatei über die Verwendung von |\identpath| geladen werden. Ein Beispiel ist in der insettings.tex enthalten.

Die Tabelle im Fuß verwendet die Angaben aus firma/ident.tex und *firma/\_account.tex. Ihre Struktur wird in der insettings.tex definiert. Sie kann anschließend auch Mandant*innenspezifisch überschrieben werden.

Das Seitenlayout wird über \pck{scrlayer-scrpage} bestimmt. Die ausführliche Dokumentation findet sich in \cite{scrguide}. Es existieren in der Datei insettings.tex einige Hinweise zu den Anpassungen. Die Basiskonfiguration ist ebenfalls dort eingetragen.

Neben den in Abschnitt \ref{sec:options} beschriebenen Optionen zum Abschalten der Fußzeile kann der Inhalt der Fußzeile über die \pck{scrlayer-scrpage} Makros, wie

      \cfoot[|\meta{Inhalt auf der ersten Briefseite}|]{|\meta{Inhalt auf folgenden Briefseiten}|}    

geändert werden.

Die Kopfzeile unterscheidet sich von Dokumententyp zu Dokumententyp leicht, da diese über Datenbankvariablen befüllt wird. Hierfür wird das Makro |\ourhead| in der insettings.tex definiert.

      \DescribeMacro{\ourhead}\marg{Bezeichner}\marg{Eintrag}\marg{Titel}\marg{Nummer}\marg{Datum}    

Diese Definition kann ebenfalls über die insettings.tex angepasst oder auch nachträglich überschrieben werden:

      \newcommand{\ourhead}[5] {%
        \chead{%
          \makebox[\textwidth]{%
            \Ifstr{#1}{}{}{#1: #2 \hspace{0.7cm}}%
            #3%
            \Ifstr{#4}{}{}{~\nr: #4}%
            \Ifstr{#5}{}{}{\vom ~ #5}%
            \hspace{0.7cm} - \seite ~ \thepage/\letterlastpage  ~-%
          }%
        }%
      }
    

In der Standard-Einstellung sieht eine Kopfzeile mit obigen Aufruf dann folgendermaßen aus:

      \newcommand{\ourhead}[5] {%
          \makebox[\textwidth]{%
            \Ifstr{#1}{}{}{#1: #2 \hspace{0.7cm}}%
            #3%
            \Ifstr{#4}{}{}{~\nr: #4}%
            \Ifstr{#5}{}{}{\vom ~ #5}%
            \hspace{0.7cm} - \seite ~ \thepage/\letterlastpage  ~-%
          }%
      }

      \begingroup
      \def\letterlastpage{50}

      \ourhead{arg1}{arg2}{arg3}{arg4}{arg5}

      \smallskip
      Erzeugt mit dem Aufruf
      \ourhead{arg1}{arg2}{arg3}{arg4}{arg5}
      \endgroup    

Die Absenderergänzung wird über die Variable |location| in der |kiviletter.sty| folgendermaßen belegt:

      \setkomavar{location}{
        \Ifkomavarempty{transaction}{}{{
              \usekomafont{transaction}
              \usekomavar{transaction}
            }
        }
        \par
        \medskip
        \parbox{\useplength{locwidth}}{
          \locationentry{date}
          \locationentry{myref}
          \locationentry{customer}
          \locationentry{yourref}
          \locationentry{delivery}
          \locationentry{quote}
          \locationentry{orderID}
          \locationentry{projectID}
          \locationentry{taxpoint}
          \locationentry[\ansprechpartner]{fromname}
          \locationentry{fromphone}
          \locationentry*{fromemail}
        }
      }    

Um die Reihenfolge der Variablenausgabe zu verändern, kann diese Definition als Basis in die insettings.tex oder ident.tex (Falls nur für eine Firma) kopiert und dort entsprechend modifiziert werden.

Das Vorgehen geht für alle vorbelegten Variablen analog.