WooHS Plugin Documentation

Vorbereitung

Für den reibungslosen Einsatz von WooHS, gilt es das WaWi von HS Soft auf die Datensnychronisation vorzubereiten. 

Produkte, die für den Online-Shop vorgesehen sind müssen zwingend folgende Informationen beinhalten:

  • Produktname
  • Preis
  • Artikel-Nr.
  • Marketing-Gruppe 

Darüber hinaus macht es Sinn, dass die Beschreibungstexte, Deklarationen und Nährwerttabellen vorhanden sind. Sowie ein Produktfoto. 

Einrichtung

  • Laufender Vertrag mit HS Soft
  • Lizenzschlüssel (erhalten Sie von HS Soft)
  • Laufende WordPress Installation mit Woocommerce

Laden Sie die Installationsdatei, die Sie von HS Soft erhalten haben auf Ihre WordPress Installation hoch. Das Woocommerce Plugin wird für WooHS vorausgesetzt. 

Geben Sie die beiden Lizenzschlüssel in die entsprechenden Felder ein, um die Funktionen des Plugins freizuschalten. Klicken Sie auf Speichern, um die Verbindung zu den Daten herzustellen. 

Bitte beachten Sie, dass der Aufbau der Datenverbindung je nach Anzahl Artikel mehrere Minuten in Anspruch nehmen kann. Verlassen Sie dabei nicht das Browserfenster und klicken Sie nicht weg. 

Sie können die Lizenzschlüssen jederzeit in den Einstellungen (Zahnradsymbol in der oberen rechten Ecke) wieder finden und ändern.

Wenn die Daten von der Schnittstelle geladen wurden, erhalten Sie auf dem Startbischirm (Häuschen-Symbol in der oberen linken Ecke) die Meldung über die geladenen Datensätze. 

Klicken Sie auf Produkte erstellen, um die geladenen Daten anzuzeigen. Im nächsten Schritt wählen Sie, welche Produktkategorien (Marketing-Groups), Sie importieren möchten. 

  • Produkt Status: Definiert, welchen Status die importierten Produkte haben werden. 
  • Verfügbarkeiten von HS Soft übernehmen: Sind im WaWi Verfügbarkeitsdaten, werden diese für die Sichtbarkeit der Produkte übernommen. Wenn aktiviert, können Sie definieren, was passieren soll, wenn sich ein Produkt ausserhalb des Verfügbarkeitszeitraums befindet. Produkt wird auf Entwurf gestellt oder auf nicht verfügbar (out of stock). 
  • Nur Datensätze mit vorhandenem Produktbild importieren: Nur Produkte, wo auch ein Produktbild hinterlegt wurde, werden für den Import berücksichtigt. 

Klicken Sie auf «Jetzt Produkte erstellen», um die ausgewählten Daten anzuzeigen. 

In dieser Übersicht sehen Sie alle Produkte mit einer Bildvorschau, die Ihren Importkriterien entsprechen. Um den Import zu starten klicken Sie auf «Produkte erstellen». 

Bitte beachten Sie auch hier wieder, dass der Import je nach Datenmenge mehrere Minuten dauern kann. Während des Imports das Browserfenster nicht schliessen oder weggklicken. 

Der Import ist dann abgeschlossen, wenn die Erfolgsmeldung erscheint. 

Verwendung von Shortcodes

WooHS speichert die Produktdaten für jedes Produkt in individuelle Felder (Custom Fields) ab. Diese können beliebig im eigenen Template eingesetzt werden. Die Verwendung folgender Shortcodes setzt die entsprechenden Werte am gewünschten Ort ein. 

Deklaration

[woohs_product_declaration]


Verügbarkeitsdaten

[woohs_product_delivery_periods]


Gewicht

[woohs_product_gewicht]


Liefertage

[woohs_product_liefertage]


Nährwerttabelle

[woohs_product_rezept]

Alle Werte können zudem einzeln (nur Wert) mit folgenden Shortcodes ausgelesen werden.

  • [woohs_product_energieKJ]
  • [woohs_product_energieKcal]
  • [woohs_product_fett]
  • [woohs_product_fettgesaettigt]
  • [woohs_product_transfett]
  • [woohs_product_kohlenhydrate]
  • [woohs_product_zucker]
  • [woohs_product_eiweiss]
  • [woohs_product_salz]
  • [woohs_product_fructose]  

Beispiel: [woohs_product_salz] zeigt den reinen Wert des Feldes als Zahl an: 4

Dies vereinfacht die Darstellung in einer eigens erstellten Tabelle oder falls die Werte unabhängig voneinander eingesetzt werden möchten. 


Informationen zur Lagerung

[woohs_product_storage]


Produktbeschreibung

[woohs_product_info_customer_text]


Verbraucherhinweise

[woohs_product_storage_customer_text]

Die Shortcodes können überall auf der Website als Text platziert werden. Um sie fix ins Template für alle Produkte übergreifend zu platzieren, verwendet man die do_shortcode Funktion von WordPress innerhalb von /content-single-product.php

