Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
outlinetrue
stylenone

...

  1. Download des Plugins

  2. Im Admin Dashboard unter Einstellungen → System → Plugins auf den Button Upload Plugin klicken

  3. Die Datei markieren und hochladen

Shopware-Store

TODO

Aktivierung

Ist das Plugin hochgeladen muss das Plugin noch installiert & aktiviert werden. Bitte beachten Sie, dass nur installierte Plugins aktiviert werden können. Um das Plugin zu installieren, wählen Sie in der rechten Spalte (Button mit 3 grauen Punkten) den Punkt installieren aus. Nach erfolgreicher Installation können Sie das Plugin aktivieren und dann mit der weiteren Konfiguration fortfahren.

...

  • Rechnungsanschrift auf PDF anzeigen (Ja/Nein): Gibt an, ob auf den generierten PDFs Felder für eine Rechnungsanschrift ausgewiesen werden

  • Lieferanschrift auf PDF anzeigen (Ja/Nein): Gibt an, ob auf den generierten PDFs Felder für eine Lieferanschrift ausgewiesen werden

  • Rechnungs- und Lieferanschrift vorausfüllen (Ja/Nein): Gibt an, ob die in der PDF angezeigten Adress-Felder für eingeloggte Nutzer mit der Standard Liefer- bzw. Rechnungsanschrift vorausgefüllt werden.

  • B2B Felder anzeigen (Ja/Nein): Fügt beiden Anschriften Felder für Firma und Umsatzsteuer-ID hinzu.

  • Zahlungsart vorauswählen (Ja/Nein): Markiert bei eingeloggten Nutzern die Standard-Zahlungsart auch im PDF als aktiv. Bitte beachten Sie die Info am Ende dieses Einstellungs-Blocks, um mehr über diese Option zu erfahren.

  • Versandart vorauswählen (Ja/Nein): Markiert die für diesen Warenkorb genutzte Standard-Versandart auch im PDF als aktiv. Bitte beachten Sie die Info am Ende dieses Einstellungs-Blocks, um mehr über diese Option zu erfahren.

  • Datei-Prefix Präfix (Texteingabe): Beim Speichern oder Download der PDF wird jeweils ein Dateiname mit aktuellem Datum und aktueller Uhrzeit generiert. Die Eingabe hier wird vorangestellt, z.B. wird aus “MeinAngebot” beim Speichern der Dateiname “MeinAngebot_06112020_052711”.

  • Schriftart (Auswahl): Gibt an, welche Schriftart zur Erstellung der PDF genutzt werden soll.

  • PDF-Download (Auswahl): Gibt an, ob sich die PDFs in einem neuen Tab öffnen oder heruntergeladen werden.

  • Erlaubte Zahlungsarten (Auswahl): Listet alle im Shop angelegten Zahlungsarten auf und limitiert die Anzeige im PDF auf die hier ausgewählten. Bitte beachten Sie, dass der Rulebuilder hier ebenfalls eine Rolle spielt und bei entsprechender Konfiguration eines Artikels z.B. Vorkasse trotz Auswahl bei dieser Einstellung nicht angezeigt wird. Wenn keine Auswahl getroffen wird, werden alle für diesen Warenkorb passenden Zahlungsarten angezeigt.

  • Erlaubte Versandarten (Auswahl): Listet alle im Shop angelegten Versandarten auf und limitiert die Anzeige im PDF auf die hier ausgewählten. Bitte beachten Sie, dass der Rulebuilder hier ebenfalls eine Rolle spielt und bei entsprechender Konfiguration eines Artikels z.B. DHL trotz Auswahl bei dieser Einstellung nicht angezeigt wird. Wenn keine Auswahl getroffen wird, werden alle für diesen Warenkorb passenden Versandarten angezeigt.

Die Optionen “Erlaubte Versandarten” bzw. “Erlaubte Zahlungsarten” ignorieren die Optionen “Zahlungsart vorauswählen” resp. “Versandart vorauswählen”.

