Sync Data

Synchronisieren Sie Ihre PrestaShop-Produkte, Attribute und Bestelldaten mit Clerk. Diese Anleitung behandelt die Anpassung von Produktdaten, die Auswahl der zu importierenden Produkte und die Verwaltung der Bestellsynchronisierung.

Bevor Sie Daten synchronisieren, stellen Sie sicher, dass Sie das Clerk-Modul in Ihrem PrestaShop-Backend installiert und konfiguriert haben. Lesen Sie die Get Started guide für Installationsanweisungen.

Sync einrichten #

Um Ihre PrestaShop-Shop-Daten mit Clerk zu synchronisieren, müssen Sie die Daten-Synchronisationseinstellungen in Clerk konfigurieren.

1. Gehen Sie zu my.clerk.io > Data > Configuration.

2. Geben Sie Ihre Webshop-URL in Store URL ein.

3. Wenn Sie Email & Audience verwenden möchten, setzen Sie Collect Emails im Prestashop-Modul auf Ja und speichern Sie.

4. Wählen Sie die Sprache Ihrer Domain, falls zutreffend.

5. Klicken Sie auf Start Sync und warten Sie, bis die Synchronisation abgeschlossen ist.

Produktdaten anpassen #

In Prestashop können Sie die meisten einfachen Attribute direkt aus dem Admin-Bereich hinzufügen, aber Sie können auch benutzerdefinierte Attribute direkt im Code erstellen.

Einfache Attribute senden #

Hinweis: Diese Funktion funktioniert nur ab v.5.3.2. Sehen Sie in dieser Anleitung nach, wie Sie ein Upgrade durchführen.

Gehen Sie im Prestashop-Admin-Bereich zunächst in folgenden Bereich:

Prestashop 1.7: Katalog -> Attribute & Eigenschaften Prestashop 1.6 : Katalog -> Produkt-Attribute

Hier sehen Sie alle verfügbaren Attribute:

Finden Sie die Namen der Attribute, die Sie hinzufügen möchten.

Gehen Sie anschließend zu Module und Dienste -> Clerk -> Konfigurieren.

Unter Daten-Synchronisationseinstellungen geben Sie die Attribut-Namen durch Kommas getrennt in Zusätzliche Felder für Produkte ein.

Sie können auch Felder wie Produkt-Eigenschaften einbeziehen aktivieren, um alle Produkteigenschaften zu Clerk zu importieren.

Beide Optionen stehen sowohl in Version 1.6 als auch 1.7 von Prestashop zur Verfügung:

Nachdem Sie Ihre Attribute hinzugefügt haben, gehen Sie zu my.clerk.io->Data und klicken Sie oben rechts auf Start New Data Sync.

Wenn die zu übertragenden Attribute bereits als Teil Ihrer konfigurierbaren/gebündelten Produktdaten im PrestaShop-Admin vorhanden sind, können Sie diese einfach mit der aktuellen Version Ihres Plugins synchronisieren.

Sie erscheinen dann als child_attribute, z.B. child_color, child_skus usw.

Benutzerdefinierte Attribute senden #

Fortgeschrittene benutzerdefinierte Attribute können über die Moduldaten in FTP hinzugefügt werden.

Diese Datei verwaltet die Produktattribute:

modules->clerk->controllers->front->product.php

Jedes Attribut hat einen eigenen fieldHandler, der im Funktionsbereich __construct verwendet wird, um es abzurufen.

Fügen Sie Ihr Attribut einfach mit folgendem Syntax hinzu:

$this->addFieldHandler('CLERK_ATTRIBUTE_NAME',function($product){
return PRESTASHOP_LOGIC;
});

Dabei definiert CLERK_ATTRIBUTE_NAME den Namen, wie er in Clerk erscheinen soll und PRESTASHOP_LOGIC ist der Code, um das Attribut aus Prestashop auszulesen.

Abschließend fügen Sie Ihre neuen Attribute in die Funktion getDefaultFields() am Ende der Datei ein.

Produkte zum Import auswählen #

Sie können das PrestaShop-Modul so konfigurieren, dass alle Produkte zu Clerk übertragen werden, statt nur der standardmäßig verkäuflichen.

Dazu suchen Sie zunächst die Datei in FTP:

modules->clerk->controllers->front->product.php

In der Funktion getJsonResponse() suchen Sie diese Zeile:

$products = $product->getProducts($this->getLanguageId(), $this->offset, $this->limit, $this->order_by, $this->order, false, false);

Ändern Sie einfach das allerletzte Argument von true auf false.

Wenn Sie dies tun, empfehlen wir, dass Sie ein zusätzliches Attribut in dieser Datei hinzufügen, das anzeigt, wenn ein Produkt nicht verkäuflich ist – so können Sie es im Design anzeigen.

Angenommen, Sie erstellen ein Attribut namens is_saleable, das entweder true oder false ist, dann können Sie es in Designs wie folgt verwenden:

{% raw %}
{% if product.is_saleable %}
   <div class="in-stock">Auf Lager</div>
{% else %}
  <div class="not-in-stock">Nicht auf Lager</div>
{% endif %}
{% endraw %}

Gehen Sie abschließend zu my.clerk.io -> Data und klicken Sie auf Start New Sync, um Ihre neuen Daten zu importieren.

Bestell-Synchronisierung deaktivieren #

Nachdem die erste Datensynchronisierung erfolgreich durchgeführt wurde, kann die Bestell-Synchronisation aus Prestashop deaktiviert werden, da das Verkaufs-Tracking vom Modul übernommen wird.

Um die Bestell-Synchronisierung zu deaktivieren, gehen Sie zu Verbessern => Module => Modulmanager

Scrollen Sie nach unten und finden Sie das Clerk-Modul unter Sonstiges. Klicken Sie auf Konfigurieren:

Scrollen Sie zum Feld mit dem Namen Einstellungen für die Datensynchronisation und klicken Sie auf JA neben dem Text Synchronisierung von Bestellungen deaktivieren:

Scrollen Sie zum Ende der Seite und klicken Sie auf Speichern:

Ihre Änderungen werden dann wirksam.