Beispiel: 

echo do_shortcode( ‹[woohs_product_declaration]› );

Einstellungen

  • Purge Cache: Löscht den Datenzwischenspeicher des Imports. Alle Produkte werden beim nächsten Import komplett von der Schnittstelle geladen. 
  • Produkte automatisch synchronsieren: Der Import wird über Nacht automatisch durchgeführt. So werden die Veränderungen im WaWi jeweils am nächsten Tag im Shop sichtbar. 
  • Cache automatisch leeren: Der Zwischenspeicher wird vor jeder automatischen Synchronsation vorher geleert, um sicherzustellen, dass die aktuellsten Daten geladen wurden. 

 

In WaWi besteht die Möglichkeit, mehrere Preise zu hinterlegen. Hier wählen Sie, welcher Preis für den Shop eingestellt werden soll. 

  • Bestellungen an das Kassensystem übermitteln: Aktiviert die Übermittlungsfunktion an HS Soft. Bestellungen werden mit einer leichten Verzögerung (max. 2 Minuten) übertragen. 
  • Übermitteltes Bestelldatum: Falls Sie in Woocommerce mittels Plugins (siehe auch kompatible Plugins) ein bestimmtes Liefer- / Abholdatum anbieten, können Sie hier einstellen, welches Datum an HS Soft gesendet werden soll. 
  • Status Bestell-Übermittlung: Hier definieren Sie bei welchem Status die Bestellung übermittelt werden soll. Es sind mehrere Stati möglich.

 

Kompatible Plugins

WooHS funktioniert bestens mit den folgenden Drittanbieter-Plugins:

Nehmen Sie mit uns Kontakt auf, falls Sie die Kompatibilität zu einem weiteren Plugin wünschen. 

Troubleshooting

  • Prüfen Sie die korrekte Eingabe der Lizenzschlüssel. Erscheint ein grünes Häkchen nach dem Feld, ist die Eingabe korrekt. Ein rotes Kreuz weist auf eine nicht gültige oder nicht vorhandene Lizenz hin.
  • Kontaktieren Sie HS Soft, um die Lizenzschlüssel zu erhalten. 

WooHS holt sich als Referenz für die Kategorien die Angaben aus der Marketing-Group (Marketing-Gruppe) aus dem WaWi von HS Soft. Speichern Sie Produkte, welche für den Online-Shop bestimmt sind mit einer Marketing-Group ab. 

  • Die Produktfotos müssen im WaWi von HS Soft nach folgenden Kriterien hinterlegt werden: 
    1024×768 Pixel
    JPG, PNG
    max 300 KB
  • Es kann vorkommen, dass Bilder nicht aktualisiert werden. Leeren Sie den Cache (Purge Cache) in den Einstellungen von WooHS und laden Sie die Produkte. Danach führen Sie einen erneuten Import durch. 
    Sollte weiterhin ein falsches oder altes Bild übertragen werden, verlinken Sie das Bild in WaWi nochmals neu oder laden Sie es dort erneut hoch. Beim nächsten Import sollte das Bild aktualisiert werden. 
  • Es kann sein, dass Daten im Zwischenspeicher veraltet sind. In den Einstellungen wählen Sie die «Purge Cache» funktion, um die Daten nochmals komplett von der Schnittstelle zu laden. 
    Wichtig: Nachdem die Daten geladen worden sind, befinden Sie sich vorerst nur im Cache (Zwischenspeicher). Sie müssen nun einen Import durchführen, um die neuen Daten in Woocommerce zu importieren. 
  • Falls eizelne Bilder nach wiederholten Synchronisationsversuchen weiterhin nicht aktualisiert wurden, kann folgendes helfen:
  • Cache leeren
  • Bild neu verknüpfen im WaWi (HS Soft)
  • Falls ein Webseiten-Caching Plugin aktiv ist, diesen Cache auch leeren 
  • Stelle sicher, dass sowohl Start- wie auch ein Enddatum hinterlegt sind

 Nur, wenn ein Start- und ein Enddatum im WaWi hinterlegt werden, kann ein Zeitraum berechnet werden, in dem das Produkt sichtbar sein wird. 

FAQ

Zurzeit kann über das WaWi nur 1 Foto pro Produkt zugewiesen werden. 

Sie können aber im Woocommerce das Produkt mit einer Gallery anreichern, diese wird bei der Synchronisation nicht verändert. 

WooHS kann keine Daten in Woocommerce löschen. Um Produkte aus dem Shop zu nehmen gibt es zwei Möglichkeiten: 

  1. Automatisch auf Entwurf setzen
    Bei den Verfügbarkeitsdaten (WaWi) ein Enddatum in der Vergangenheit setzen. Dies führt dazu, dass das Produkt auf Entwurf gesetzt wird und nicht mehr sichtbar ist. 
  2. Manuell löschen
    Im WaWi die Marketing-Gruppe entfernen und das Produkt in Woocommerce manuell löschen, sodass es beim nächsten Import nicht mehr berücksichtigt wird.