Richtiges Eigenschaftsbild im Warenkorb für Gambio 3.12

Das Kompatibilitätsproblem ist leider erst sehr spät aufgefallen, weil es nur neu hochgeladene Bilder zu Eigenschaftenkombinationen betrifft. Wenn Sie unter Gambio 3.12 Artikel mit Eigenschaften anbieten, sollten Sie jetzt auf die neue Version 1.1 des Gambio-Moduls Artikeleigenschaften-Bilder im Checkout aktualisieren.

Kompatibilität mit Gambio 3.12

Tabelle mit 9 Eigenschaftenkombinationen jeweils mit Bild

Offen gestanden habe ich nicht geprüft, ab welcher Gambio-Version genau sich die Namensgebung für die Bilder zu Artikel-Eigenschaftenkombinationen geändert hat. Viel wichtiger ist doch, dass es eine rückwärtskompatible Lösung für die neueste Version gibt.

Allen Gambio-Shopbetreibern, die

  • Produkte mit Eigenschaften anbieten
  • entsprechende Bilder dazu einsetzen
  • durch Anzeige des falschen Bildes im Warenkorb verursachte Kaufabbrüche vermeiden, indem Sie mein Modul verwenden

empfehle ich die zeitnahe Aktualisierung des Moduls.

Symptom: Funktionslosigkeit bei neuen Bildern

Testartikel mit Standard-Artikelbild, obwohl Farbe Rot gewählt

Das einzige Symptom ist, dass bei bestimmten Kombinationen wieder das Standardbild im Warenkorb erscheint. Also ganz so, wie es Gambio selbst macht und als sei das Modul nicht installiert. Dies gilt dann auch für den Mini-Warenkorb sowie die Zusammenfassung der Bestellung vor dem Kauf.

Kennen Sie schon unseren Danke-Seite-Editor für Gambio GX3 & GX4? Statt Kunden mit Zeitschriften-Abos zu vergraulen oder sie mit Ihre Bestellung ist erfolgreich ausgeführt worden bzw. Sie wurden erfolgreich abgemeldet zu verabschieden, steigern Sie lieber ganz unkompliziert die Kundenbindung, indem Sie Danke- und Logout-Seite Ihres Gambio-Shops individuell gestalten!

Lösung: Update greift auch rückwirkend

Testartikel mit richtigem Bild, das heißt Farbe rot und Größe M

Die Lösung ist natürlich das Update. Ich möchte nur anmerken, dass dieses auch nachträglich alle bereits vor der Aktualisierung hochgeladenen Bilder zu Eigenschaftenkombinationen erfasst. Sie müssen also keinesfalls nach der Installation nochmals Artikel, geschweige denn die Eigenschaften bzw. deren Bilder überarbeiten.

Neues Handling für Produktbilder im PNG-Format

Ein weiteres und in allen Gambio-Versionen auftretendes Problem ist der Umgang des Moduls mit Bildern im PNG-Format. Nicht nur wegen des geringeren Aufwands bei der Entwicklung, auch wegen der Performance im Checkout, generiert das Modul ausschließlich Grafiken im JPEG-Format.

Das heißt nicht, dass es nicht mit anderen Bildformaten umgehen könnte. Das zutage getretene Problem ist das Handling des Alphakanals von PNGs. Bisher hat das Modul die Transparenz durch schwarz ersetzt, ab Version 1.1 ist es weiß. Aufgrund des in der Regel weißen Hintergrunds im Warenkorb kommt es optisch praktisch auf dasselbe hinaus, ob nun ein transparentes PNG auf weißem Hintergrund oder ein weiß aufgefülltes JPEG.

Entgegen meinem für Entwickler typischen Hang zum Gold Plating konnte ich mir gerade noch verkneifen, die seit einigen Wochen verfügbaren WebP-Bilder für Gambio auch in die Eigenschaftsbilder im Checkout zu integrieren. Angesichts so vieler offener To-Dos auch hinsichtlich anderer Gambio-Module und der ohnehin geringen Größe der Vorschaubilder stößt dies hoffentlich auf Verständnis.

Download & Installation

