Entpacken Sie das Modul-zip-Paket.
Windows hat eine Beschränkung auf eine maximale Pfadlänge. Wird beim Entpacken des Modul-Zip-Paketes die Pfadlänge überschritten, kann das Modulpaket unvollständig sein. Somit wären nach der Übertragung der Modul-Dateien auf Ihren Webspace Probleme mit dem Modul in Ihrem Shop vorprogrammiert. Um mögliche Konflikte mit der Windows-Pfadlängenbegrenzung zu vermeiden, sollten Sie als Windows-Nutzer das Modul-zip-Paket möglichst weit oben in der Ordnerstruktur Ihres Rechners entpacken - im Idealfall direkt unter C:.
In diesem zip-Paket finden Sie einen Datei-Ordner, welcher zwei Unterverzeichnisse hat: admin und GXModules.
Der nachfolgend genannte Platzhalter [root] steht für den Ordner in dem Ihr Shop am Server installiert ist.
Laden Sie per FTP-Programm die Dateien aus Ihrem lokalen Ordner /admin/ in den Ordner [root]/admin/ am Server auf dem Ihr Shop installiert ist.
Achten Sie darauf den Inhalt in das korrekte Unterverzeichnis zu kopieren!
Laden Sie per FTP-Programm die Dateien aus Ihrem lokalen Ordner /GXModules/ in den Ordner [root]/GXModules/ am Server auf dem Ihr Shop installiert ist.
Befindet sich im Ordner [root]/GXModules/ bereits ein Ordner /LW/ (weil Sie weitere Module von uns im Einsatz haben) laden Sie per FTP-Programm die Dateien aus Ihrem lokalen Ordner /GXModules/LW/ in den Ordner [root]/GXModules/LW/ am Server auf dem Ihr Shop installiert ist.
Achten Sie darauf das die Moduldateien vollständig übertragen werden - das es keine fehlgeschlagenen Übertragungen gibt!
Rufen Sie im Shop den Gambio-Admin-Bereich auf. Leeren Sie unter Toolbox -> Cache den Cache in der nachfolgenden Reihenfolge:
Wird der Cache in einer anderen Reihenfolge geleert, besteht die Gefahr, das die Shop-Erweiterungen des Moduls nicht korrekt funktionieren respektive angezeigt werden!
Im Ordner [root]/GXModules/LW/Licenses wird während der nachfolgend beschriebenen Modul-Installation die Datei securityConfig.json angelegt. Die Datei enthält den Sicherheitsschlüssel, mit welchem die Lizenzschlüssel in der Datenbank verschlüsselt abgespeichert werden. Auf Ihrem Webspace müssen auf diesen Ordner ausreichende Schreibrechte zugewiesen sein - sonst kann die Datei nicht angelegt werden! Bitte prüfen Sie vor Modul-Installation ob dem Ordner die entsprechenden Schreibrechte zugewiesen sind!
Wechseln Sie nach Module -> Modul-Center. In der Liste der verfügbaren Module finden Sie einen Eintrag mit der Bezeichnung Lizenzschlüssel Vertriebsmodul. Markieren Sie diese Zeile. Durch einen Klick auf den Button Installieren installiert sich das Modul in den Shop.
Nach Modul-Installation sollte geprüft werden, ob unter [root]/GXModules/LW/Licenses die Datei securityConfig.json angelegt wurde. Ist die Datei nicht vorhanden, muss das Modul wieder deinstalliert, dem Ordner [root]/GXModules/LW/Licenses ausreichende Schreibrechte zugewiesen und das Modul erneut installiert werden.
Nach der Installation müssen ein weiteres mal folgende Caches geleert werden:
Achten Sie darauf die Caches in der richtigen Reihenfolge zu leeren!
In der Modul-Konfiguration nehmen Sie allgemeine Einstellungen für das Modul vor. Die Modul-Konfiguration können Sie auf folgendem Weg aufrufen:
Der Bereich Allgemein hat aktuell nur eine Einstellmöglichkeit - den Schalter Status. Mit dem Schalter wird die komplette Modul-Funktionalität ein- respektive ausgeschaltet. Steht der Status-Schalter auf aus, werden alle Modul-Erweiterungen im Shop-Admin-Bereich sowie im Shop-Frontend nicht mehr angezeigt. Zudem ist die automatische Zuweisung von Lizenzschlüsseln durch den Cronjob deaktiviert. Das heißt, bei Bestellung eines lizenzschlüsselfähigen Artikels erfolgt keine automatische Zuordnung eines freien Lizenzschlüssels.
Mit den nachfolgenden Einstellungen wird der Versand der Lizenzschlüssel per E-Mail zum Kunden gesteuert. Der Versand der E-Mail ist abhängig von den nachfolgend zu konfigurierenden Werten. Zusätzlich zu diesen Werten müssen noch folgende Bedingungen erfüllt sein:
Das Versenden der Lizenzschlüssel per E-Mail an den Kunden wird automatisiert durch den Gambio CronJob ausgelöst. Dieser CronJob läuft üblicherweise jede Minuten. Beim Ausführen des CronJobs prüft der Prozess, ob es Bestellungen gibt, deren aktueller Status einem der konfigurierten Status (welche den E-Mail-Versand auslösen sollen - siehe nächster Konfigurationspunkt) entspricht. Mit der Zeitraum-Konfiguration wird die Zeitspanne festgelegt, welche der CronJob zurückblicken soll. Alle Bestellungen, welche in dem konfigurierten Zeitraum eine Bestellstatusänderung erfahren haben, werden vom CronJob verarbeitet.
Der konfigurierte Wert muss größer sein als das Intervall, in welchem der Gambio-CronJob aufgerufen wird (Im Gambio-Standard 1 Minute).
Wir empfehlen den Wert auf ca. 10 Minuten einzustellen.
In dieser Konfiguration werden die Bestellstatus festgelegt, welche den Versand der Lizenzschlüssel per E-Mail an den Kunden auslösen. Die Konfiguration erlaubt es mehrere Bestellstatus auszuwählen.
Sollte das DropDown-Feld keine Bestellstatus anzeigen, muss noch einmal eine Modul-Cache-Löschung sowie ein Reload der Modul-Konfigurationsseite ausgeführt werden.
Um eine Automatisierung des kompletten Lizenzschlüssel-Prozesses zu erreichen sollten hier alle Status konfiguriert werden, welche von den (im Shop eingesetzten) Bezahlmodulen nach erfolgreicher Bezahlung automatisch gesetzt werden. Werden hier Status konfiguriert, die nicht automatisch gesetzt werden, muss der Shop-Betreiber einen der konfigurierten Status manuell (z. B. über die Admin-Bestellübersicht) setzen. Damit die Lizenzschlüssel-E-Mail an den Kunden ausgelöst wird, muss eine Bestellung mindestens einen der konfigurierten Status erreicht haben.
Für die automatisierte Zuweisung von Lizenzschlüssel zu den Bestell-Artikeln und den Versand der Lizenzschlüssel-E-Mail an den Kunden ist der Gambio CronJob zuständig. Um zu prüfen ob der CronJob bereits eingerichtet ist, wechseln Sie im Admin-Bereich in die Toolbox. Unter Zeitgesteuerte Aufgaben finden Sie die Informationen zum CronJob. Im Bereich Allgemein zeigt der Status an ob der CronJob bereits läuft (grünes aktiv) oder nicht (rotes inaktiv). Falls noch kein CronJob eingerichtet ist (Status inaktiv unter Allgemein), finden Sie im Gambio-Handbuch unter dem Punkt Zeitgesteuerte Aufgaben eine Anleitung.
Um den CronJob für den Lizenzschlüssel E-Mail-Versand zu aktivieren im Bereich Aufgaben in der Zeile Lizenzschlüssel E-Mail-Versand auf das Stift-Symbol klicken. Im Konfigurationsfenster den CronJob aktivieren und das Abrufintervall einstellen. Wir empfehlen ein minütliches Abrufintervall.
Angelegte Lizenzschlüssel werden in der Shop-Datenbank verschlüsselt gespeichert. Für die Ver-/Entschlüsselung ist ein Verschlüsselungskey nötig, welcher während des Installationsprozesses automatisch erzeugt wird. Nur mit Hilfe dieses Verschlüsselungskeys können die Lizenzschlüssel in die Shop-Datenbank geschrieben respektive von dort ausgelesen werden. Der Verschlüsselungskey wird auf dem Server in der Datei [root]/GXModules/LW/Licenses/securityConfig.json gespeichert.
Machen Sie von der Datei [root]/GXModules/LW/Licenses/securityConfig.json unbedingt ein Backup und speichern Sie das Backup an einem sicheren Ort! Wird der Verschlüsselungskey in der Datei geändert, gelöscht oder geht die Datei verloren, können die Lizenzschlüssel aus der Shop-Datenbank ohne Backup dieser Datei nicht wieder hergestellt werden.
Das Modul wird mit einer Vorlage für die Kunden-Lizenzschlüsselmail ausgeliefert. Diese Vorlage kann individuell angepasst werden. Rufen Sie hierfür den Shop-Admin-Bereich auf und wechseln Sie zu Kunden -> E-Mails. Im Reiter E-Mail-Vorlagen findet sich die Vorlage Lizenzschlüssel. Ein Klick auf den Text öffnet das Bearbeitungsfenster.
Nach Anpassung einer Mail-Vorlage muss der Cache für E-Mail-Vorlagen geleert werden!
Das Modul verwendet den Begriff Lizenzschlüssel. In der Praxis kommen dafür auch viele andere Synonyme zum Einsatz - z. B. „Softwareschlüssel“, „Product Key“ „Freischaltkey“, „Freischaltnummer“ „Aktivierungscode“, "Passwörter".
Die vom Modul verwendeten Texte lassen sich im Shop anpassen. Wechseln Sie hierfür im Admin-Bereich zu Inhalte -> Texte anpassen. Geben Sie unter Suchtext die Textpassage ein die Sie ändern möchten. Führen Sie anschließend die Suche aus. Jeder Suchtreffer lässt sich nach einen Klick auf Bearbeiten individuell anpassen.
Nach einer Text-Anpasusng müssen die Caches für Texte und Seitenausgabe geleert werden!
Jeder Artikel kann lizenzschlüsselfähig werden. Der entscheidende Faktor ist, ob zu einem Artikel Lizenzschlüssel angelegt wurden (siehe nächstes Kapitel). Zudem spielt der Zeitpunkt, wann der erste Lizenzschlüssel zu einem Artikel angelegt wurde, eine entscheidende Rolle. Dieser Zeitpunkt (nachfolgend mit Grenz-Zeitpunkt bezeichnet) ist die Abgrenzung zwischen alten Bestellungen, welche vom Lizenzschlüssel-Prozess nicht verarbeitet, und neuen Bestellungen, zu welchen Lizenzschlüssel vergeben werden sollen. Eine Bestellung (respektive die Bestell-Artikel darin) wird dann vom Lizenzschlüssel-Prozess verarbeitet, wenn das Bestelldatum jünger ist als der Grenz-Zeitpunkt. Dabei wird für jeden Artikel der artikelspezifische Grenz-Zeitpunkt ermittelt und mit dem Bestelldatum verglichen.
Für die Anlage von Linzenzschlüsseln unter einem Artikel rufen Sie im Admin-Bereich über den Menüpunkt Artikel sowie den Unterpunkt Artikel/Kategorien den gewünschten Artikel auf. In der Artikel-Konfigurationsoberfläche, welche Sie über den Button Bearbeiten erreichen, finden Sie den Abschnitt Lizenzschlüssel. Der Abschnitt besteht aus 3 Sektionen:
In der Sektion Verfügbare Lizenzschlüssel finden sie alle noch verfügbaren Lizenzschlüssel welche noch nicht verkauft sind. Über den Button löschen kann ein verfügbarer Lizenzschlüssel gelöscht werden. Die Löschung eines Lizenzschlüssel wird erst durch Speichern respektive Aktualisieren des Artikels endgültig ausgeführt.
In der Sektion Neue Lizenzschlüssel anlegen können neue Lizenzschlüssel hinzugefügt werden. Neue Lizenzschlüssel müssen zeilenweise eingegeben werden. Erst durch Speichern respektive Aktualisieren des Artikels werden die neuen Lizenzschlüssel in die Datenbank gespeichert.
Bei Anlage von neuen Lizenzschlüsseln findet eine Dublettenprüfung statt. Ein Lizenzschlüssel darf auf Artikel-Ebene nicht mehrfach vorkommen. Dubletten werden nicht angelegt, erzeugen einen Fehler-Hinweis nach der Verarbeitung.
In der Sektion Verbrauchte Lizenzschlüssel werden alle verkaufen Lizenzschlüssel aufgelistet. Durch Klick auf die Bestellnummer kann die entspechende Bestellung aufgerufen werden.
Der Bestellprozess wird durch das Modul nicht beeinflusst. Für den Kunden ist kein Unterschied zum Gambio-Standard-Bestellprozess zu sehen.
Die Zuweisung von verfügbaren Lizenzschlüsseln zu einem Bestellartikel erfolgt durch den Gambio-CronJob (siehe Kapitel Gambio CronJob einrichten), welcher üblicherweise minütlich ausgeführt wird.
Der CronJob verarbeitet alle Bestellungen, welche im konfigurierten Zeitraum (siehe Kapitel Zeitraum für verarbeitende Bestellstatusänderungen in Minuten) eine Bestellstatusänderung erfahren haben. Dabei werden nur Bestellstatusänderung berücksichtigt, die einem der konfigurierten Bestellstatus (siehe Kapitel Bestellstatus E-Mail-Versand Lizenzschlüssel) entsprechen.
Bei den relevanten Bestellungen werden nur Artikel verarbeitet, welche den Lizenzschlüsselprozess unterstützen (Artikel bei denen mindestens schon einmal ein Lizenzschlüssel hinterlegt wurde). Unterstützt ein Bestell-Artikel den Lizenzschlüsselprozess und wurden diesem noch keine Lizenzschlüssel zugewiesen, erledigt dies der CronJob-Prozess.
Nachdem die Lizenzschlüssel dem Bestell-Artikel zugewiesen wurden generiert der CronJob die Lizenzschlüssel-E-Mail und versendet diese an den Kunden.
Im Fall, das die Anzahl der verfügbaren Lizenzschlüssel kleiner ist als die Bestellmenge, bekommt der Shop-Admin pro Bestellung eine Mail mit den Daten der Mindermenge.
In diesem Fall müssen neue Lizenzschlüssel angelegt werden. Nach Anlage der fehlenden Lizenzschlüssel muss dafür gesorgt werden, das die betroffenen Bestellungen erneut vom CronJob verarbeitet werden. Durch das manuelle Setzen eines der konfigurierten Bestellstatus (siehe Kapitel Bestellstatus E-Mail-Versand Lizenzschlüssel) landet eine Bestellung wieder im Verarbeitungspool des CronJob.
Auch wenn eine betroffene Bestellung schon einen aktuellen Status hat, der einem der konfigurierten Bestellstatus (siehe Kapitel Bestellstatus E-Mail-Versand Lizenzschlüssel) entspricht, muss erneut ein entsprechender Status gesetzt werden. Nur durch das erneute Setzen eines Status bekommt der Statuszeitstempel einen aktuellen Wert - welcher das zweite Kriterium dafür ist, das eine Bestellung wieder im CronJob-Verarbeitungspool landet.
Neben der E-Mail mit den Lizenzschlüsseln findet ein Kunde seine Lizenzschlüssel auch in seinem Kundenkonto. Ruft ein Kunde unter Ihr Konto sein Konto auf, finden sich unter Meine Bestellungen die letzten platzierten Bestellungen. Enthält eine Bestellung ein Produkt, welches den Lizenzschlüsselprozess unterstützt, werden die Lizenzschlüssel in einer eigenen Spalte angezeigt.
Wechselt der Kunde in die Bestell-Detailansicht, sind auch hier etwaige Lizenzschlüssel innerhalb der Artikel-Auflistung zu finden.
Konnte auf Grund von zu wenigen verfügbaren Lizenzschlüsseln nicht die ganze Bestellmenge verarbeitet werden, wird dies durch eine Textphrase bei den Lizenzschlüsseln angezeigt.
Im Admin-Bereich finden sich zugewiesene Lizenzschlüssel (analog zum Kundenkonto) in der Bestell-Detailansicht. Die Admin-Bestell-Detailansicht listet im Abschnitt Artikel die bestellten Produkte auf. Die Lizenzschlüssel finden sich in einem separaten Bereich unterhalb des Artikel-Abschnitts.
Wird im Shop ein lizenzschlüsselfähiger Artikel gelöscht, werden auch sämliche, zu dem gelöschten Artikel noch verfügbaren Lizenzschlüssel aus der Datenbank entfernt. Datensätze mit verkauften Lizenzschlüsseln zu dem gelöschten Artikel bleiben hingegen erhalten.
Wechseln Sie im Shop-Admin-Bereich nach Module -> Modul-Center. In der Liste der verfügbaren Module markieren Sie den Eintrag mit der Bezeichnung Lizenzschlüssel Vertriebsmodul. Nach Klick auf den Button Deinstallieren und bestätigen der nachfolgenden Sicherheitsabfrage wird das Modul deinstalliert.
Bei Modul-Installation wurden in der Shopdatenbank folgende Tabelle angelegt:
Damit verkaufte Lizenzschlüssel auch nach Deinstallation des Moduls erhalten bleiben, werden die bei Installation erstellten Datenbanktabellen bei Deinstallation nicht gelöscht! Wird nach Deinstallation das Modul erneut installiert, stehen die Daten der Tabellen wieder zur Verfügung.
Nach Deinstallation müssen im Shop-Admin-Bereich unter Toolbox -> Cache die Caches geleert werden:
Achten Sie darauf die Caches in der richtigen Reihenfolge zu leeren!
ACHTUNG - sämtliche Lizenzschlüssel werden gelöscht, können nicht wieder hergestellt werden!
Möchten Sie die Moduldaten aus dem Shop entfernen, verbinden Sie sich mittels eines FTP-Programms mit Ihrem Server. Wechseln Sie in das Verzeichnis in das Ihr Shop installiert ist. Rufen Sie dort den Ordner /GXModules/LW/ auf. Die Moduldaten können gelöscht werden, in dem der Unterordner /Licenses/ und sein kompletter Inhalt entfernt wird. Befinden sich in dem /LW/ Ordner keine weiteren Daten, kann auch dieser gelöscht werden.
Löschen Sie die Datei order_status_multiselect.html aus folgendem Ordner: [root]/admin/html/content/module_center/gx_modules/snippets.
Nach Löschen der Ordner müssen im Shop-Admin-Bereich unter Toolbox -> Cache die Caches geleert werden:
Achten Sie darauf die Caches in der richtigen Reihenfolge zu leeren!
Öffnen Sie die Admin-Oberfläche Ihrer Shop-Datenbank. Ihr Hoster stellt Ihnen diese üblicherweise über ein Tool zur Verfügungen (oftmals phpMyAdmin). Löschen Sie folgende Tabellen:
Fehler
Nach Modul-Installation wird in der Modul-Konfiguration unter Bestellstatus E-Mail-Versand Lizenzschlüssel nur der Wert Alle auswählen zur Auswahl angeboten. Es gibt keine Auswahl der im Shop vorhandenen Bestellstatus.
Ursache
Relevante Shop-Caches sind nicht aktuell.
Lösung
Shop-Caches in folgender Reihenfolge leeren:
Fehler
Nach Modul-Installation fehlt unter [root]/GXModules/LW/Licenses die Datei securityConfig.json.
Ursache
Dem Ordner [root]/GXModules/LW/Licenses sind auf dem Webspace keine ausreichenden Schreibrechte zugewiesen.
Lösung
Das Modul wieder deinstallieren, dem Ordner [root]/GXModules/LW/Licenses die nötigen Schreibrechte zuweisen und das Modul wieder installieren.
Fehler
Nach Modul-Installation erscheint bei Aufruf des ModuleCenters die Fehlermeldung Call to undefined function GXModules\LW\Licenses\sodiumcrypto....
Ursache
Auf dem Shop-Webspace fehlt die PHP-Bibliothek Sodium.
Lösung
Für die Ver-/Entschlüsselung der Lizenzschlüssel kommt die PHP-Bibliothek Sodium zum Einsatz. Die Bibliothek wird seit PHP 7.2 im Core ausgeliefert. Es kann sein, das diese auf Ihrem Webspace deaktiviert wurde. Prüfen können Sie das, in dem Sie im Shop-Admin-Bereich Server Info aufrufen. In der Sektion PHP Version finden Sie eine Liste mit allen installierten/aktiven PHP-Bibliotheken. In der alphabetisch nach Bibliothek-Namen sortierte Liste sollten Sie einen Eintrag für Sodium finden. Ist kein Eintrag vorhanden, ist die Bibliothek nicht installiert. Ist ein Eintrag vorhanden aber die Info zeigt disabled an, ist die Bibliothek deaktiviert. In beiden Fällen nehmen Sie bitte Kontakt mit Ihrem Webhoster auf um die Bibliothek installieren/aktivieren zu lassen.
Fehler
Nach Modul-Installation werden einem Artikel keine Lizenzschlüssel zugewiesen. In der Bestell-Detailansicht ist nichts zu finden und es wird keine Lizenzschlüssel-Mail an den Kunden versendet.
Mutmaßliche Ursache
Ob ein Artikel den Lizenzschlüsselprozess unterstützt oder nicht wird ermittelt, in dem abgefragt wird, ob bei dem Artikel jemals ein Lizenzschlüssel hinterlegt wurde. Der Prozess verarbeitet den Artikel nicht, weil vermutlich vergessen wurde unter dem Artikel Lizenzschlüssel anzulegen.
Lösung
Lizenzschlüssel unter dem Artikel anlegen.
Fehler
Der CronJob läuft auf Fehler.
Mutmaßliche Ursache
Es wurde vergessen die Modul-Konfiguration vorzunehmen.
Lösung
In der Modul-Konfiguration müssen Werte für Zeitraum für verarbeitende Bestellstatusänderungen in Minuten und/oder Bestellstatus E-Mail-Versand Lizenzschlüssel vergeben werden.
Fehler
In der Bestell-Detailansicht steht bei einem Artikel der Text Fehlende Lizenzschlüssel werden nachgereicht.
Ursache
Der betroffene Bestell-Artikel hat keine für die Bestellung ausreichend verfügbare Menge an Lizenzschlüssel.
Lösung
Dem Artikel müssen neue Lizenzschlüssel hinzugefügt werden. Anschließend muss der betroffenen Bestellung ein Status zugewiesen werden, welcher die E-Mail an den Kunden auslöst.
Fehler
In der Bestell-Detailansicht steht bei einem Artikel der Text Lizenzschlüssel wurden noch nicht zugewiesen!.
Ursache 1
Die Bestellung wurde vom CronJob noch nicht verarbeitet.
Lösung 1
Beim nächsten Lauf des CronJob werden die Lizenzschlüssel zugewiesen und der Text ist verschwunden.
Ursache 2
Der Bestellung konnten kein einziger Lizenzschlüssel zugeordnet werden, da alle Bestell-Artikel keine verfügbaren Lizenzschlüssel haben.
Lösung 2
Bei den Bestell-Artikeln muss eine ausreichende Anzahl an Lizenzschlüsseln hinzugefügt werden. Anschließend muss der betroffenen Bestellung ein Status zugewiesen werden, welcher die E-Mail an den Kunden auslöst.
Fehler
Anstatt eines Lizenzschlüssels wird der Text license key decryption failed angezeigt.
Ursache
Entweder fehlt im Modul-Root-Verzeichnis die Datei securityConfig.json oder diese wurde umbenannt oder in der Datei fehlt der Schlüssel mit dem die verschlüsselten Lizenzschlüssel entschlüsselt werden können.
Lösung
Laden Sie auf Ihrem Webspace in das Modul-Root-Verzeichnis Ihr Backup der securityConfig.json.