Einbauhilfe Webmaster

From Winestro.Cloud Handbuch
Jump to navigation Jump to search

In diesem Artikel beschreiben wir, wie Du den Winestro.Cloud Privat-Webshop in die Seite Deines Kunden / Deiner Kundin mit einem optimalen Ergebnis einbauen kannst. Weiter unten findest Du auch Hinweise zu weiteren Einbaumethoden und Produkten, die einen Weinverkauf im Internet ermöglichen.

 Wichtiger Hinweis: Aus dem Ablaufplan lassen sich nie verbindliche Zeiten / Zusagen ableiten. Eine Shop-Erstellung kann je 
 nach Anforderung / Anspruch mehrere Wochen ab Startzeitpunkt des Entwicklers (Abweichend von der Annahme des Angebots) dauern.

Vorüberlegung

Unser eigenes Shopsystem kann in mehreren Varianten in die Homepage eines Winzers integriert werden.

  • Als einfacher Link in ein neues Tab (Stand-alone-Integration)
  • Als Iframe in der Webseite des Winzers (Iframe-Integration)
  • Vollintegration ohne Iframe in die Homepage via php-Classe (Full-Integration)

Für Dich als Agentur oder Seitenadministrator ist die Stand-alone-Integration in wenigen Minuten und die Iframe-Integration mit einem Zeitaufwand unter einer Stunde zu erreichen. Für die Full-Integration stellen wir Dir ein PHP-Script für den vollständigen Einbau zur Verfügung. Dies bietet etwas mehr Vorteile in Sachen SEO etc., stellt allerdings auch höhere Anforderungen an Dich und die Infrastruktur des Webservers:

  • Aktuelle PHP-Version
  • Anpassung des CSS von Webseite und Shop
  • Anpassung / Konfliktmanagement von Javascripten
  • Harmonisierung des Shop-Designs mit dem Webseiten-Design
  • Weiterleitung von Session- und Cookie-Daten an den Shop

Die Vollintegration wird in der Regel von sehr großen Weingütern / Unternehmen genutzt, wenn hier in der Google-Suche mit den Platzierungen auf Marktplätzen konkurriert / kompetitiert werden soll. Der Einsatz erzeugt idR. nochmals vergleichsweise hohe Kosten und bleibt Abwägungssache.


Funktionen des Shops

Das Weingut erhält initial von uns Informationen über den Shop und seine Funktionsweise. Diese findest Du hier Alle Funktionen und Einstellungen zum Shop für den Nutzer / Das Weingut sind in einem eigenen Artikel erklärt: Privater_Shop Der Privat-Shop von Weinbau-online pflegt sich weitestgehend selbst live aus dem System / der täglichen Arbeit heraus und funktioniert nach der Einrichtung nahezu vollautmatisch, was eine große Hilfe im Tagesgeschäft sein kann.

Der Start mit dem Weingut

Der Prozess bis zum fertigen Webshop sieht so aus:

  1. Das Weingut hat mindestens das Basis Paket gebucht
  2. Wir senden dem Weingut ein Angebot über die Shop-Erstellung mit einen Link zu den Beispiel-Shops
  3. Das Weingut wählt eine Vorlage für das grobe Aussehen aus und bestäigt das Angebot mit dem Vorschlag / der Designvorlage gleichzeitig
    • Alternativ: Wir erhalten eine genaue(!) Designvorlage durch das Weingut oder einen Grafiker zusammen mit der Annahme des Angebots
  4. Wir sichten die Seite des Weinguts
    • Ohne genaue Vorlage übernehmen wir das Farbschema der Webseite in die Designauswahl, ansonsten versuchen wir uns (so gut es technisch machbar ist - ohne Garantie auf genaue Einhaltung) an die gelieferte Vorlage zu halten.
  5. Die Shop-Erstellung startet - in der Regel benötigen wir ab diesem Punkt eine Woche, bei starker Auslastung oder einem stark abweichenden Desing kann sich die Zeit erhöhen.
  6. Du, als Webmaster, erhälst einen EINBAULINK von uns und folgst der Einbauanleitung (siehe unten)
    • Das Weingut erhält auch einen Einbaulink zur Sichtung und Korrektur / Kritik
  7. Änderungswünsche, die nicht in der Designvorgabe angegeben wurden, können nun im Rahmen der Support-Zeit nachbearbeitet werden.
  8. Ist die Supportzeit aufgebraucht, wird unser Stundensatz berechnet. Du / der Kunde wird darüber informiert. Kleinere Änderungen oder Bugfixes können über ein Support-Ticket durch den Kunden beauftragt werden und sind in der Regel (wir informieren vorher) Kulanzleistungen.

