Hilfe zu Kaufquelle

Installation

Kaufquelle läuft mit JTL-Shop 5.6, 5.7 und 5.8 (JTL-Shop 5.7 und 5.8 laufen nur mit PHP 8.3 oder neuer).

1. Kaufen oder testen Sie Kaufquelle im JTL Extension Store.
2. Öffnen Sie im Backend Ihres Shops „Plug-ins > Meine Käufe“ und verknüpfen Sie den Kauf mit Ihrem Shop.
3. Klicken Sie dort bei Kaufquelle auf „Installieren“.
4. Nach der Installation finden Sie Kaufquelle unter „Plug-ins > Installierte Plug-ins > Kaufquelle“.

Die Umfrage einschalten

Nach der Installation zeigt Kaufquelle noch keine Umfrage. So schalten Sie sie ein:

1. Im Reiter „Umfrage“ tragen Sie die Frage und mindestens zwei Antworten ein, für jede Sprache Ihres Shops. Käufer, die in einer Sprache ohne vollständige Texte bestellen, sehen die Umfrage nicht; ein Hinweis oben im Reiter nennt diese Sprachen.
2. Speichern Sie die Umfrage.
3. Im Reiter „Einstellungen“ setzen Sie „Umfrage aktiv“ auf „Ja“ und speichern.
4. Geben Sie eine Testbestellung auf, zum Beispiel mit Vorkasse: Auf der Bestellabschlussseite erscheint die Umfrage.
5. Beantworten Sie sie. Im Reiter „Auswertung“ sehen Sie Ihre Antwort.

Die festen Texte der Umfrage (Dank, Knöpfe, Hinweis auf die Freiwilligkeit) ändern Sie unter „Plug-ins > Plugin-Verwaltung > Kaufquelle > Sprachvariablen“.

Wo die Umfrage erscheint: Template-Block oder CSS-Selektor

Im Reiter „Einstellungen“ wählen Sie unter „Einfügemethode“ eine von zwei Methoden.

Template-Block (NOVA)

Die Voreinstellung. Mit dem Template NOVA oder einem Kind-Template von NOVA erscheint die Umfrage über dem Knopf „Weiter einkaufen“. Ersetzt Ihr Kind-Template diesen Bereich der Bestellabschlussseite, erscheint die Umfrage dort nicht; wählen Sie dann den CSS-Selektor.

CSS-Selektor

Für andere Templates. Sie geben unter „CSS-Selektor“ das Element der Bestellabschlussseite an, an dem die Umfrage erscheinen soll, und unter „Position zum Selektor“, wo: davor, danach, als erstes Kind oder als letztes Kind. Die Voreinstellung ist .order-completed, danach.

Ein Selektor besteht aus Elementnamen, #id und .klasse, verbunden durch Leerzeichen oder >, zum Beispiel #content .order-completed. Attribute, Pseudoklassen wie :first-child, Listen mit Komma und * sind nicht erlaubt. Der Selektor muss auf der Seite genau ein Element finden; findet er keines oder mehrere, erscheint die Umfrage nicht.

So finden Sie den Selektor:

1. Öffnen Sie die Bestellabschlussseite einer Testbestellung in Ihrem Browser.
2. Klicken Sie mit der rechten Maustaste auf den Bereich, neben dem die Umfrage erscheinen soll, und wählen Sie „Untersuchen“.
3. Suchen Sie in den Entwicklerwerkzeugen ein Element mit einer id oder einer eindeutigen Klasse.
4. Tragen Sie es als CSS-Selektor ein und speichern Sie die Einstellungen.

So prüfen Sie den Selektor:

1. Geben Sie nach dem Speichern eine Testbestellung auf.
2. Öffnen Sie den Reiter „Umfrage“. Oben steht, was bei der letzten Bestellabschlussseite geschah: seit wann der Selektor sein Element findet und die Umfrage dort eingefügt wird, seit wann er keines oder mehrere Elemente findet (dann erscheint die Umfrage nicht), oder dass der Selektor nicht verwendet werden kann.
3. Erscheint ein Hinweis auf einen Fehler, ändern Sie den Selektor und prüfen ihn mit der nächsten Testbestellung.

