PDF herunterladen

Inhaltsverzeichnis

M0067 Produktempfehlung für Gambio

Handbuch

Stand: 2026-09 (Modulversion 2.07) · (c) Xycons GmbH & Co. KG - www.xycons.de

1. Was das Modul leistet

Das Modul ergänzt jede Artikeldetailseite Ihres Shops um eine Empfehlungsfunktion. Neben den Schaltflächen „Auf den Merkzettel“ und „In den Warenkorb“ erscheint ein zusätzlicher Knopf – in der Grundeinstellung mit der Beschriftung „Produkt empfehlen“.

Klickt ein Besucher darauf, öffnet sich sein eigenes Mailprogramm mit einer fertig vorbereiteten Nachricht: Betreffzeile, Artikelname, Kurzbeschreibung und der Link zum Artikel sind bereits eingetragen. Der Besucher muss nur noch die Empfängeradresse ergänzen, eventuell ein persönliches Wort dazuschreiben und auf „Senden“ klicken.

Wie die Nachricht aussieht, bestimmen Sie selbst: Text und Aufbau liegen als Vorlage im Inhaltsverwalter Ihres Shops und lassen sich dort jederzeit ändern (siehe Kapitel 6).

Das Modul verschickt selbst keine Mail und speichert keine Empfängeradressen. Es bereitet nur den Text vor und übergibt ihn an das Mailprogramm des Besuchers. Warum das so gelöst ist, lesen Sie im nächsten Kapitel.

2. Warum die Empfehlung aus dem Mailprogramm des Besuchers kommt

Klassische „Empfehlen Sie diesen Artikel weiter“-Funktionen versenden die Mail über den Shop – also im Namen des Shopbetreibers an einen Dritten, der dem Shop nie eine Einwilligung erteilt hat. Genau das ist in den vergangenen Jahren zu einem rechtlichen Risiko geworden und hat wiederholt zu Abmahnungen geführt.

Unser Modul geht diesen Weg bewusst nicht. Die Empfehlung entsteht im Postfach des Besuchers und wird von dort aus versendet:

  • Absender ist der Besucher, nicht Ihr Shop.
  • Ihr Shop erfährt die Adresse des Empfängers nicht und speichert sie folglich auch nicht.
  • Der Empfänger bekommt eine persönliche Nachricht von einem Bekannten – die wirkt erfahrungsgemäß deutlich besser als eine automatisierte Shopmail.
  • Es entstehen keine Zustellprobleme durch Spamfilter, weil die Mail vom gewohnten Absender des Empfängers kommt.

Der einzige Preis dieser Lösung: Auf dem Gerät des Besuchers muss ein Mailprogramm eingerichtet sein. Auf Smartphones und Tablets ist das praktisch immer der Fall; an Arbeitsplatzrechnern, an denen ausschließlich ein Webmail-Zugang im Browser genutzt wird, kann es vorkommen, dass sich kein Mailfenster öffnet.

3. In drei Schritten einsatzbereit

Nach der Installation genügen drei Handgriffe:

  • Erstens: Setup öffnen – Menü „Xycons-Module“ ► „Kundenkonto / Setups“, dort den Reiter „Produktempfehlung“.
  • Zweitens: Den Modulstatus einschalten und den Plattformnamen eintragen (Kapitel 4).
  • Drittens: Speichern, danach den Seiten-Cache Ihres Shops leeren und eine Artikelseite aufrufen – der Knopf ist da.

Die mitgelieferte Mailvorlage ist bereits eingerichtet und sofort brauchbar. Sie müssen sie nur anfassen, wenn Sie den Wortlaut ändern möchten.

4. Das Setup

Das Setup erreichen Sie über das Menü „Xycons-Module“ ► „Kundenkonto / Setups“ und dort über den Reiter „Produktempfehlung“. Alle Einstellungen des Moduls liegen auf dieser einen Seite; zu jedem Feld steht der erklärende Hinweis direkt darunter.