Gerne kannst Du die Schritte 1-4 mit dem Weingut zusammen selbst übernehmen und uns gleich den Vorschlag / den Entwurf zusenden.

Die Pflege durch das Weingut

Das Weingut ist als Shopbetrieber verpflichtet, diesen regelmäßig zu prüfen und alle Rechtstexte bereit zu stellen. Wir entwickeln das Shop-System regelmäßig weiter und bieten neue Funktionen an, die mit einem Shop-Update hinzugebucht werden können. Im Design sind wir vollkommen frei und können beinahe jede gewünschte Änderung zur Verfügung stellen, müssen aber weitere Arbeitszeit zu unserem Stundensatz abrechnen. Als gemeinsame Lektüre mit dem Weingut empfehlen wir die Handreichungen der IHK um die groben Punkte zu klären und selbst einen guten Überblick zu behalten. Hier findet das Weingut auch viele Vorlagen z.B. in Sachen Widerruf. Weiterhin raten wir zu einem AGB-Pflegevertrag mit unserem Rechtspartner.

Kommunikationsweg bei Problemen

Bitte weise bei Problemen das Weingut an uns ein Ticket im Hilfeforum zu schreiben. Damit können Aufträge und Kosten / Verbindlichkeiten / Auftragserteilungen direkt geklärt werden und wir sparen uns Umwege. So wird immer der passende Berater in unserem Haus informiert und das Weingut erhält schneller eine passendere Lösung als per E-Mail. Danke!

Übernahme bestehender Shops in neue Seiten

Sollst Du eine Homepage überarbeiten in der bereits ein Winestro Shop integriert ist, achte bei den neu gestalteten Seiten, dass gewisse Parameter in Design und (s.u.) der Weiterleitung und des CORS gändert werden müssen. Informiere uns bitte umgehend über den Kunden (s.o.) durch ein Ticket mit den benötigten Informationen (z.B. URL der neuen Seiten).

Cookie Consent & Datenschutz

Der Shop setzt nur Cookies, die technisch notwendig und (unserer nicht rechtsverbindlichen Einschätzung nach) nicht Consent-Pflichtig sind. Wir speichern keinerlei Nutzerdaten bis zur Bestellung ab. Daher raten wir von einer Banner-Lösung innerhalb des Shops ab, um Kunden nicht zu verschrecken. Drittanbieter wie PayPal etc. werden via Link aufgerufen und schalten eigene Cookie-Consent Banner. Auch die Einstellung Ihrer Webseite haben keinen Einfluss auf das Iframe, da die Lösung technisch getrennt ist. (Dies ist anders beim vollständigen Einbau mittels PHP). Damit dem Kunden klar ist, was mit seinen Daten passiert, sollte das Weingut in der Datenschutzerklärung auf der Webseite und im Shop den Kunden über die Verwendung / Weitergabe seiner Daten im Falle einer Shop-Bestellung Informieren.

Alleinstehende Variante