Kaufquelle lädt sein Skript und sein Stylesheet nur auf der Bestellabschlussseite. Wie bei jedem aktiven Plugin mit eigenen Templates liest JTL-Shop selbst auf jeder Seite die Grunddaten des Plugins; Kaufquelle stellt auf anderen Seiten keine eigenen Datenbankabfragen.

Wo die Daten liegen und wie lange sie bleiben

Was gespeichert wird. Zu jeder Antwort: die gewählte Antwort und die Antwort der Folgefrage mit ihren Bezeichnungen zum Zeitpunkt der Antwort, die Texte, die der Käufer bei „Sonstiges“ oder in einer Folgefrage als Textfeld eingibt, die Zeitpunkte der Antworten, die Bestell-ID und die Bestellnummer, der Bruttobestellwert in der Standardwährung mit deren Code, die Bestellzeit, Kundengruppe und Sprache der Bestellung. Zu jeder Einblendung der Umfrage: dieselben Bestelldaten und ein Hash des Schlüssels, mit dem nur diese Umfrage beantwortet werden kann. Namen, E-Mail-Adressen und IP-Adressen fragt Kaufquelle nicht ab und speichert sie nicht; schreibt ein Käufer sie in ein Textfeld, steht der Text so in der Auswertung.

Wo. In der Datenbank Ihres Shops, in den Tabellen, deren Name mit xplugin_ab_kaufquelle_ beginnt; der Eintrag über eine Löschung im Logbuch des Shops („Fehlerbehebung > Logbuch“). Kaufquelle sendet keine Daten an den Anbieter des Plugins oder an Dritte, setzt keine Cookies und speichert nichts im Browser Ihrer Käufer.

Wie lange.

• Einblendungen ohne Antwort: 30 Tage.
• Antworten: Nach 24 Monaten entfernt die tägliche Bereinigung den Bestellbezug („Bestellbezug entfernt“): Bestellnummer, Bestell-ID und die Freitexte werden gelöscht, die Einblendung dazu ebenso; Bestellzeit und Antwortzeitpunkte werden auf den Tag der Bestellung gekürzt (ohne Uhrzeit). Es bleiben, damit sich die Summen der Auswertung nicht ändern: die gewählten Antworten mit ihren Bezeichnungen, der Bruttobestellwert mit dem Code der Währung, der Tag der Bestellung (er steht dann auch als Zeitpunkt der Antworten), Kundengruppe und Sprache.
• Wird eine Bestellung über JTL-Wawi gelöscht, löscht Kaufquelle die Antwort und die Einblendung dazu sofort; fehlt eine Bestellung auf andere Weise im Shop, bei der nächsten täglichen Bereinigung.
• Auf Wunsch eines Käufers löschen Sie seine Antwort im Reiter „Auswertung“ über die Bestellnummer (unten). Der Eintrag im Logbuch des Shops mit Bestellnummer und Name des Admins bleibt 90 Tage.
• Bei der Deinstallation löscht der Shop die Tabellen, wenn Sie das Feld „Alle plugineigenen Tabellen ebenfalls aus der Datenbank löschen“ angekreuzt lassen.

Eine Antwort auf Wunsch eines Käufers löschen

Verlangt ein Käufer die Löschung seiner Daten oder widerspricht er der Verarbeitung (Art. 17 und Art. 21 DSGVO), löschen Sie seine Antwort über die Bestellnummer:

1. Suchen Sie die Bestellnummer des Käufers heraus, zum Beispiel in JTL-Wawi.
2. Öffnen Sie in Kaufquelle den Reiter „Auswertung“.
3. Geben Sie die Bestellnummer unter „Antwort zu Bestellnummer löschen“ genau so ein, wie sie in der Bestellung steht (Groß- und Kleinschreibung zählen).
4. Bestätigen Sie die Rückfrage. Kaufquelle löscht die Antwort und die Einblendung zu dieser Bestellung und meldet „1 Antwort gelöscht“.