Wenn ein Kunde als Standard-Zahlungsart Kreditkarte hinterlegt hat, Sie diese Zahlungsart aber nicht in Ihrer Auswahl unter “Erlaubte Zahlungsarten” mit ausgewählten ausgewählt haben, wird keine Vorauswahl getroffen

...

  • Footer Höhe in cm (Zahlenfeld): Gibt die Höhe des Footer Footers auf den generierten PDFs an.

  • Footer-Spalten (Auswahl): Gibt an, in wie viele Spalten der PDF-Footer aufgeteilt wird.

  • Footer-Schriftgröße (Auswahl): Legt die für den Footer angewandte Schriftgröße fest.

  • Footer-Spalten 1 bis 5 (Hinweisfeld): Sie können die Inhalte des Footers ganz einfach wie im Abschnitt Individualisierung - Textblöcke angegeben anpassen

  • “Kleingedrucktes” (Hinweisfeld): Sie können die Inhalte des Kleingedruckten ganz einfach wie im Abschnitt Individualisierung - Textblöcke angegeben anpassen

  • Footer Hintergrundfarbe (Farbwähler): Setzt die Hintergrundfarbe für den Footer.

  • Footer Schriftfarbe (Farbwähler): Setzt die Schriftfarbe für den Footer.

...

Das Plugin fügt je nach Konfiguration 2 zwei für Nutzer des Shops sichtbare Buttons in die Storefront ein.

...

Note

Wenn Sie Änderungen in den eigenen Dateien des Plugins durchführen, werden diese bei einem Update unwiderruflich überschrieben!

...

Das Plugin bietet bis hin zur Verwendung von Inline-CSS viele Möglichkeiten die Darstellung in der Shop-Storefront anzupassen. Änderungen, die über die Konfigurationsmöglichkeiten in der Administration hinausgehen, sind über das Template-System von Shopware in Ihrem eigenen Storefront-Template möglich.

Note

Wenn Sie Änderungen in den eigenen Dateien des Plugins durchführen, werden diese bei einem Update unwiderruflich überschrieben!

...

Sie können die verwendeten Textbausteine ganz einfach über die Administrationsoberfläche ihrer Ihrer Shopware-Installation anpassen. Unter Einstellungen wählen Sie im ersten Reiter “Shop” den Punkt “Textbausteine” aus, klicken dann in der rechten Spalte bei dem Textbaustein-Set, für das Sie Änderungen vornehmen wollen, auf “bearbeiten”. Danach können Sie oben in der Suche nach “s360-pdf.” suchen und finden alle Textbausteine, die für das Plugin relevant sind.

...

Um herauszufinden, wo ein Problem liegt, helfen Ihnen und uns die Logs. Je nach Fehlerbild ist eines der folgenden 3 drei Logs dafür mehr oder weniger relevant.

...

Das Browser-Log ist meist relevant, wenn sich irgendwas im Frontend des Shops sich merkwürdig verhält oder nicht reagiert. (Beispiel: Sie klicken einen Button und augenscheinlich passiert gar nichts.)

...

Eine der häufigsten Ursachen hierfür ist, dass die Vererbung des Templates nicht korrekt durchgeführt wird. Um sicherzugehen, dass es sich lediglich um einen Darstellungsfehler und nicht um einen Programmierfehler handelt, macht es Sinn, das Plugin einmalig im Shopware-eigenen Storefront Template und ohne andere Plugins zu testen. Sollte der Fehler nicht mehr bestehen und das Plugin wie erwartet funktionieren, lassen sich die Ursachen nun nach dem Ausschlussprinzip der Reihe nach durchgehen. Aktivieren Sie zuerst ihr u.U. angepasstes Storefront-Template und prüfen Sie die Funktionalität, dann aktivieren Sie Schritt für Schritt ihre Ihre Plugins.

Technischer Hinweis: Das Plugin nutzt im Warenkorb (Datei: /storefront/page/checkout/cart/index.html.twig) den Block page_checkout_cart_action_proceed. Für die Anzeige im Ajax-Warenkorb (Seitenleiste, Datei: /storefront/component/checkout/offcanvas-cart.html.twig) den Block component_offcanvas_cart_actions_cart.

...