Der Shop kann komplett alleinstehend mit dem Header / Logo des Weinguts und einem "zurück zur Webseite" konzipiert werden. Das Weingut entscheidet das im Fall des Designs gleich mit. Das hat den Vorteil, dass dies die stabilste Variante ohne irgendwelche Einbau- Cookie oder Consent-Probleme ist. Allerdings besteht der kleine Nachteil des nicht so schönen Einbaulinks, der sichtbar in der Browserleiste steht. Das sollte aber mehr in die ästhethische Schiene fallen. Um das zu umgehen sollst Du auf der Webseite eine kleine Unterseite machen (z.B. meinweingut.de/shop) die dann einfach via Header oder JS auf den Shop weiter leitet.

Diese Variante wird seit 06/2020 empfohlen, da sie die unproblematischste Art ist.
Einige Nutzer_Innen mit neuen Macs / Safari können bei der I-Frame Variante ein 
nicht 100%iges Einkaufserlebnis haben.

Einbau via Iframe

Das Iframe bietet eine gängige und bekannte Lösung, die den Einbau in Webseiten sehr einfach gestaltet. Hiermit kommen viele Agenturen und selbst Weingüter klar. Der Vorteil liegt in der Robustheit des Systems, der Nachteil in der nicht so guten SEO Nutzbarmachung, die aber bei kleineren Weingütern weniger in den Fokus rücken dürfte. Die Iframe hat daneben in 2 Punkten noch einen kleinen Nachteil

  1. Auf strikt eingestellten Endgeräten (meist Apple) dürfen Drittanbieter nur dann Cookies setzen, wenn die Seite vorher standalone besucht wurde
  2. Neuste Mac-Geräte erlauben kein Sezten von so genannten Third-Party Cookies mehr. Das behindert ggf. auch den Shop und solche Nutzer_Innen werden ggf. auf eine alleinstehende Variante geleitet.
  3. Die Höhe der Frame kann nicht aus der Frame selbst bestimmt werden und muss von der Seite gesetzt werden

Beide Nachteile können aber einfach ausgeglichen werden.

Wir benötigen für den Einbau folgende Informationen:

  • Die Genaue URL, in der die Iframe später eingebaut werden soll

Bitte sende uns die Info an info@winestro.cloud

Der Einbaulink

Den Einbaulink musst Du direkt von Winestro.cloud / Über das Weingut anfordern. Er hat folgendes Format:

[Domain]/webshop/[Version]/shop_core.php?user_id=[USERID]&shop_id=[SHOPID]

Hier ein Beispiel für einen aktuellen Shop der Version 15.0 (Demo - funktioniert nicht):

https://nephele-s5.de/webshop/15.0/shop_core.php?user_id=X6udIQAJRMm1Rzp3bp5dQ==&shop_id=X6udQAJSYCRL58BCxnI9w==

Ausgleichen des Cookie-Problems

Visualisierung der Umleitung

Der Shop muss einmal alleinstehend aufgerufen werden. Das ermöglicht, dass Cookies gesetzt werden dürfen und - wenn der Kunde via Smartphone auf die Seite gelangt - der Nutzer ein optimales Erlebnis hat. Nach dem Kauf wird der Nutzer dann auf die Webseite zurück geleitet. Der Kunde wird auch zurück geleitet, wenn der Viewport groß genug für die Vollansicht ist.

Setze also Links zum Shop immer auf den EINBAUCODE Dieser Leitet dann ggf. zur eingebauten Seite.

Unser Tipp: Mache eine Seite mit einer Weiterleitung auf den Einbaucode, die der Winzer auch nach außen kommunizieren kann und eine Seite mit der Eingebauten Iframe. Damit erhälst du ein noch besseres Ergebnis.

Die neuste Shop-Generation kann auch die wenigen Nutzer_Innen mit Problemen abfangen und hier dem Cookie-Problem entgegen wirken. Dennoch bleibt die o.g. Einbaumethode sehr ratsam.

Ausgleich des Höhen-Problems

Visualisierung des Cors-Problems