Gibt es zu der Nummer keine Antwort, meldet Kaufquelle „keine Antwort gefunden“ und löscht nichts. Jede Löschung wird mit der Bestellnummer und dem Namen des Admins im Logbuch Ihres Shops festgehalten („Fehlerbehebung > Logbuch“).

Text für Ihre Datenschutzerklärung

Nach Art. 13 DSGVO informieren Sie Ihre Käufer über Zweck, Rechtsgrundlage, berechtigtes Interesse, Speicherdauer und ihre Rechte. Diesen Absatz können Sie in Ihre Datenschutzerklärung übernehmen. Er beschreibt, was Kaufquelle speichert; ob er für Ihren Shop genügt, klären Sie bitte mit Ihrer Rechtsberatung.

Umfrage nach der Bestellung. Nach Abschluss Ihrer Bestellung können Sie freiwillig eine kurze Frage beantworten, z. B. wie Sie auf uns aufmerksam geworden sind. Wir speichern Ihre Antwort zusammen mit Bestellnummer, Bestellwert, Bestelldatum, Kundengruppe und Sprache in unserer Shop-Datenbank, um auszuwerten, welche Werbe- und Informationswege zu Bestellungen führen. Rechtsgrundlage ist Art. 6 Abs. 1 lit. f DSGVO; unser berechtigtes Interesse ist die Steuerung unserer Werbung. Die Daten werden nicht an Dritte übermittelt und es werden keine Cookies gesetzt. Der Bezug zu Ihrer Bestellung wird nach 24 Monaten entfernt oder früher, wenn die Bestellung gelöscht wird. Sie können der Verarbeitung jederzeit widersprechen und die Löschung Ihrer Antwort verlangen.

Die 24 Monate entsprechen der festen Aufbewahrung in dieser Version von Kaufquelle. Verlangt ein Käufer die Löschung, löschen Sie seine Antwort wie oben beschrieben über die Bestellnummer.

Wenn die Lizenz endet

Eine Testlizenz läuft 14 Tage; wenn sie endet, deaktiviert JTL-Shop das Plugin. Endet eine gekaufte Lizenz, erscheint die Umfrage nicht mehr, und die Reiter von Kaufquelle zeigen einen roten Hinweis. Die Auswertung, die CSV-Dateien und die Umfrage im Reiter „Umfrage“ bleiben erreichbar. Nach der Verlängerung und der nächsten Lizenzprüfung von JTL-Shop erscheint die Umfrage wieder.

Lassen Sie das Plugin aktiv, wenn die Lizenz endet. Wenn Sie es deaktivieren, während die Lizenz abgelaufen ist, führt die Plugin-Verwaltung es unter „Probleme“. So holen Sie es nach der Verlängerung zurück:

1. Klicken Sie im Reiter „Probleme“ auf „deaktivieren“.
2. Aktivieren Sie das Plugin danach im Reiter „Deaktiviert“ mit „Aktivieren“.

Deinstallieren Sie das Plugin nicht, um ein Lizenzproblem zu lösen. Im Dialog „Plugin-Deinstallation“ ist das Feld „Alle plugineigenen Tabellen ebenfalls aus der Datenbank löschen“ vorab angekreuzt: Mit dieser Voreinstellung werden alle Antworten gelöscht.

Support

Schreiben Sie an support@extensionfoundry.com. Wir antworten innerhalb von zwei Werktagen. Nennen Sie bitte die Version von JTL-Shop und von Kaufquelle (beide stehen in der Plugin-Verwaltung), was Sie getan haben und was Sie erwartet hätten. Schicken Sie uns keine Zugangsdaten und keine Daten Ihrer Kunden.

Eine Sicherheitslücke melden Sie bitte vertraulich an security@extensionfoundry.com; wie, steht auf der Seite Sicherheitslücken melden.