Ob Gambio-Ladezeit oder nun die Artikeleigenschaften-Bilder im Checkout: Download und Installation des Modul-Updates sind wie immer ganz einfach. Für den Download gibt es 3 Wege zum selben Ziel:

  1. Der Download-Link aus der Zahlungseingangsbestätigung ist weiterhin gültig. Nutzen Sie diesen, um die aktuelle Version als Zip-Paket herunterzuladen.
  2. Denselben Link finden Sie in Ihrem kostenlosen Werbe-Markt.de Kundenkonto.
  3. Seit 2020: Modulverwaltung
Verzeichnis GXModules/Werbe-Markt/EigenschaftenArtikelbild in FileZilla

Nachdem Sie das Zip-Paket auf egal welchem Weg heruntergeladen und entpackt haben, laden Sie den Inhalt der Ordnerstruktur entsprechend in das Verzeichnis /GXModules/Werbe-Markt/EigenschaftenArtikelbild Ihrer Gambio-Installation. Das Leeren von Caches etc. ist nicht erforderlich.

So einfach die Inbetriebnahme des Plugins auch ist, nutzen Sie gerne unseren kostenlosen Installationsservice für Gambio-Module.

Bonus: Hauptbild aktualisieren nach Eigenschaften-Auswahl

Testartikel mit gewählten Eigenschaften Größe S, Farbe Gold, links daneben das zur Kombination passende Bild

Dieses Feature hat mit dem Modul nichts zu tun außer, dass es dieselbe Zielgruppe hat. Gambio zeigt ein verfügbares Eigenschaftsbild nach Auswahl der Eigenschaften (oftmals Größe und Farbe) darunter an. Das Hauptbild, also das links im Hauptbereich der Artikelseite groß dargestellte Artikelbild, bleibt unabhängig von der gewählten Kombination das Standardbild des Artikels.

Wenn Sie möchten, dass dieses ebenfalls den vom Nutzer gewählten Eigenschaften entsprechend aktualisiert wird, können Sie nachfolgende Datei kostenlos herunterladen:

Anschließend gehen Sie wie folgt vor:

  1. Fertigen Sie eine Sicherungskopie dieser Datei an:
    /templates/Honeygrid/assets/javascript/engine/widgets/cart_handler.min.js
  2. Laden Sie die heruntergeladene cart_handler.min.js an Stelle Original-Datei in das Verzeichnis /templates/Honeygrid/assets/javascript/engine/widgets/ Ihrer Gambio-Installation.
  3. Rufen Sie eine Artikelseite Ihres Onlineshops auf und drücken Sie Strg + F5 (Linux + Windows). Im Zweifelsfalls rufen Sie die JavaScript-Datei direkt im Browser auf unter ihrshop.de/templates/Honeygrid/assets/javascript/engine/widgets/cart_handler.min.js und nutzen die Aktualisieren-Funktion Ihres Webbrowsers, um sicherzustellen, dass dieser nicht mehr die alte Datei aus dem Cache lädt.

Im Gegensatz zum Modul ist der Wechsel des Hauptbildes nach gewählter Eigenschaftenkombination nicht Update-sicher. Beim nächsten Gambio-Update ist also eine erneute Anpassung der Datei erforderlich, um die Funktion wiederherzustellen.

Die zum Download bereitgestellte „Bonus-Datei“ ist ausschließlich für den Einsatz in Gambio 3.12.x vorgesehen. Ähnliches funktioniert aber auch in früheren Gambio-Versionen. Bei Bedarf stehe ich Ihnen gerne für entsprechende Anfragen zur Verfügung.

Hauptbildwechsel in Gambio 3.14.1.1 & 3.15.2

Nachfolgend finden Sie eine für Gambio 3.15.2 angepasste cart_handler.min.js, die den Hauptbildwechsel im Artikel bewirkt. Je nachdem, ob Sie ein Theme oder Template verwenden, handelt es sich um die

/themes/Honeygrid/javascripts/system/widgets/cart_handler.min.js

die nach Leeren des entsprechenden Caches hierüber aufgerufen wird:

/public/theme/javascripts/system/widgets/cart_handler.min.js

bzw. beim Templates Honeygrid um diese Datei:

/templates/Honeygrid/assets/javascript/engine/widgets/cart_handler.min.js

Für 3.14.1.1 verwenden Sie diese Datei:

»«

Schreiben Sie einen Kommentar