WebSeiten unterschiedlicher Domains dürfen (was gut ist) sich nicht gegenseitig beeinflussen, wenn dies nicht ausdrücklich geregelt ist. Das soll Manipulationen vorbeugen. Damit der Shop immer in der passenden Höhe eingebunden wird, haben wir hier ein Code-Beispiel mit der Umsetzung eines CORS Requests zur Verfügung gestellt. Im Prinzip musst Du nur wenige Zeilen Javascript auf Deine Seite kopieren (nachdem Du uns die Domain (s.o.) mitgeteilt hast.

Zur Einbauhilfe

Einbau von Standalone-Seite via Subdomain

Der Shop kann auch (bei Standalone Varianten) als Subdomain eingebunden werden. Wähle hier "Iframe Weiterleitung" (o.ä.) und binde den EINBAULINK ein. Teile uns auch bitte in diesem Fall die Subdomain mit, damit wir alle Punkte ggf. passend für dich einstellen können.

Automatisches Einbauscript (!Beta!)

Mit dem automatischen Einbauscript (ab 13.0) kann der Shop ganz ohne Vorkenntnisse eingebaut werden. Der Syntax lautet wie folgt:

 <script>
    <script id="wboscript" src="https:// nephele-s5.de/webshop/[Version]/shopload.js?user_id=[user_id]&shop_id=[shop_id]"></script>
 </script>
  • user_id : Findest Du im EINBAULINK
  • shop_id : s.o,
  • Version : Die Versionsnummer Deines Shops; der aktuelle Standard ist 16.0

Warnung: Die Nutzung des Scripts ist aktuell im Beta / Teststadium und erfolgt auf eigenes Risiko. Das Script muss direkt an der Einbaustelle stehen und mindestens ein Parent Node (Div / Body etc..) im DOM besitzen. Sollte die Seite nicht laden / die OnLoad Events Deiner Webseite durch Scripte überschrieben werden, rufe:

 wbo_init(); 

in Deiner Onload-Funktion des DOM auf.

Externe Steuerung / Parameterübergabe

Wenn Du technisch dazu in der Lage bist, können Informationen auch an die Iframe weiter gegeben werden. Ergänze einfach den Einbaulink hier um weitere Parameter, die Du ans Ende anfügst. Das ermöglicht den Aufbau externer Menüs oder eines direkten Springens von der Webseite in den Frame. Beispiel:

 [EINBAULINK]&id_grp=3  | Ruft die Artikelgruppe mit der Kennung drei auf
 [EINBAULINK]&weinnr=13 | Ruft den Wein Nummer 13 auf.

Hier kannst Du die Paramter auf mehrere Arten an die Iframe weiter geben. Ein Beispiel mit PHP über die einframende URL wäre:

 [EINBAULINK]&weinnr=<? echo $_GET["weinnr"]; ?>| Ruft den Wein Nummer 13 auf.

Ein anderer, sehr schön sprechender Weg ist das Einbinden über Subdomains. Das ist in der Regel bei den meisten Hostern einfach möglich. So könntest Du z.B. wie folgt verlinken:

 shop.weingut.de | Zeigt auf den [EINBAULINK]
 riesling.weingut.de | Zeigt auf [EINBAULINK]&id_grp=3 (Sofern 3 die Rieslinge wären)
 ...

Die id_grp und Wein-Nummer kannst Du einfach herausfinden, indem Du dir die URL der Frame nach einem Klick auf den Wein / die Gruppe anschaust. Ein Code zum jeweiligen Link kann auch in der Artikelkarteikarte hergesellt werden. Lese hier weiter: Privater_Shop#QR-Codes

Native-Einbindung / PHP Einbindung

Der Shop kann auch serverseitig eingebunden werden. Dies setzt jedoch weitreichende Kenntnisse in Sachen PHP Voraus und sollte in der Regel nur nach Einweisung durch unser Team erfolgen. Auf diesen Seiten haben wir Dir eine Beispielklasse zur Verfügung gestellt, die Du nach Belieben für Deine Bedürfnisse anpassen kannst:

Beispielklasse

Weitere Einbaumethoden / Anschlussmöglichkeiten von Shops

Visualisierung der Schnittstellen (Preise Stand 12.08.21, es gilt die aktuelle Preisliste)

Grundsätzlich ist es kein Problem mehrere Webshops, APIs oder Schnittstellen mit WBO gleichzeitig zu verbinden. Auch die Nutzung eines (eigenen) Shops und Winestro schließen sich nicht aus. Eher im Gegenteil: WBO ist auf einen multi-Channel Verkauf ausgelegt. Alle Möglichkeiten der Schnittstellen und Shops findest Du auch in der Grafik rechts.

Woocommerce

Winestro.cloud bietet auch eine Woocommerce Schnittstelle an, mit der Du leicht Deinen Wordpress-Shop an die Warenwirtschaft anschließen kannst. Damit kannst Du selbst den Shop Deinen Kunden zur Verfügung stellen.

Offene XML Schnittstelle

Lese dazu den Artikel zur WBO-API

Anbindung weiterer Systeme über Partner

Shopware / Gambio: Sumedia

Weitere Informationen zur Shopware-Schnittstelle findest Du hier. Ein Anschluss eines selbst gehosteten Gambio-Shops kann auch direkt über uns erfolgen. Bitte kontaktiere uns bei Interesse.

Shopify: Formrausch

Alle Infos zum Anschluss von Shopify fondest Du auf der Seite der Partner-Shops.

Datei-Importe

Von Strato, WIX etc. können Dateiexporte eingelesen werden. Mehr Infos hier: Shop-Importe

Winestro - Shop ohne Einrichtungskosten

Für Weingüter, die noch keinen Webshop haben, keine Investitionen aufnehmen möchten und nur schnell Wein online verkaufen möchten (ohne die Probleme mit AGB, Bereitstellung etc.) bieten wir unser Winestro-Shopsystem an, dass ähnlich wie die Iframe-Lösung in die eigene Seite eingebaut werden kann oder alleinstehend bleiben kann. So kannst Du Weingüter z.B. extrem schnell mit einem temporären Shop versorgen.

 Winestro für die eigene Homepage

Einbau des Winestro-Shops

Einbaulinks von Winestro

Der Winestro-Shop kann nur mit der Iframe-Variante (siehe oben) oder als alleinestehende Variante eingbaut werden. Den EINBAULINK findet das Weingut unter Auftrag / Platt-Form-Shop auf der letzten Seite. In der alleinstehenden Variante kann einfach der erste Link / SRC des Iframe gesetzt werden. Wenn der Shop als Iframe eingebaut werden soll, ist die Kunden-Nummer (gelb) durch die Kunden-Nummer des Weinguts zu ersetzten. Die spätere Seite mit dem Iframe (rot markiert im Bild) ist ebenfalls im Programm einzustellen um die Cookie-Problematik (siehe Iframe-Einbau Privat-Shop weiter oben) zu beheben und alle Cookies zu setzen. Eine automatische Höhenänderung / CORS Aufruf ist in dieser Variante nicht möglich. Wir empfehlen den Einbau als alleinstehende Seite in einem neuen Tab.

Support

Grundsätzlich sind im Rahmen der Shop-Erstellung und der Anfangs-Betreuung Stunden vorgesehen. In der Regel übernehmen wir den Support in den ersten Tagen auf Kulanz / im Rahmen unserer Fair-Use Policy. Sollten Kosten für die Beratung / Umstellung / Design-Änderung durch Anweisungen / Vorschläge Deinerseits für das Weingut anfallen, werden diese von uns vorher darauf hingewiesen. Danach informieren wir das Weingut darüber, damit dieses uns die notwendige Programmierleistung / Support-Zeit authorisiert. Wir bitten um Verständnis, dass wir hier - um Kundenfrust zu vermeiden - zusätzliche oder nachträgliche Leistungen mit dem Weingut direkt absprechen, bevor wir diese umsetzen.

Fragen zu Datenschutz / Rechtstexten

Das findest Du im Artikel zum Webshop allgemein: Privater_Shop#Infos_zu_Rechtstexten_und_Datenschutzerkl.C3.A4rungen