M0119 Alles BIO! für Gambio
Handbuch
1. Was das Modul leistet
Wer Bio-Ware verkauft, muss seine Kunden darüber informieren – im Shop, auf der Bestellbestätigung und auf den Belegen. Von Hand gepflegte Hinweise im Artikeltext sind dafür unpraktisch: Sie müssen bei jedem Artikel einzeln gesetzt, bei jeder Textkorrektur nachgezogen werden und fehlen auf Rechnung und Lieferschein ganz.
Das Modul nimmt Ihnen diese Arbeit ab. Sie setzen bei einem Artikel ein Häkchen – das Bio-Kennzeichen. Von da an kennzeichnet der Shop diesen Artikel überall automatisch und einheitlich:
- auf der Artikeldetailseite mit Beschriftung, Siegel und Herkunftsangabe,
- in Artikellisten und Kategorieübersichten mit dem Siegel an der Abbildung,
- im Warenkorb und beim Bestellabschluss,
- auf der Bestellbestätigung und in der Bestellbestätigungs-E-Mail,
- auf Rechnung und Lieferschein – dort zusätzlich mit Ihrer Bio-Zertifizierungsnummer.
Dabei bestimmen Sie selbst, welcher Text als Marker erscheint, welches Siegel gezeigt wird, wie groß es ist, ob eine Herkunftsangabe mitläuft und auf welchen Belegen gekennzeichnet wird. Jeder dieser Punkte lässt sich einzeln ein- und ausschalten.
Für Sortimente mit vielen Bio-Artikeln gibt es die Serienbearbeitung: In der Schnellpflege Ihres Shops erscheinen drei zusätzliche Spalten, mit denen Sie Bio-Kennzeichen, Öko-Kontrollstellennummer und Herkunft für beliebig viele Artikel in einem Zug setzen – und nach ihnen filtern.
2. Installation und erster Aufruf
Die Installation erfolgt wie bei allen unseren Modulen über die beigefügte Installationsanleitung. Nach dem Einspielen erreichen Sie das Setup über das Menü „Xycons-Module“ ► „Kundenkonto / Setups“ und dort über den TAB „Alles BIO!“.
Beim ersten Aufruf meldet die Seite unter Umständen, dass das Modul noch nicht initialisiert ist. Klicken Sie dann einmal auf „Initialisierung durchführen“ – danach stehen alle Einstellungen bereit.
Tragen Sie zuerst Ihren Lizenzschlüssel ein und speichern Sie. Erst danach zeigt die Seite Ihre Lizenzart an und das Modul arbeitet im vollen Umfang.
3. Das Setup
Das Setup ist in fünf Blöcke gegliedert: Modul und Lizenz, Ihr Bio-Zertifikat, die Kennzeichnung im Shop, die Herkunftsangabe und die Kennzeichnung auf Belegen. Die folgende Abbildung zeigt die vollständige Seite, die Einzelheiten stehen in den Unterabschnitten.
3.1 Modulstatus, Lizenz und Zertifikat
| Einstellung | Bedeutung |
|---|---|
| Modulstatus | Schaltet das Modul insgesamt ein oder aus. Ist es ausgeschaltet, verschwindet jede Kennzeichnung aus Shop, Bestellbestätigung und Belegen – die bei den Artikeln gesetzten Angaben bleiben aber erhalten. (Standard: ausgeschaltet) |
| Ihre Version | Die installierte Modulversion. Bitte bei Rückfragen an unseren Support mit angeben. |
| Lizenzstufe / Ihr Lizenzschlüssel / Ihre Lizenz | Ihre Lizenzdaten. Den Schlüssel erhalten Sie beim Kauf; die Zeile darunter zeigt, welche Lizenz daraus erkannt wurde. |
| Ihre Bio-Zertifikatsnummer | Die Nummer, die auf Rechnungen und Lieferscheinen gedruckt wird – in aller Regel die Codenummer Ihrer Öko-Kontrollstelle. Diese Angabe gilt für den ganzen Shop. Bleibt das Feld leer, unterbleibt der Andruck. (Standard: leer) |
| Link zum Bio-Zertifikat | Die vollständige Adresse der Seite, auf der Ihr Zertifikat einsehbar ist. Ist sie hinterlegt und die Verlinkung eingeschaltet, führt ein Klick auf das Siegel im Shop dorthin. Die Adresse muss mit http:// oder https:// beginnen – andere Angaben werden bewusst ignoriert. (Standard: leer) |
Die hier eingetragene Nummer ist die Regel für den ganzen Shop. Beziehen Sie einzelne Artikel über eine andere Zertifizierung, hinterlegen Sie deren Nummer direkt am Artikel (Abschnitt 4.1) – sie ersticht dann für diesen Artikel die Shopnummer. Auf einem Beleg erscheinen alle Nummern, die zu den bestellten Bio-Artikeln gehören.
3.2 Kennzeichnung im Shop
| Einstellung | Bedeutung |
|---|---|
| Marker für Bio-Produkte | Der Text, der als Kennzeichnung erscheint, etwa „BIO“ oder „Bio-Qualität“. Lassen Sie das Feld leer, verwendet der Shop den Text aus der Sprachverwaltung – dann lässt sich der Marker je Sprache unterschiedlich formulieren (siehe Kapitel 9). (Standard: BIO!) |
| Marker mit Bio-Logo anzeigen | Zeigt zusätzlich zum Markertext ein Siegel. Schalten Sie es ab, erscheint nur der Text. (Standard: Ja) |
3.3 Welches Siegel angezeigt wird
| Einstellung | Bedeutung |
|---|---|
| Welches Siegel anzeigen? | Zur Wahl stehen das mitgelieferte Bio-Siegel, das EU-Bio-Logo, beide nebeneinander oder ein eigenes Siegel. Was es mit dem EU-Bio-Logo und dem eigenen Siegel auf sich hat, steht in Kapitel 7. (Standard: Mitgeliefertes Bio-Siegel) |
| Dateiname Ihres eigenen Siegels | Nur nötig, wenn oben „Eigenes Siegel“ gewählt ist. (Standard: leer) |
| Logo-Größe | Die Breite des Siegels in Pixeln, nur die Zahl ohne „px“. Zulässig sind Werte zwischen 8 und 600. (Standard: 45) |
| Logo verlinken | Verknüpft das Siegel mit der hinterlegten Zertifikatsadresse. Der Verweis öffnet sich in einem neuen Fenster. (Standard: Ja, verlinken) |
Kann eine gewählte Bilddatei nicht gefunden werden, zeigt der Shop das mitgelieferte Bio-Siegel. Ein kaputtes Bild erscheint also nie.
3.4 Herkunftsangabe
Bei Bio-Ware gehört zur Kennzeichnung häufig die Angabe, woher die landwirtschaftlichen Ausgangsstoffe stammen. Das Modul führt diese Angabe als eigenes Feld und zeigt sie neben dem Marker an.
| Einstellung | Bedeutung |
|---|---|
| Herkunftsangabe (Vorgabe) | Gilt für alle Bio-Artikel, an denen nichts Eigenes hinterlegt ist. Zur Wahl stehen „Keine Angabe“, „EU-Landwirtschaft“, „Nicht-EU-Landwirtschaft“ und „EU-/Nicht-EU-Landwirtschaft“. (Standard: Keine Angabe) |
| Herkunft im Shop anzeigen | Blendet die Angabe auf der Artikelseite ein oder aus. (Standard: Ja) |
| Herkunft auf Belegen anzeigen | Dasselbe für Bestellbestätigung, Rechnung und Lieferschein. (Standard: Ja) |
Führen Sie ein einheitliches Sortiment, stellen Sie die Vorgabe einmal ein und sind fertig. Gemischte Sortimente pflegen die Abweichungen am Artikel – einzeln oder in Serie.
3.5 Kennzeichnung auf Belegen
Diese Schalter arbeiten unabhängig voneinander. Sie können den Marker also zum Beispiel auf dem Lieferschein führen, auf der Rechnung aber weglassen.
| Einstellung | Bedeutung |
|---|---|
| Produktmarker Bestellbestätigung | Markiert Bio-Artikel auf der Bestellbestätigung und in der Bestellbestätigungs-E-Mail. (Standard: Ja) |
| Produktmarker Rechnungen | Markiert Bio-Artikel in den Artikelzeilen der Rechnung. (Standard: Ja) |
| Produktmarker Lieferscheine | Dasselbe für den Lieferschein. (Standard: Ja) |
| Zertifikatsnummer auf Rechnungen | Druckt die Zertifizierungsnummern unten im Hinweisblock der Rechnung – aber nur, wenn die Bestellung mindestens einen Bio-Artikel enthält. (Standard: Ja) |
| Zertifikatsnummer auf Lieferscheinen | Dasselbe für den Lieferschein. (Standard: Ja) |
| Abstand auf Rechnung/Lieferschein | Fügt vor der Zertifizierungsnummer eine Leerzeile ein, damit sie sich optisch vom übrigen Hinweisblock abhebt. (Standard: Nein) |
4. Artikel kennzeichnen
4.1 Ein einzelner Artikel
Ist das Modul eingeschaltet, erweitert es die Artikelmaske um den Kasten „Bio-Kennzeichen“. Sie finden ihn im Reiter „Allgemein“ unterhalb der Zusatzfelder.
| Feld | Bedeutung |
|---|---|
| Bio-Kennzeichen | Das Häkchen entscheidet, ob der Artikel überall als Bio-Artikel erscheint. |
| Öko-Kontrollstellennummer | Nur ausfüllen, wenn für diesen Artikel eine andere Nummer gilt als die im Setup hinterlegte. Bleibt das Feld leer, verwendet der Shop automatisch die Shopnummer. |
| Herkunft | Weicht die Herkunft dieses Artikels von Ihrer Vorgabe ab, stellen Sie sie hier um. „Keine Angabe“ bedeutet: es gilt die Vorgabe aus dem Setup. |
Speichern Sie den Artikel – mehr ist nicht zu tun. Nehmen Sie das Häkchen wieder heraus, verschwindet die Kennzeichnung beim nächsten Speichern überall.
4.2 Viele Artikel auf einmal
Für größere Sortimente wäre der Weg über die Artikelmaske mühsam. Deshalb bringt das Modul drei Spalten in die Schnellpflege Ihres Shops (Menü „Artikel“ ► „QuickEdit“): Bio, Öko-Kontrollstelle und Bio-Herkunft.
Die Spalten müssen Sie einmal einblenden. Klicken Sie in der Schnellpflege oben rechts auf das Zahnrad und setzen Sie dort die Häkchen bei den drei Bio-Spalten. Das ist eine persönliche Einstellung – jeder Mitarbeiter entscheidet für sich, welche Spalten er sehen möchte.
Danach haben Sie drei Arbeitsweisen:
- Einzeln umstellen: Die Auswahlfelder in den Zeilen „Bio“ und „Bio-Herkunft“ wirken sofort – umstellen genügt, gespeichert wird automatisch.
- In Serie setzen: Haken Sie links die gewünschten Artikel an, schalten Sie oben von „Filtern“ auf „Bearbeiten“ um, tragen Sie in der Bearbeitungszeile die gewünschten Werte ein und speichern Sie. Felder, die Sie leer lassen, bleiben unverändert.
- Filtern: In der Filterzeile suchen Sie gezielt nach Bio-Artikeln, nach einer Kontrollstellennummer oder nach einer Herkunftsangabe. So sehen Sie auf einen Blick, wo noch etwas fehlt – etwa alle Bio-Artikel ohne Herkunftsangabe.
Ein praktischer Ablauf für ein neues Sortiment: erst nach „Bio = Ja“ filtern, dann alle Treffer auswählen und in einem Zug die Herkunft setzen.
5. So erscheint die Kennzeichnung im Shop
5.1 Artikeldetailseite
Auf der Artikeldetailseite erscheint das Bio-Kennzeichen in dem Block, in dem auch Lieferzeit und Lagerbestand stehen – also genau dort, wo Ihre Kunden die Eckdaten des Artikels suchen. Ist eine Herkunft hinterlegt, steht sie direkt daneben.
5.2 Artikellisten und Kategorien
In Kategorien, Suchergebnissen und allen weiteren Artikellisten setzt das Modul das Siegel an die Artikelabbildung – sowohl in der Kachel- als auch in der Listenansicht. Artikel ohne Bio-Kennzeichen bleiben unverändert.
5.3 Warenkorb und Bestellabschluss
Im Warenkorb und auf der Bestellübersicht vor dem Kauf erscheint die Kennzeichnung neben dem Artikelnamen. Ihre Kunden sehen damit bis zuletzt, welche Positionen Bio-Ware sind.
6. Kennzeichnung auf Belegen und in E-Mails
Auf Rechnung und Lieferschein hängt der Marker als eigene Zeile unter der Artikelbezeichnung, zusammen mit den übrigen Angaben zur Position – bei gepflegter Herkunft ergänzt um die Herkunftsangabe in Klammern. Enthält die Bestellung mindestens einen Bio-Artikel, erscheinen zusätzlich die zugehörigen Zertifizierungsnummern im Hinweisblock am Fuß des Belegs.
Sind an mehreren Artikeln einer Bestellung unterschiedliche Kontrollstellennummern hinterlegt, werden alle aufgeführt. Die Bestellbestätigungs-E-Mail erhält dieselbe Kennzeichnung; damit das Siegel dort auch beim Empfänger ankommt, wird es mit der vollständigen Shopadresse eingebunden.
Belege werden in dem Moment erzeugt, in dem Sie sie erstellen – nicht rückwirkend. Ändern Sie eine Einstellung, wirkt sie auf alle danach erzeugten Belege. Bereits gespeicherte PDF-Dateien bleiben, wie sie sind.
7. Eigenes Siegel und EU-Bio-Logo
Dem Modul liegt das bekannte sechseckige Bio-Siegel bei. Zwei weitere Wege stehen Ihnen offen.
Ihr eigenes Siegel
Möchten Sie ein eigenes Zeichen zeigen – etwa das Ihres Anbauverbands –, legen Sie die Bilddatei in das Verzeichnis GXModules/Xycons/M0119/Shop/images/ und tragen im Setup nur den Dateinamen ein. Wählen Sie dann bei „Welches Siegel anzeigen?“ den Eintrag „Eigenes Siegel“.
Dieses Verzeichnis gehört Ihnen: Ein Modulupdate überschreibt es nicht. Ihre Datei bleibt also auch nach einer Aktualisierung erhalten.
Das EU-Bio-Logo
Das EU-Bio-Logo – das grüne Blatt aus Sternen – liefern wir bewusst nicht mit. Es ist ein amtliches Zeichen, das unverändert aus der Originalquelle stammen muss; eine nachgezeichnete Fassung wäre nicht zulässig. Laden Sie die Datei bei der Europäischen Kommission herunter und legen Sie sie unter dem Namen eu_bio_logo.png im Verzeichnis GXModules/Xycons/M0119/Shop/images/defaults/ ab. Danach können Sie sie im Setup auswählen – allein oder zusammen mit dem Bio-Siegel.
Prüfen Sie vor dem Einsatz, welches Siegel Sie führen dürfen. Das staatliche Bio-Siegel und das EU-Bio-Logo sind gesetzlich geschützt; ihre Verwendung ist an Bedingungen geknüpft. Wenn Sie unsicher sind, schalten Sie die Anzeige ab und arbeiten Sie nur mit dem Markertext – oder lassen Sie sich von Ihrer Öko-Kontrollstelle bestätigen, welche Kennzeichnung für Sie zulässig ist.
8. Rechtliche Einordnung
Das Modul ist ein Anzeigewerkzeug: Es stellt die Angaben dar, die Sie hinterlegen, und markiert die Artikel, die Sie gekennzeichnet haben. Es prüft weder, ob ein Artikel tatsächlich Bio-Ware ist, noch ob Ihre Zertifizierung gültig ist, noch ob die gewählte Herkunftsangabe zutrifft.
Welche Angaben Sie bei Bio-Ware machen müssen – Codenummer der Öko-Kontrollstelle, Herkunftsangabe, Platzierung im selben Sichtfeld –, richtet sich nach den geltenden Vorschriften und nach der Art Ihres Sortiments. Die Verantwortung für Richtigkeit und Vollständigkeit liegt bei Ihnen. Im Zweifel fragen Sie Ihre Öko-Kontrollstelle oder Ihren Rechtsbeistand.
9. 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. Das betrifft zum Beispiel die Beschriftung „Bio-Kennzeichen“ auf der Artikelseite, die Zeile „Bio-Zertifizierungsnummer:“ auf den Belegen, die drei Herkunftsbezeichnungen und den alternativen Bildtext des Siegels.
Auch der Markertext selbst lässt sich dort pflegen: Lassen Sie das Feld „Marker für Bio-Produkte“ im Setup leer, nimmt der Shop den Text aus der Sprachverwaltung – und der kann für jede Shopsprache eigens formuliert werden. Steht im Setup dagegen ein Text, gilt dieser für alle Sprachen.
10. Aussehen anpassen
Für Position und Aussehen der Kennzeichnung bringt das Modul eigene Gestaltungsregeln mit, die auf die verschiedenen Bildschirmgrößen abgestimmt sind.
Nehmen Sie Änderungen bitte nicht in den mitgelieferten Dateien vor, sondern über „Eigenes CSS hinzufügen“ in Ihrem Theme. Die mitgelieferten Dateien werden bei einem Modulupdate überschrieben – Ihre Änderungen wären dann verloren.
11. Shopupdate und Modulpflege
Planen Sie ein Servicepack oder ein Masterupdate Ihres Shops, prüfen Sie bitte vorher auf unserer Seite, ob das Modul für die neue Shopversion freigegeben ist.
Installieren Sie beim Shopupdate immer beides: die aktuelle Version des Moduls und die aktuelle Version der Modulumgebung. Ein Modul passt sich nicht von allein an eine neue Shopversion an – wer nur den Shop aktualisiert, sucht anschließend an der falschen Stelle nach der Ursache. Lassen Sie die Aktualisierung von uns durchführen, ziehen wir Module und Modulumgebung automatisch mit.
Nach einem Update ist es sinnvoll, einmal den Cache Ihres Shops zu leeren und die Setupseite des Moduls aufzurufen – damit sind alle neuen Einstellungen sofort verfügbar.
12. Häufige Stolpersteine
| Beobachtung | Ursache und Abhilfe |
|---|---|
| Im Shop ist gar keine Kennzeichnung zu sehen. | Prüfen Sie der Reihe nach: Ist der Modulstatus eingeschaltet? Ist bei dem Artikel das Bio-Kennzeichen gesetzt und gespeichert? Wurde der Shopcache nach dem Einschalten geleert? |
| In der Schnellpflege fehlen die Bio-Spalten. | Sie sind noch nicht eingeblendet. Zahnrad oben rechts anklicken und die drei Spalten auswählen (Abschnitt 4.2). |
| In der Schnellpflege lässt sich nach Bio nicht sortieren. | Das ist Absicht: Die Bio-Angaben liegen nicht in der Artikeltabelle. Zum Eingrenzen nutzen Sie die Filterzeile – sie arbeitet für alle drei Spalten. |
| Das Siegel fehlt, der Markertext erscheint aber. | „Marker mit Bio-Logo anzeigen“ steht auf Nein. |
| Statt des gewählten Siegels erscheint das mitgelieferte. | Die gewählte Bilddatei wurde nicht gefunden. Prüfen Sie Verzeichnis und Dateinamen (Kapitel 7); Groß- und Kleinschreibung zählt. |
| Das Siegel ist nicht anklickbar. | Entweder ist „Logo verlinken“ abgeschaltet, oder im Feld „Link zum Bio-Zertifikat“ steht keine vollständige Adresse mit http:// oder https://. |
| Auf der Rechnung fehlt die Zertifizierungsnummer. | Entweder ist weder im Setup noch am Artikel eine Nummer hinterlegt, oder der Schalter „Zertifikatsnummer auf Rechnungen“ steht auf Nein, oder die Bestellung enthält gar keinen Bio-Artikel. |
| Am Artikel steht eine Nummer, gedruckt wird die aus dem Setup. | Die Angabe am Artikel wurde nicht gespeichert. Öffnen Sie den Artikel erneut und prüfen Sie das Feld – oder setzen Sie die Nummer über die Schnellpflege. |
| Die Herkunft erscheint nicht. | Entweder steht Vorgabe und Artikelangabe auf „Keine Angabe“, oder die Anzeige ist für Shop bzw. Belege abgeschaltet (Abschnitt 3.4). |
| Der Marker steht auf dem Lieferschein, aber nicht auf der Rechnung. | Das ist kein Fehler: Beleg und Lieferschein haben getrennte Schalter (Abschnitt 3.5). |
| Eine alte Rechnung zeigt die Kennzeichnung nicht. | Belege werden beim Erstellen festgeschrieben. Erzeugen Sie den Beleg neu, wenn er die neue Kennzeichnung tragen soll. |
| Das Siegel ist viel zu groß oder zu klein. | Stellen Sie die Logo-Größe im Setup ein. Der Wert ist eine Breite in Pixeln, üblich sind 30 bis 60. |