Das Setup der Produktempfehlung im Bereich „Kundenkonto / Setups“
Abbildung 1: Das Setup der Produktempfehlung im Bereich „Kundenkonto / Setups“
Einstellung Bedeutung Vorbelegung
Modulstatus Schaltet die Empfehlungsfunktion im Shop ein oder aus. ausgeschaltet
Plattformname Der Name, der in der Betreffzeile und im Mailtext für Ihren Shop steht. Ihre Shopadresse
Text-Symbol Das Symbol links neben der Beschriftung des Knopfes. Briefumschlag
Mail-Template Nummer der Inhaltsseite, in der die Mailvorlage steht. 67001
Nutzungen Zählt, wie oft die Empfehlung bisher benutzt wurde. 0

4.1 Modulstatus

Der Hauptschalter. Steht er auf „Aus“, verhält sich Ihr Shop, als wäre das Modul nicht vorhanden – der Knopf verschwindet von den Artikelseiten, es bleiben keine Reste stehen. Zum Ausprobieren können Sie ihn jederzeit ein- und wieder ausschalten.

4.2 Plattformname

Dieser Eintrag wird in die Betreffzeile und – je nach Vorlage – auch in den Mailtext eingesetzt. Der Satz lautet zum Beispiel:

Ich möchte dieses Produkt auf kaffee-kontor.de empfehlen

Der Teil „kaffee-kontor.de“ stammt aus diesem Feld. Sinnvoll ist in der Regel nicht die technische Webadresse, sondern der Name, unter dem Ihre Kunden Sie kennen – also etwa „Kaffee-Kontor“ statt „www.kaffee-kontor.de“. Bei der Installation trägt das Modul zunächst Ihre Shopadresse ein; ändern Sie den Wert einfach auf Ihren Shopnamen.

4.3 Text-Symbol

Links neben der Beschriftung des Knopfes steht ein kleines Symbol. Lassen Sie das Feld leer, wird ein Briefumschlag angezeigt – passend zu allen anderen Schaltflächen daneben.

Möchten Sie ein anderes Symbol, tragen Sie hier die vollständige Angabe dafür ein, zum Beispiel für einen gefüllten Briefumschlag:

<i class="fa fa-envelope" aria-hidden="true"></i>

Welche Symbole zur Verfügung stehen und wie die jeweilige Angabe lautet, finden Sie unter fontawesome.com/v4.7.0/icons.

4.4 Mail-Template

Hier steht die Nummer der Inhaltsseite, in der Ihre Mailvorlage liegt. Bei der Installation legt das Modul diese Seite unter der Nummer 67001 an und trägt sie hier ein – in aller Regel ändern Sie an diesem Feld nichts.

Sie brauchen es nur, wenn Sie die Vorlage an anderer Stelle pflegen möchten: Legen Sie dann im Inhaltsverwalter eine eigene Inhaltsseite an und tragen Sie deren Nummer hier ein.

Findet das Modul unter der angegebenen Nummer keine Inhaltsseite, greift es auf die mitgelieferte Standardvorlage zurück. Die Empfehlung funktioniert also auch dann weiter, wenn die Inhaltsseite einmal versehentlich gelöscht wird.

4.5 Nutzungen

Ein einfacher Zähler: Er erhöht sich um eins, sobald ein Besucher die Empfehlung benutzt. So sehen Sie auf einen Blick, ob die Funktion angenommen wird. Das Feld lässt sich nicht von Hand verändern.

5. So sieht es im Shop aus

Auf der Artikeldetailseite erscheint der Knopf im Block unterhalb von „In den Warenkorb“, zusammen mit „Auf den Merkzettel“ und den übrigen Schaltflächen Ihres Themes. Er übernimmt die Gestaltung Ihres Shops und fügt sich damit ohne weiteres Zutun ins Bild ein.

Artikeldetailseite mit der Schaltfläche „Produkt empfehlen“
Abbildung 2: Artikeldetailseite mit der Schaltfläche „Produkt empfehlen“
Der Knopf fügt sich in die übrigen Schaltflächen des Themes ein
Abbildung 3: Der Knopf fügt sich in die übrigen Schaltflächen des Themes ein

Nach dem Klick öffnet sich das Mailprogramm des Besuchers mit einer vorbereiteten Nachricht. Mit der mitgelieferten Vorlage sieht sie so aus:

Betreff: Ich möchte dieses Produkt auf kaffee-kontor.de empfehlen

Ich möchte folgendes Produkt auf kaffee-kontor.de empfehlen:

Siebträger-Espressomaschine Bella Roma
Zweikreis-Siebträger mit 15 bar Pumpe, Milchaufschäumdüse und
Gehäuse aus gebürstetem Edelstahl.

Mehr erfahren: https://kaffee-kontor.de/info/p2_siebtraeger-espressomaschine-bella-roma.html

Der Link führt auf die Artikelseite und berücksichtigt die suchmaschinenfreundlichen Adressen Ihres Shops, sofern Sie diese verwenden.

6. Die Mailvorlage anpassen

Wortlaut und Aufbau der vorbereiteten Nachricht bestimmen Sie selbst. Die Vorlage liegt als Inhaltsseite in Ihrem Shop – Sie brauchen dafür keine Datei anzufassen.

6.1 Die Vorlage öffnen

Öffnen Sie im Admin-Bereich den Inhaltsverwalter und dort die Seite „Produktempfehlung Mailvorlage“ (Nummer 67001). Der Text steht im Feld Inhalt.

Die Mailvorlage im Inhaltsverwalter des Shops
Abbildung 4: Die Mailvorlage im Inhaltsverwalter des Shops
Im normalen Bearbeitungsfenster werden die Platzhalter als kleine Symbole dargestellt und lassen sich schlecht treffen. Klicken Sie deshalb in der Werkzeugleiste des Editors auf „Quellcode“ – dort sehen und bearbeiten Sie den Text so, wie das Modul ihn liest.

6.2 Die Platzhalter

An den Stellen, an denen die Angaben zum Artikel eingesetzt werden sollen, schreiben Sie einen Platzhalter. Das Modul ersetzt ihn beim Klick durch den jeweiligen Wert:

Platzhalter Wird ersetzt durch
{M0067_PRODUCT_NAME} Name des Artikels
{M0067_PRODUCT_SHORTDESCRIPTION} Kurzbeschreibung des Artikels
{M0067_PRODUCT_LINK} Link zur Artikelseite
{M0067_PRODUCT_MODEL} Artikelnummer
{M0067_PLATTFORM} Ihr Plattformname aus dem Setup

Ein vollständiges Beispiel für den Quellcode der Vorlage:

Ich möchte folgendes Produkt auf {M0067_PLATTFORM} empfehlen:<br />
<br />
{M0067_PRODUCT_MODEL} - {M0067_PRODUCT_NAME}<br />
{M0067_PRODUCT_SHORTDESCRIPTION}<br />
<br />
Mehr erfahren: {M0067_PRODUCT_LINK}

Halten Sie den Text kurz und persönlich. Werbeblöcke, Gutscheinhinweise oder eine Signatur Ihres Shops nehmen der Nachricht genau das, was sie wirksam macht: Sie soll wie die Empfehlung eines Bekannten wirken und nicht wie ein Werbebrief.

6.3 Warum die Mail reiner Text ist

Die Übergabe an ein Mailprogramm ist weltweit einheitlich geregelt – und dabei sind ausschließlich reine Textinhalte vorgesehen. Schriftarten, Fettdruck, Farben, Tabellen oder Bilder lassen sich auf diesem Weg nicht übertragen.

Sie dürfen die Vorlage trotzdem bequem im gewohnten Editor schreiben: Das Modul räumt den Text vor der Übergabe selbst auf. Zeilenumbrüche und Absätze bleiben als echte Umbrüche erhalten, alle übrigen Auszeichnungen werden still entfernt, und Sonderzeichen wie Umlaute oder das kaufmännische Und werden korrekt zurückübersetzt. Im Mailfenster des Besuchers steht damit sauberer Fließtext – und keine Zeichenfolgen wie <p> oder &nbsp;.

Setzen Sie in der Vorlage keine Bilder und keine Tabellen ein. Beides geht bei der Übergabe verloren; im günstigsten Fall bleibt eine Lücke, im ungünstigsten ein zerrissener Text.

6.4 Weitere Sprachen

Die Vorlage wird für jede Sprache Ihres Shops getrennt gepflegt. Im Inhaltsverwalter finden Sie dafür oben die Sprachreiter (Flaggen) – deutsch und englisch sind bei der Installation bereits gefüllt.

