Zum Hauptinhalt springen

Wie kann ich das Konfigurations-PDF gestalten?

info

Um das PDF zu ändern, benötigen Sie grundlegende Kennnisse in HTML und CSS. Ggf. wollen Sie das Ihrem Webdesigner überlassen.

Sie können zur Konfiguration ein PDF erzeugen. Das kann entweder per Mail verschickt werden oder direkt heruntergeladen werden. Sehen wir uns das zuerst an:

PDF direkt herunterladen

Das PDF wird nur direkt heruntergeladen, wenn es nicht per Mail versendet wird.

  • Öffnen Sie den Editor Ihres Konfigurators.
  • Klicken Sie in der Seitenleiste auf Editor.
  • Klicken Sie auf das Stift-Symbol an dem Block, der Preis und Bestellen-Knöpfe enthält
  • Hier können Sie Bestellen-Knöpfe anlegen und pflegen. Nutzen Sie entweder den vorhandenen oder klicken Sie auf + Neue Aktion, um einen neuen anzulegen.
  • Löschen Sie den Haken bei An Shop senden und interne Mail senden (und normalerweise in diesem Fall auch bei Kontaktformular, mindestens aber darin bei E-Mail senden)
  • Setzen Sie den Haken bei PDF herunterladen oder versenden
  • Klicken Sie auf Speichern

PDFs formatieren

Im Normalfall werden die PDFs in einem neutralen Format erzeugt. Sie können das ändern, benötigen dann aber ein paar Kenntnisse in HTML. Ggf. wollen Sie das Ihrem Webdesigner überlassen.

  • Öffnen Sie den Editor Ihres Konfigurators.
  • Klicken Sie in der Seitenleiste auf Optionen.
  • Wechseln Sie zu dem Tab PDF. Hier können sie
    • eine Schriftart wählen
    • Seitenränder bestimmen
    • eine Vorlage wählen: Ein PDF, auf dem der Druck stattfindet.
    • mehrere Bausteine (=Template) ändern.
  • Für die Bausteine: Klicken Sie in das Feld Templatnamen und wählen Sie eine der Vorlagen aus:
    • content das gesamte Dokument
    • customer Abschnitt mit Kunden-Daten
    • images Abschnitt mit Produktbildern Um diese Bilder zu liefern, klicken Sie im Editor auf Kamera speichern.
    • variables Tabelle mit den ausgewählten Merkmalen
    • bom (=Bill of Material) Tabelle mit der Stückliste, also allen gekauften Artikeln
  • Klicken Sie auf + Templat hinzufügen.
  • Klicken Sie auf das Templat, um es auszuklappen.
  • Klicken Sie auf das Upload-Icon. Damit erhalten Sie den Inhalt des Templat aus dem Standard und können es nun ändern.
  • Template sind in der Sprache twig geschrieben.
  • Über locale können Sie die PDFs mehrsprachig machen.
  • Schauen Sie ansonsten in die Vorlage, um zu verstehen, wie Sie die PDFs ändern können.
  • Klicken Sie auf Speichern.
tip

Sie können ihre template hier an bestehenden Konfigurationen testen. Wählen Sie dazu einfach eine bestehende Konfiguration, sowie das zugehörige Templat aus und klicken Sie auf Speichern und drucken

tip

Die Vorlagen erzeugen HTML, welches mittels mpdf in ein PDF gewandelt wird. Es steht nur ein eingeschränkter Umfang von HTML und CSS zur Verfügung.

tip

Sie können auch komplett neue Vorlagen aufbauen. Damit können Sie etwa dem Kunden ein Angebot, sich selbst aber einen Arbeitsauftrag senden. Wählen Sie dann bei den Einstellungen zu Mails die verschiedenen Vorlagen aus.

