Printags für PrestaShop
PrestaShop-Modul für den Verkauf individueller PVC- und NFC-Karten
Ihr Kunde lädt die Gestaltung seiner Karte auf der Produktseite hoch. Die bezahlte Bestellung geht an Printags, das sie druckt und an Ihren Kunden versendet. Die Sendungsnummer kommt zurück in die PrestaShop-Bestellung.
Version 1.0.0 · PrestaShop 8.1, 8.2 und 9 · Lizenz AFL-3.0 · Installation über die zip-Datei, nicht über PrestaShop Addons
Was das Modul macht
Was macht das Printags Modul in Ihrem PrestaShop-Shop?
Die Gestaltung wird auf der Produktseite hochgeladen
Ein Block des Moduls nimmt die Datei entgegen: PNG, JPEG oder PDF bis 25 MB, direkt aus dem Browser des Kunden an Printags gesendet, mit Vorschau und Prüfung der Proportionen der Karte (89,6 × 57,98 mm). PrestaShop behält nur die Kennung der Datei, in der Personalisierung der Warenkorbposition.
Ein Link im NFC-Chip
Der Kunde kann einen Link angeben, der in den Chip codiert wird. Das Sperren des Chips (nur lesbar) ist eine Option pro Produkt, standardmäßig aus und unwiderruflich.
Die bezahlte Bestellung wird zur Printags-Bestellung
Sobald die Bestellung einen bezahlten Status erreicht, holt das Modul ein Angebot bei Printags ein, prüft Ihr Guthaben und legt dann die verbindliche Bestellung an. Nie doppelt, und nach einem Netzwerkfehler automatisch erneut gesendet.
Die Sendungsverfolgung kommt zurück in die Bestellung
Die Sendungsnummer wird beim Versanddienst der Bestellung eingetragen, wie im Back-Office, in Echtzeit per Webhook oder bei jedem Lauf des Cronjobs. Standardmäßig erhält der Kunde die E-Mail „Unterwegs“ und die Bestellung wird auf „Versendet“ gesetzt.
Ein Testmodus in der Sandbox
Im Testmodus werden die Bestellungen in der Printags Sandbox angelegt: weder berechnet noch gefertigt. Test und Produktion haben jeweils eine eigene Verbindung.
Eine Kopie des Shops sendet nichts
Die Verbindung ist an die Adresse des Shops gebunden. Auf einer Kopie (Staging) geht keine Bestellung an Printags, und die ursprüngliche Verbindung bleibt unverändert.
Voraussetzungen
Was brauchen Sie, um das Modul zu installieren?
- PrestaShop 8.1, 8.2 oder 9
- PHP 7.2.5 oder neuer, PHP 8.1 oder neuer für PrestaShop 9
- Ein Shop, der über https erreichbar ist
- Ein Cronjob, der alle 5 Minuten eine Adresse aufruft, empfohlen
- Ein Printags-Konto mit aktivem Abonnement
- Oberfläche des Moduls auf Deutsch, Englisch, Französisch, Spanisch und Italienisch
Die Karten, die das Modul bestellt, werden zu den Preisen Ihres Printags-Plans berechnet und bei jeder gesendeten Bestellung vom Guthaben des Kontos abgebucht.
Installation
Wie installieren und verbinden Sie das PrestaShop-Modul?
1
Laden Sie das Modul herunter
Die Datei printags-prestashop.zip, über die Schaltfläche oben auf dieser Seite. Entpacken Sie sie nicht.
2
Installieren Sie es in PrestaShop
Module > Modul-Verwaltung, dann „Modul hochladen“. Ziehen Sie die zip-Datei in das Fenster oder wählen Sie sie aus: PrestaShop installiert das Modul.
3
Öffnen Sie die Konfiguration des Moduls
Klicken Sie am Ende der Installation auf „Einstellungen“ oder in der Modul-Verwaltung auf das Printags Modul.
4
Wählen Sie den Testmodus und speichern Sie
Das Modul startet im Produktionsmodus. Wählen Sie Test: Die Bestellungen laufen über die Printags Sandbox und werden weder berechnet noch gefertigt. Speichern Sie vor dem Verbinden, die Verbindung gilt für den gewählten Modus.
5
Klicken Sie auf „Printags verbinden“
Kein API-Schlüssel zum Kopieren: Die Verbindung ist eine OAuth-Freigabe bei Printags. Der Shop muss https verwenden.
6
Geben Sie den Shop in Ihrem Printags Dashboard frei
Melden Sie sich bei Ihrem Printags-Konto an und bestätigen Sie die Verbindung. Im Produktionsmodus können nur der Kontoinhaber und seine Administratoren einen Shop verbinden. Zurück in PrestaShop zeigt die Konfiguration das verbundene Konto und sein Guthaben.
7
Legen Sie Ihre Printags-Produkte fest
Bereich „Printags-Produkte“, „Produkt hinzufügen oder ändern“: Geben Sie die Produkt-ID aus PrestaShop ein, wählen Sie das Printags-Produkt im Katalog (das Kartenmodell) und bei Bedarf die Verpackung. Aktivieren Sie „Chip nach der Kodierung sperren“ nur, wenn der Chip nie wieder beschrieben werden darf. Der Upload-Block erscheint dann auf der Produktseite.
8
Richten Sie den Cronjob ein
Der Bereich „Versand und Sendungsverfolgung“ zeigt eine Adresse, die der Cron Ihres Servers alle 5 Minuten aufrufen soll: Sie sendet die bezahlten Bestellungen. Ohne Cronjob sendet die standardmäßig aktive Option „Fällige Bestellungen auch nach Back-Office-Seiten senden“ sie höchstens alle 5 Minuten, solange jemand das Back-Office nutzt.
9
Geben Sie eine Testbestellung auf
Bestellen Sie dieses Produkt in Ihrem Shop mit einer hochgeladenen Gestaltung und setzen Sie die Bestellung auf einen bezahlten Status. Die Notiz „Printags: TEST-Bestellung erstellt“ erscheint auf der Bestellseite im Back-Office.
10
Wechseln Sie in die Produktion
Wählen Sie den Modus Produktion, speichern Sie und klicken Sie erneut auf „Printags verbinden“: Jeder Modus hat seine eigene Verbindung. Bezahlte Bestellungen werden dann gedruckt, versendet und berechnet.
Häufige Fragen
Das Printags Modul für PrestaShop
Wie werden die Karten berechnet, die das Modul bestellt?
Zu den Preisen Ihres Printags-Plans. Der Betrag wird bei jeder gesendeten Bestellung vom Prepaid-Guthaben des Kontos abgebucht, nach dem Angebot, das das Modul bei Printags einholt.
Was passiert, wenn das Guthaben meines Printags-Kontos nicht reicht?
Die Bestellung wird nicht gesendet und wartet. Ihr PrestaShop-Status ändert sich nicht, Ihr Kunde erhält also keine E-Mail. Eine Notiz nennt Betrag und Guthaben, und eine E-Mail geht an die Adresse des Shops. Laden Sie das Konto auf und klicken Sie dann auf „An Printags senden“, auf der Bestellseite oder in der Liste „Bestellungen, die auf Sie warten“ der Modulkonfiguration.
Wird eine in PrestaShop stornierte oder erstattete Bestellung bei Printags storniert?
Nicht automatisch, sobald sie gesendet wurde: Eine Notiz und eine E-Mail informieren Sie, und Sie stornieren sie in Ihrem Printags Dashboard, falls sie nicht gefertigt werden soll. Vor dem Senden erstattete Karten werden nicht bestellt.
Werden Bestellungen mit Zahlung bei Lieferung an Printags gesendet?
Ja, sobald sie bezahlt sind: wenn die Bestellung „Zahlung eingegangen“ oder „Bestellung ausgeliefert“ erreicht, oder mit „An Printags senden“. Das Modul ps_cashondelivery wird von Haus aus erkannt, weitere Zahlungsmodule für Zahlung bei Lieferung lassen sich in den Einstellungen hinzufügen. Die Option „Bestellungen mit Zahlung bei Lieferung automatisch senden“, standardmäßig aus, sendet sie sofort: Ihr Printags-Guthaben wird dann belastet, bevor Ihr Kunde zahlt.
Wohin geht die Datei meines Kunden, und welche Daten erhält Printags?
Die Gestaltung geht direkt aus dem Browser des Kunden an Printags, über einen signierten Einmal-Link: Sie wird nicht auf Ihrem Server gespeichert, PrestaShop behält nur die Kennung der Datei. Nach der Zahlung erhält Printags die Bestellpositionen, die Kennung der Gestaltung, den NFC-Link und die Lieferadresse (Name, Adresse, Telefon, E-Mail), um die Karten zu drucken und zu versenden.
Brauche ich einen Cronjob?
Er wird empfohlen: Ein Cronjob, der die in der Modulkonfiguration angezeigte Adresse alle 5 Minuten aufruft, sendet die bezahlten Bestellungen und holt die Sendungsverfolgung ab. Ist das Modul Cron-Aufgaben-Manager (cronjobs) installiert, wird die Aufgabe dort zusätzlich stündlich eingetragen. Ohne Cronjob gehen die Bestellungen höchstens alle 5 Minuten hinaus, solange jemand das Back-Office nutzt.
Muss mein Shop aus dem Internet erreichbar sein?
Für die Sendungsverfolgung in Echtzeit ja: Printags ruft einen Webhook in Ihrem Shop auf, über https. Ohne Webhook fragt der Cronjob den Status offener Bestellungen stündlich ab.
Kann ich das Modul auf einer Kopie meines Shops nutzen?
Die Verbindung ist an die Adresse des Shops gebunden, auf dem sie hergestellt wurde. Auf einer Kopie (Staging) wird keine Bestellung gesendet, und die ursprüngliche Verbindung wird weder erneuert noch widerrufen. Ist der Shop wirklich umgezogen, verbinden Sie Printags erneut.
Ist das Modul auf PrestaShop Addons?
Nein. Es wird mit der zip-Datei dieser Seite installiert: Module > Modul-Verwaltung, „Modul hochladen“.
Ihre ersten Karten, verkauft über PrestaShop
Installieren Sie das Modul, verbinden Sie Ihr Konto im Testmodus und geben Sie eine Testbestellung auf, bevor Sie den Verkauf starten.