Richten Sie später eine weitere Sprache ein, legt das Modul dafür automatisch einen Satz mit der englischen Fassung an. Sie brauchen ihn nur noch zu übersetzen. Welche Vorlage benutzt wird, entscheidet die Sprache, in der der Besucher den Shop gerade ansieht.

7. 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. Sie finden die Texte des Moduls dort im Bereich „M0067“.

Anpassen lassen sich unter anderem:

  • die Beschriftung des Knopfes auf der Artikelseite (Vorbelegung: „Produkt empfehlen“),
  • die Betreffzeile der Empfehlungsmail („Ich möchte dieses Produkt auf %s empfehlen“ – das %s ist die Stelle, an der Ihr Plattformname eingesetzt wird, es muss erhalten bleiben),
  • der Hinweis, der erscheint, falls sich die Empfehlung einmal nicht erzeugen lässt.
Nach einer Textänderung einmal den Textcache Ihres Shops leeren, sonst steht im Shop noch die alte Beschriftung.

8. Shopupdate und Modulpflege

Vor jedem Shopupdate – also vor einem Servicepack oder einem Wechsel auf eine neue Hauptversion – prüfen Sie bitte auf www.xycons.de in Ihrem Kundenkonto, ob das Modul für die neue Shopversion freigegeben ist.

Beim Update selbst installieren Sie immer beides in der jeweils neuesten Fassung: das Modul und die Modulumgebung. Ein älterer Stand passt sich nicht von selbst an eine neue Shopversion an – in diesem Fall steht der Knopf nach dem Update unter Umständen nicht mehr auf der Artikelseite, und die Ursache wird leicht am falschen Ende gesucht.

Lassen Sie Ihr Shopupdate durch uns durchführen, bringen wir vorhandene Module und die Modulumgebung automatisch mit auf den passenden Stand.

Nach jedem Update einmal den Cache Ihres Shops leeren – Seiten-, Modul- und Textcache. Das erspart die häufigste Rückfrage nach einer Aktualisierung.

9. Wenn einmal etwas nicht stimmt

Der Knopf erscheint nicht auf der Artikelseite

Prüfen Sie zuerst, ob der Modulstatus im Setup eingeschaltet ist. Steht er auf „Ein“, leeren Sie den Seiten-Cache Ihres Shops: Artikelseiten werden zwischengespeichert, und solange die alte Fassung im Cache liegt, fehlt der Knopf.

Es öffnet sich kein Mailfenster

Dann ist auf dem Gerät des Besuchers kein Mailprogramm eingerichtet. Das betrifft vor allem Arbeitsplatzrechner, an denen ausschließlich Webmail im Browser genutzt wird. Auf dem Gerät selbst lässt sich das einstellen, vom Shop aus nicht beeinflussen.

Im Mailfenster steht ein Hinweis statt der Empfehlung

Erscheint ein Hinweisfenster mit der Meldung, dass sich die Empfehlung nicht erstellen lässt, ist der Artikel im Augenblick nicht abrufbar – etwa weil er zwischenzeitlich abgeschaltet oder für die Kundengruppe des Besuchers gesperrt wurde. Das ist kein Fehler, sondern Absicht: Zu einem Artikel, den der Besucher nicht sehen darf, gibt das Modul auch keine Angaben heraus.

Der Text der Mail sieht anders aus als erwartet

Öffnen Sie die Vorlage im Inhaltsverwalter über die Schaltfläche „Quellcode“ und prüfen Sie die Platzhalter auf Tippfehler – ein falsch geschriebener Platzhalter bleibt unverändert stehen. Achten Sie außerdem auf Bilder oder Tabellen in der Vorlage; beides lässt sich nicht in eine Mail übernehmen.

Die Empfehlung ist in der falschen Sprache

Maßgeblich ist die Sprache, in der der Besucher den Shop gerade ansieht. Fehlt für diese Sprache eine Vorlage, benutzt das Modul die englische Fassung. Ergänzen Sie den Sprachreiter im Inhaltsverwalter, dann stimmt es.

Wir wünschen Ihnen viel Erfolg beim Einsatz dieses Moduls. Bei Fragen erreichen Sie uns über Ihr Kundenkonto auf www.xycons.de.

PDF herunterladen
Stand: 2026-09-27 11:03:54