Welche Variablen stehen in den PDF Vorlagen zur Verfügung?

  • app Daten des Konfigurators
    • label Name
    • description Beschreibung
    • image URL des Bildes (derzeit noch unbefüllt)
    • settings alle Einstellungen
  • cfg Daten der Konfiguration
    • code eindeutiger Code der Konfiguration
    • price Preis
    • customer Kundendaten. Welche Felder gefüllt sind, ist davon abhängig, wie Sie das Kontaktformular aufgebaut haben:
      • name: Name des Kunden
      • address: Strasse und hausnummer des Kunden
      • zip: PLZ des Kunden
      • city: Stadt des Kunden
      • email: E-Mail des Kunden
      • phone: Telefonnummer des Kunden
      • company: Firma des Kunden
      • taxID: Umsatzsteuer-ID des Kunden
    • variables Liste der vom Kunden gewählten Merkmale:
      • label Name des Merkmales
      • value Name des gewählten Wertes
      • price u.U. der Aufpreis dafür
    • bom Stückliste (bill of material) mit den implizit gewählten Artikeln:
      • qty Anzahl
      • price komplette Preisinformation
        • article der gewählte Artikel
          • no Artikelnummer
          • name Artikelname
      • priceUnit Einzelpreis des Artikels
      • priceTotal Gesamtpreis der Position
    • json Der eigentliche Inhalt der Konfiguration
      • summary Liste der vom Kunden gewählten Merkmale, kombiniert mit ihren Artikeln und Preisen:
        • group Name des Schrittes
        • row Position des Merkmals in der Gruppe unter den nicht versteckten, ab 1
        • index Position des Merkmals in der Gruppe, ab 0
        • variableLabel Name des Merkmales
        • selectionLabel Ausgewählter oder eingegebener Wert
        • type Der Type des Merkmales, z.B. list, number oder image
        • data abhängig vom type weitere Daten:
          • url Adresse des Bildes, bei image
          • leftright Position des Bildes links/rechts, von 0-100, default 50, bei image
          • topbottom Position des Bildes oben/unten, von 0-100, default 50, bei image
          • scale Größe des Bildes, von 0-100, default 75, bei image
        • bom alle aufgrund dieses Merkmals eingefügten Artikel
          • articleLines Artikel
          • surchargeLines Aufschläge
          • priceTotal Gesamtpreis
        • subvariables ggf. Liste der Teile, die in dieser Variable eingefügt wurden
    • files Hochgeladene Bilder und Screenshots
      • camera_0: Screenshot
      • camera_1: Screenshot
      • ggf. weitere Daten wie Aufrucke oder Dateien, die Erweiterungen mitsenden
    • created_at: Datum der Erstellung
    • action ID des Knopfes, mit dem gespeichert wurde. Muss mit app.settings.actions.id abgeglichen werden.
  • dealerApp Einstellungen eines Händlers
    • settings Einstellungen
      • logo Logo des Händlers
  • locale Sprache, etwa de oder en
  • link Link zum Konfigurator
  • full Vollständige Definition des Konfigurators, sollte im Normalfall nicht benötigt werden

Ein konkretes Merkmal ausgeben

Wenn sie im PDF ein ganz konkretes Merkmal ausgeben wollen, dann geben Sie diesem Merkmal zunächst einen key.

tip

Wechseln Sie dazu in Ihr Profil (Klick auf die Email in der Navigationsleiste und dann Profil) und schalten Sie dort den "Entwickler-Modus" ein.

Dann erscheint bei einem Merkmal das Eingabefeld für den Key. Sie können sich hier einen beliebigen Schlüssel ausdenken.

Wenn Sie einem Merkmal zum Beispiel den Key breite gegeben haben, können Sie folgendermaßen darauf zugreifen:

{% set myVar = cfg.json.summary | filter(l => l.variableKey=='breite') | first %}

{% if myVar %}
<p>{{ myVar.variableLabel }}: {{ myVar.selectionLabel }} Aufpreis: {{ myVar.bom.priceTotal | format_currency('EUR') }} </p>
{% endif %}

Namen der PDF-Dateien ändern

Die Namen von an Mails angehängten oder zum Download angebotenen PDF-Dokumenten können geändert werden:

  • Öffnen Sie den Editor Ihres Konfigurators.
  • Klicken Sie in der Seitenleiste auf Editor.
  • Klicken Sie auf das Stift-Symbol an dem Block, der Preis und Bestellen-Knöpfe enthält
  • Hier können Sie Bestellen-Knöpfe pflegen. Wählen Sie einen.
  • Geben Sie unter "Dateiname des Pdfs" die gewünschten Dateinamen (inklusive der Endung .pdf!) an.
  • Klicken Sie auf Speichern

Die können in der Dateinamen Ersetzungen vornehmen lassen. Z.B. für die Eingabe von Anfrage-{code}.pdf dazu, dass das PDf z.B. den Namen "Anfrage-JHDBSGJ.pdf" bekommen, weil der Code der Konfiguration eingetragen wird. Die folgenden Felder können zwischen den {} angegeben werden:

FeldBedeutung
codeCode der Konfiguration
app.labelName des Konfigurators
app.codeCode des Konfigurators
customer.nameName des Kunden
customer.addressStrasse und hausnummer des Kunden
customer.zipPLZ des Kunden
customer.cityStadt des Kunden
customer.emailE-Mail des Kunden
customer.phoneTelefonnummer des Kunden
customer.companyFirma des Kunden
customer.taxIDUmsatzsteuer-ID des Kunden

Die Kundendaten liegen natürlich nur vor, wenn im Kontaktformular auch erfasst.