M0095 EAN-Support für Gambio
Handbuch
1. Was das Modul leistet
Die EAN – die international eindeutige Artikelnummer, heute meist GTIN genannt – steht in Ihrem Shop bereits in den Artikelstammdaten und bei jeder Variantenkombination. Sichtbar ist sie dort allerdings nur im Adminbereich. Ihre Kunden bekommen sie nie zu Gesicht, und auf den Belegen taucht sie ebenfalls nicht auf.
Genau diese Lücke schließt unser Modul. Es holt die bereits gepflegte EAN an die Stellen, an denen sie gebraucht wird:
- in der Kategorieliste, damit Suchende den Artikel schon in der Übersicht zweifelsfrei erkennen,
- auf der Artikeldetailseite – bei Variantenartikeln passend zur gewählten Kombination,
- im Warenkorb und auf der letzten Seite des Bestellvorgangs,
- auf dem Bestellausdruck, den der Kunde am Ende der Bestellung erzeugen kann,
- in der Bestellbestätigung per E-Mail.
Jeder dieser fünf Orte lässt sich einzeln ein- und ausschalten. Sie entscheiden also selbst, ob die EAN überall erscheint oder nur dort, wo sie Ihnen nützt.
Für wen sich das lohnt: Händler mit erklärungsbedürftigen oder leicht verwechselbaren Artikeln, Ersatzteil- und Zubehörhändler, Anbieter im B2B-Geschäft, bei denen der Einkäufer nach der GTIN sucht, und alle, die ihren Kunden das Nachbestellen oder den Preisvergleich erleichtern wollen. Ein angenehmer Nebeneffekt: Die EAN steht damit auch im Seitentext und kann von Suchmaschinen gefunden werden.
Voraussetzung: Das Modul zeigt nur an, was Sie gepflegt haben. Artikel ohne hinterlegte EAN erscheinen im Shop unverändert – es bleibt einfach eine Zeile weg. Sie müssen also nichts ausblenden, wenn Sie Ihre EAN nur teilweise pflegen.
2. Das Setup
2.1 Das Setup öffnen
Das Setup erreichen Sie über das Menü „Xycons-Module“ ► „Kundenkonto / Setups“ und dort über den TAB „EAN-Support Modul“.
Ganz oben steht der Modulstatus, darunter die Angaben zu Ihrer Lizenz, und darunter – durch Trennlinien in zwei Blöcke gegliedert – die eigentlichen Einstellungen: zuerst die Anzeige im Shop, danach die Anzeige auf den Belegen.
2.2 Die Einstellungen im Einzelnen
| Einstellung | Bedeutung |
|---|---|
| Status EAN-Support | Schaltet das gesamte Modul ein oder aus. Steht der Status auf „Ausgeschaltet“, verhält sich Ihr Shop exakt so wie ohne das Modul – unabhängig davon, was in den übrigen Zeilen eingestellt ist. (Standard: Ausgeschaltet) |
| Ihre Lizenz: | Reine Anzeige. Hier sehen Sie, welcher Lizenztyp für Ihren Shop erkannt wurde. |
| Kategorieliste | Blendet die EAN in der Listenansicht einer Kategorie unter dem Artikelnamen ein. (Standard: Ja, anzeigen) |
| Detailseite | Blendet die EAN auf der Artikeldetailseite im Kasten mit den Artikeldaten ein – dort, wo auch Artikelnummer und Lieferzeit stehen. (Standard: Ja, anzeigen) |
| Warenkorb | Blendet die EAN im Warenkorb und auf der abschließenden Bestellübersicht des Bestellvorgangs ein. (Standard: Ja, anzeigen) |
| Bestelldruck | Blendet die EAN auf dem Kontrollausdruck ein, den der Kunde am Ende der Bestellung aufrufen kann. (Standard: Ja, anzeigen) |
| Bestellbestätigung | Stellt die EAN für die Bestellbestätigung per E-Mail bereit. Damit sie dort auch erscheint, ist einmalig eine Zusatzzeile in der E-Mail-Vorlage nötig – siehe Kapitel 5.2. (Standard: Ja, anzeigen) |
Alle Änderungen wirken sofort nach dem Speichern. Sollte im Shop dennoch der alte Zustand zu sehen sein, leeren Sie bitte einmal den Cache Ihres Shops.
3. Wo die EAN gepflegt wird
Das Modul bringt keine eigenen Eingabefelder mit. Es nutzt die Felder, die Ihr Shop ohnehin schon hat. Wo diese liegen, hängt davon ab, ob der Artikel Varianten hat.
3.1 Artikel ohne Varianten
Öffnen Sie den Artikel in der Artikelpflege. Im Block „Artikelstammdaten“ finden Sie das Feld Barcode/EAN. Was Sie dort eintragen, zeigt das Modul im Shop an – die Länge und das Format sind dabei nicht vorgeschrieben, Sie können also auch achtstellige Kurznummern oder Ihre eigene Systematik verwenden.
3.2 Artikel mit Varianten
Hat ein Artikel Varianten – im Shop „Eigenschaften“ beziehungsweise „Artikelvarianten“ –, dann besitzt jede einzelne Kombination ihre eigene EAN. Sie finden die Spalte im Reiter „Varianten“ des Artikels. Genau diese variantengenaue Nummer ist der eigentliche Grund für dieses Modul: Ihr Kunde sieht nicht irgendeine Sammelnummer, sondern die Nummer der Zusammenstellung, die er gerade ausgewählt hat.
3.3 Artikel mit Zusatzoptionen
Bei Zusatzoptionen – früher „Attribute“ genannt – gibt es seit Shopversion 4.6 keine eigene EAN je Option mehr. Für solche Artikel zeigt das Modul deshalb die EAN aus den Artikelstammdaten an, und zwar unabhängig davon, welche Zusatzoption der Kunde wählt.
Varianten und Zusatzoptionen lassen sich bei einem Artikel zwar gleichzeitig verwenden, sinnvoll ist das aber nicht – auch Ihr Shophersteller rät davon ab. Entscheiden Sie sich je Artikel für eine der beiden Arten.
4. Die Anzeige im Shop
4.1 Kategorieliste
In der Listenansicht einer Kategorie erscheint die EAN unter dem Artikelnamen. Artikel ohne gepflegte EAN bleiben unverändert – es entsteht keine leere Zeile.
Eine Besonderheit betrifft Variantenartikel: In der Kategorieliste kann der Kunde noch keine Variante wählen, also gibt es auch noch keine eindeutige Nummer. Solche Artikel erscheinen hier bewusst ohne EAN. Die passende Nummer sieht der Kunde, sobald er den Artikel öffnet und seine Variante auswählt.
4.2 Artikeldetailseite
Auf der Artikeldetailseite steht die EAN im Kasten mit den Artikeldaten, direkt unter Artikelnummer und Lieferzeit.
Bei einem Variantenartikel bleibt die Zeile zunächst leer und füllt sich in dem Moment, in dem der Kunde seine Auswahl trifft – ohne dass die Seite neu geladen wird. Wechselt er die Auswahl, wechselt auch die angezeigte Nummer. Ruft der Kunde direkt eine bestimmte Zusammenstellung auf, etwa über einen Verweis aus einem Preisvergleich oder aus seinem Merkzettel, steht die richtige EAN bereits beim ersten Aufbau der Seite.
4.3 Warenkorb und Bestellabschluss
Im Warenkorb steht die EAN unter dem Artikelnamen – bei Variantenartikeln wieder die Nummer der tatsächlich gewählten Zusammenstellung. Dieselbe Angabe erscheint auf der letzten Seite des Bestellvorgangs, auf der der Kunde seine Bestellung vor dem Absenden noch einmal prüft. Beide Stellen werden von derselben Einstellung „Warenkorb“ gesteuert.
5. Die EAN auf den Belegen
5.1 Bestellausdruck
Am Ende einer Bestellung kann sich Ihr Kunde einen Kontrollausdruck erzeugen. Ist die Einstellung „Bestelldruck“ eingeschaltet, führt dieser Ausdruck zu jeder Position die EAN mit – bei Variantenartikeln die Nummer der bestellten Variante.
5.2 Bestellbestätigung einrichten
Die Bestellbestätigung ist der einzige Ort, an dem Sie einmalig selbst Hand anlegen müssen. Der Grund ist einfach: Ihre E-Mail-Vorlage ist Ihr eigenes Dokument, und wir bestimmen nicht, an welcher Stelle darin die EAN erscheinen soll.
Schalten Sie zunächst im Setup die Einstellung „Bestellbestätigung“ ein. Öffnen Sie danach im Adminbereich Ihre Vorlage für die Bestellbestätigung und wechseln Sie in die Quellcode-Ansicht. Suchen Sie dort nach CHECKOUT_INFORMATION – Sie landen mitten im Bereich, in dem die einzelnen Bestellpositionen ausgegeben werden. Fügen Sie unmittelbar davor diese Zeile ein:
{if $smarty.const.XYCONS_MOD0095_SHOW_CONFIRMATION == 'true' && $order_values.PRODUCTS_EAN} {$order_values.PRODUCTS_EAN} {/if}
Die Zeile muss innerhalb des Positionsbereichs stehen, also dort, wo die Bestellpositionen nacheinander aufgebaut werden – sonst erscheint die EAN nur einmal oder gar nicht.
Anschließend erzeugen Sie die Vorschau und speichern die Vorlage. Wiederholen Sie den Einschub danach in der Textfassung derselben Vorlage, sonst fehlt die EAN in den Nur-Text-Mails. Zum Schluss leeren Sie den Cache für die E-Mail-Vorlagen und danach den Seitencache.
Bitte beachten: Ändern Sie später die Vorlage grundlegend oder spielen Sie eine neue Vorlage ein, verschwindet die Zusatzzeile wieder. Prüfen Sie nach solchen Arbeiten, ob die EAN in einer Testbestellung noch in der Bestätigung steht.
6. Modultexte ändern
Modultexte können Sie – wie bei allen Modulen von uns – über die Shopfunktion „Texte ändern“ im Admin-Bereich an eigene Bedürfnisse anpassen.
Für dieses Modul betrifft das vor allem die Beschriftung vor der Nummer. Voreingestellt ist „EAN:“. Wenn Ihre Kundschaft eher mit „GTIN“, „Artikelcode“ oder einer fremdsprachigen Bezeichnung etwas anfangen kann, ändern Sie die Beschriftung dort – je Sprache getrennt. Auch die Beschriftungen und Erklärungen im Setup selbst lassen sich auf diesem Weg anpassen.
7. Shopupdate und Modulpflege
Prüfen Sie vor einem geplanten Service Pack oder Master-Update Ihres Shops auf unserer Seite, ob das Modul für die neue Shopversion freigegeben ist. Ein Modul passt sich einer neuen Shopversion nicht von selbst an.
Installieren Sie beim Shopupdate immer die neuesten Versionen des Moduls und der Modulumgebung – nicht nur den Shop. Wer allein den Shop aktualisiert, hat hinterher ein Modul, das nicht mehr zur Umgebung passt, und sucht die Ursache erfahrungsgemäß an der falschen Stelle.
Lassen Sie die Aktualisierung Ihres Shops durch uns durchführen, aktualisieren wir vorhandene Xycons-Module und die Modulumgebung immer mit, sofern sie für die Shop-Masterversion verfügbar sind.
8. Häufige Stolpersteine
Im Shop erscheint keine EAN
Drei Dinge müssen zusammenkommen: Der Modulstatus steht auf „Eingeschaltet“, die Einstellung für den jeweiligen Anzeigeort steht auf „Ja, anzeigen“, und der Artikel hat tatsächlich eine EAN hinterlegt. Ist alles davon erfüllt und die Anzeige bleibt aus, leeren Sie den Cache Ihres Shops.
Beim Variantenartikel bleibt die Zeile in der Kategorieliste leer
Das ist so gewollt. In der Liste kann noch keine Variante gewählt werden, also gibt es auch keine eindeutige Nummer. Sobald der Kunde den Artikel öffnet und seine Variante auswählt, erscheint die passende EAN.
Die EAN wechselt auf der Detailseite nicht mit der Auswahl
Der Wechsel geschieht im Browser des Kunden. Blockt eine Erweiterung im Browser oder ein sehr strenger Werbeblocker die Skripte Ihres Shops, bleibt die Nummer auf dem Stand des Seitenaufrufs. Prüfen Sie den Fall zur Sicherheit in einem zweiten Browser.
In der Bestellbestätigung fehlt die EAN
Dann fehlt die Zusatzzeile in der E-Mail-Vorlage oder sie steht außerhalb des Positionsbereichs. Gehen Sie Kapitel 5.2 noch einmal durch und denken Sie an die Textfassung der Vorlage sowie an das Leeren der Caches.
Bei Zusatzoptionen erscheint immer dieselbe Nummer
Das ist richtig so. Zusatzoptionen haben seit Shopversion 4.6 keine eigene EAN mehr; es gilt die EAN aus den Artikelstammdaten. Brauchen Sie eine Nummer je Ausprägung, stellen Sie den Artikel auf Varianten um.
Die EAN sieht im Shop anders aus als erwartet
Das Modul zeigt den Feldinhalt unverändert an und rechnet nichts um. Führende Nullen, Leerzeichen oder Bindestriche erscheinen genau so, wie sie im Artikel stehen. Wenn Sie es einheitlich haben wollen, pflegen Sie die Felder entsprechend.
Wir wünschen Ihnen viel Erfolg beim Einsatz dieses Moduls!
