verfügbar
Version 1.0.0
last update 2025-08-17
Sinn und Zweck dieses Moduls
Erleichtern Sie Ihren KundInnen die Zahlung per Banküberweisung oder Rechnung und bieten Sie einen Girocode QR Code an, der mit allen Banking-Apps gescannt werden kann.
Damit entfällt das manuelle Eintippen irgendwelcher ewig langen IBANs und anderer Daten. Kontoinhaber, Betrag, BIC, IBAN und Verwendungsweck sind automatisch mit den Daten der Shopbestellung vorbefüllt.
Dieses Modul generiert in Ihrem Zen Cart Shop bei den Zahlungsarten Banküberweisung (eustandardtransfer) und/oder Zahlung auf Rechnung (invoice) den entsprechenden Girocode QR-Code und zeigt ihn auf der checkout_success Seite an. Der QR Code steht auch im Kundenkonto bei der Bestellübersicht und optional auf der PDF Rechnung und der Admin Rechnung in der Shopadministration bereit.
Auch das HTML Email der Bestellbestätigung zeigt den QR Code an.
Der Code enthält Ihre in den entsprechenden Zahlungsmodulen hinterlegten Empfänger Bankdaten, den Betrag der Shopbestellung und als Verwendungszweck die Bestellnummer.
Die Größe des an den verschiedenen Stellen angezeigten QR-Codes ist via Shopadministration einstellbar.
Verwendet wird ein Girocode konformer EPC-QR-Code , der von allen Banking Apps im SEPA Raum gelesen werden kann.
Die generierten .png Bilder werden am Server gespeichert und stehen dadurch auch für etwaige weitere Software, die im Rahmen Ihrer Bestellbearbeitung verwendet wird, zur Verfügung.
Copyright
Copyright
(c) 2025 webchills (www.webchills.at)
Portions Copyright (c) 2003-2025 Zen Cart
Lizenz:
This contribution is subject to version 3.0 of the GPL license available through the world-wide-web at the following url:
https://www.zen-cart-pro.at/license/3_0.txt
Danke, dass Sie dieses Modul gekauft haben.
Sie können es auf einer Domain Ihrer Wahl einsetzen.
Dies ist keine Freeware, eine Weitergabe oder Nutzung auf weiteren Domains ist nicht gestattet.
Installation
Voraussetzungen
Dieses Modul ist nur für Zen Cart 1.5.7j deutsch geeignet.
Stellen Sie sicher, dass Sie Ihren Shop auf 1.5.7j aktualisiert haben, bevor Sie dieses Modul installieren.
Im Shop sind die Zahlungsmodule eustandardtransfer und/oder invoice aktiv und konfiguriert.
WICHTIG:
Für den Einbau dieses Moduls sollten Sie über folgende Werkzeuge verfügen:
1) Ein guter Texteditor.
Damit ist nicht das in Windows enthaltene Notepad oder Microsoft Word gemeint.
Sie benötigen einen Texteditor, der utf-8 versteht und auch im Format utf-8 ohne BOM abspeichern kann.
Meine Empfehlung: UltraEdit (kostenlose 30 Tage Testversion verfügbar)
Ebenfalls gut geeignet ist der kostenlose Texteditor Notepad++
2) Ein Tool zum Vergleichen von Dateien
Bei der Installation dieses Moduls ist es erforderlich, dass Sie den Inhalt einiger Ihrer bestehenden Zen Cart Dateien mit dem Inhalt der neuen Moduldateien vergleichen und die Änderungen zusammenführen ("mergen").
Meine Empfehlung: BeyondCompare (kostenlose 30 Tage Testversion verfügbar)
Ebenfalls gut geeignet ist das kostenlose Programm WinMerge
Empfehlung:
Dieses Modul erst in einem Testsystem einbauen und dort konfigurieren/testen und endgültig an die eigenen Wünsche anpassen. Erst dann in einem Liveshop einsetzen! Sichern Sie unbedingt alle Dateien Ihres Shops per FTP und sichern Sie die Datenbank mit phpMyAdmin oder anderen geeigneten Tools!
Vor dem Einbau dieser Änderungen:
BACKUP von Shop und Datenbank machen!
Keine Haftung, Verwendung auf eigene Gefahr!
BACKUP gemacht? Ok, dann weiterlesen...
Die Installation erfolgt in folgenden Schritten. Halten Sie diesen Ablauf ein!
1)
Legen Sie zunächst mit Ihrem FTP Programm am Server einen neuen Ordner an, in dem später die generierten QR-Code Bilddateien gespeichert werden.
Nennen Sie ihn wie Sie wollen, z.B. shop-girocodes
Dieser Ordner sollte unterhalb Ihres Shopverzeichnisses liegen, damit der Inhalt keinesfalls per http erreichbar ist.
Wenn Ihr Shop z.B. in folgendem Verzeichnis liegt:
/www/htdocs/a12345678/www.meinshop.de/
Dann sollten Sie das Verzeichnis shop-girocodes eine Ebene darunter erstellen:
/www/htdocs/a12345678/shop-girocodes/
Geben Sie dem Ordner shop-girocodes Schreibrechte (chmod 777)
Laden Sie nun die drei Dateien aus dem Ordner NEUER ORDNER UNTERHALB DES SHOPVERZEICHNISSES/shop-girocodes in Ihr shop-girocodes Verzeichnis hoch.
2)
Im Ordner NEUE DATEIEN alle Ordner namens DEINTEMPLATE auf das im Shop verwendete Template umbenennen (z.B. responsive_classic). Den Ordner DEINADMIN auf den Namen Ihres admin Verzeichnisses umbenennen.
3)
In die Zen Cart Administration einloggen
4)
Überprüfen Sie nun erst nochmal ob Sie wirklich in Schritt 2 die Ordner in NEUE DATEIEN entsprechend umbenannt haben.
Ja?
Dann nun alle Dateien/Ordner aus dem Ordner NEUE DATEIEN in der vorgegebenen Struktur in die Zen Cart Installation hochladen.
Dabei werden keine bestehende Dateien überschrieben.
5)
In der Zen Cart Administration auf irgendeinen Menüpunkt clicken. Sie sollten oben grüne Erfolgsmeldungen sehen und unter Konfiguration ist nun der neue Menüpunkt "Girocode QR-Code" vorhanden.
6)
Stellen Sie nun unter Konfiguration > Girocode QR Code > Girocode QR Code - Pfad zum girocodes Bilder Ordner den absoluten Pfad zu Ihrem shop-girocodes Ordner ein.
Den absoluten Pfad zu Ihrem Shop-Verzeichnis finden Sie in Ihrer Datei includes/configure.php in der Definition DIR_FS_CATALOG.
Wenn sich Ihr Shop in /www/htdocs/a12345678/www.meinshop.de/ befindet und Sie den Ordner in /www/htdocs/a12345678/ erstellt haben, dann lautet Ihr absoluter Pfad:
/www/htdocs/a12345678/shop-girocodes/
Hinweis: Beenden Sie den Pfad immer mit einem Schrägstrich /
7)
Im Ordner GEAENDERTE DATEIEN befinden sich Beispieldateien für die Dateien, die von diesem Modul geändert werden.
Darunter sind auch die zentrale Datei includes/classes/order.php und die für die pdf Rechnung zentrale Datei includes/classes/class.rl_invoice.php.
Benennen Sie den Ordner DEINTEMPLATE auf den Namen Ihres im Shop aktiven Templates um (z.B. responsive_classic).
Benennen Sie den Ordner DEINADMIN auf den Namen Ihres Zen Cart Admin Verzeichnisses um.
Wenn Sie Zen Cart 1.5.7j gerade frisch installiert haben und noch keinerlei Änderungen an den Dateien vorgenommen haben, können Sie nun die Dateien aus dem Ordner GEAENDERTE DATEIEN in der vorgegebenen Struktur in die Zen Cart Installation hochladen und die bestehenden überschreiben.
Wenn Sie Zen Cart 1.5.7j schon länger im Einsatz haben und schon einmal Änderungen an Dateien vorgenommen oder andere Module eingebaut haben, dann laden Sie die Dateien keinesfalls einfach hoch.
Vergleichen Sie sie stattdessen mit der entsprechenden Datei in Ihrem Shop und nehmen Sie die Änderungen manuell per WinMerge oder BeyondCompare vor.
Dann spielen Sie die geänderten Dateien ein.
8)
Prüfen Sie in der Zen Cart Administration unter Module > Zahlungsarten ob Sie bei den Modulen eustandardtransfer und invoice die korrekten Bankdaten hinterlegt haben.
9)
Jetzt können Sie unter Konfiguration > Girocode QR Code die Anzeige für die gewünschten Zahlungmodule und Anzeigearten aktivieren. Machen Sie eine Testbestellung und prüfen Sie die Funktionalität. Die Größe der angezeigten QR Codes können Sie in der Konfiguration auf Ihr Layout feinabstimmen.
10)
Die QR Code Bilddateien werden als xxx-girocode.png (xxx = Bestellnummer) im Ordner shop-girocodes gespeichert. Falls Sie die Codes zur Anzeige/Verarbeitung in anderen Programmen benötigen, können Sie die also immer diesem Ordner entnehmen.
KONFIGURATION
Alle Einstellungsmöglichkeiten sind unter Konfiguration > Girocode QR-Code erklärt.
Wenn Sie die Darstellung für Frontend, PDF Rechnung, Admin Rechnung und HTML Emails aktiviert haben, wird der Girocode standardmäßig so angezeigt werden:
checkout_success Seite und Bestellübersicht im Kundenkonto:
Admin Rechnung:
Bestellbestätigungs Email:
PDF Rechnung:
Die verwendeten Texte können Sie anpassen in:
includes/languages/german/extra_definitions/girocode.php
Für die pdf Rechnung werden die bereits generierten .png Dateien aus dem Ordner shop-girocodes verwendet. Löschen Sie daher nie die .png Dateien in diesem Ordner, damit sie weiterhin für die pdf Rechnung zur Verfügung stehen.
DEINSTALLATION
1.
Alle von diesem Modul neu angelegten Dateien vom Server löschen.
Alle von diesem Modul geänderten Dateien wieder mit den Originalversionen bzw. den Dateien Ihres Backups ersetzen.
2.
Die Datei uninstall.sql im Ordner SQL mit einem Texteditor öffen und den Inhalt kopieren
3.
Zen Cart Administration öffnen und unter Tools > SQL Patches installieren den Inhalt ins Feld hineinkopieren und absenden.
CHANGELOG
Version 1.0.0 - 17.08.2025
Initial Release