CartToPDF — Warenkorb als PDF¶

Extension for Magento 2¶

Bedienungsanleitung¶

CopeX GmbH
Web: https://copex.io
Email: office@copex.io

Inhaltsverzeichnis¶

Abschnitt	Seite
1 Voraussetzungen	2
2 Konfiguration	2
2.1 Allgemeine Einstellungen	2
3 Kundenberechtigung	3
4 Funktionen	3
4.1 Warenkorb als PDF herunterladen	3
5 Fehlerbehandlung	4

1 Voraussetzungen¶

Magento 2.3 oder höher (kompatibel mit 2.4)
PHP 8.1 oder höher
Hyvä Theme oder Luma Theme

2 Konfiguration¶

Die Konfiguration des Moduls finden Sie im Magento 2 Backend unter Shops > Konfiguration > Verkauf > Quote PDF-Einstellungen.

2.1 Allgemeine Einstellungen¶

Navigieren Sie zu Shops > Konfiguration > Verkauf > Quote PDF-Einstellungen.

Modul aktivieren — Schaltet die PDF-Download-Funktion für den Warenkorb ein oder aus (Ja / Nein).
Hintergrundfarbe — Hintergrundfarbe der PDF-Kopfzeile. Auswahl über einen Farbwähler (Hex-Code).
Textfarbe — Textfarbe in der PDF-Kopfzeile. Auswahl über einen Farbwähler (Hex-Code).
Bild hochladen — Logo oder Bild, das in der PDF-Kopfzeile angezeigt wird. Erlaubte Dateitypen: jpg, jpeg, gif, png, svg.

3 Kundenberechtigung¶

Die PDF-Download-Funktion ist nicht für alle Kunden automatisch verfügbar. Der Zugriff wird über ein Kundenattribut gesteuert:

Das Attribut PDF Angebot anzeigen (display_pdf_offer) bestimmt, ob ein eingeloggter Kunde den Download-Button sieht.
Dieses Attribut wird beim Erstellen oder Bearbeiten des Kundenkontos im Backend unter Kunden > Alle Kunden gesetzt.
Neue Kunden erhalten den Wert über das Steuernummer-Feld bei der Kontoerstellung (Plugin-Logik).

Wenn das Modul aktiviert ist und der Kunde die Berechtigung hat, erscheint ein Warenkorb als PDF herunterladen-Button auf der Warenkorb-Seite.

4 Funktionen¶

4.1 Warenkorb als PDF herunterladen¶

Berechtigte, eingeloggte Kunden sehen auf der Warenkorb-Seite (checkout/cart) einen Download-Button.

In der Frontend-Ansicht ist der PDF-Download als zusätzliche Aktion im Warenkorb verfügbar. Der Button steht im Kontext der Warenkorb-Funktionen und ermöglicht den direkten Export ohne Umweg über den Checkout. Falls die Kundenberechtigung (display_pdf_offer) fehlt oder das Modul deaktiviert ist, wird der Button nicht angezeigt.

Ablauf:

Kunde öffnet den Warenkorb und klickt auf den Download-Button.
Das Modul lädt den aktiven Warenkorb (Quote) des Kunden.
Helper\PDFHelper erstellt das PDF-Dokument mit:
Kopfzeile mit konfiguriertem Logo und Farben
Rechnungs- und Lieferadresse des Kunden
Tabelle aller Warenkorbpositionen (Produkt, Menge, Preis)
Gesamtsummen (Zwischensumme, Versand, Gesamt)
Das PDF wird direkt als Download an den Browser geliefert.

Das PDF eignet sich als Angebotsdokument für B2B-Kunden, die einen Warenkorb zur internen Genehmigung weiterleiten müssen.

5 Fehlerbehandlung¶

Download-Button nicht sichtbar — Prüfen Sie, ob das Modul unter Shops > Konfiguration > Verkauf > Quote PDF-Einstellungen aktiviert ist. Prüfen Sie außerdem, ob das Kundenattribut display_pdf_offer für den jeweiligen Kunden auf "Ja" gesetzt ist.
Warenkorb ist leer — Ein PDF kann nur für einen nicht leeren Warenkorb erstellt werden. Wenn der Warenkorb leer ist, antwortet das Modul mit einer Fehlermeldung.
Kein aktiver Warenkorb — Falls kein aktiver Quote gefunden wird (z.B. nach einem Session-Ablauf), wird eine Fehlermeldung zurückgegeben.

Lizenz¶

Proprietär — CopeX GmbH. Eine Lizenz pro produktiver Magento-Instanz. Test- und Entwicklungsumgebungen benötigen keine zusätzliche Lizenz.