Sync Data

Synchronisieren Sie Ihre PrestaShop-Produkte, Attribute und Bestelldaten mit Clerk. Dieser Leitfaden behandelt die Anpassung von Produktdaten, die Auswahl der zu importierenden Produkte und die Verwaltung der Auftragssynchronisation.

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

Synchronisation einrichten #

Um Ihre PrestaShop-Shopdaten mit Clerk zu synchronisieren, müssen Sie die Daten-Synchronisations-Einstellungen in Clerk konfigurieren.

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

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

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

4. Wählen Sie ggf. die Sprache Ihrer Domain aus.

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

Produktdaten anpassen #

In Prestashop können Sie die meisten einfachen Attribute direkt im Admin hinzufügen, aber Sie können auch eigene Attribute direkt im Code erstellen.

Senden von einfachen Attributen #

Hinweis: Diese Funktion ist nur ab v.5.3.2 verfügbar. Sehen Sie in diesem Leitfaden nach, wie Sie ein Upgrade durchführen.

Gehen Sie im Prestashop-Admin zunächst zu folgendem Abschnitt:

Prestashop 1.7: Katalog -> Attribute & Merkmale Prestashop 1.6 : Katalog -> Produktattribute

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 Data Sync Settings geben Sie die Attribut-Namen durch Komma getrennt unter Additional Fields for Products ein.

Sie können auch Felder wie Include Product Features aktivieren, um alle Produktmerkmale zu Clerk zu importieren.

Beides ist sowohl in Version 1.6 als auch 1.7 von Prestashop verfügbar:

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

Wenn die Attribute, die Sie senden möchten, bereits in Ihren konfigurierbaren/gebündelten Produktdaten im PrestaShop-Admin verfügbar sind, können sie problemlos mit der neuesten Version Ihres Plugins synchronisiert werden.

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

Senden von benutzerdefinierten Attributen #

Fortgeschrittene benutzerdefinierte Attribute können über die Moduldateien im FTP hinzugefügt werden.

Diese Datei verwaltet die Produktattribute:

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

Jedes Attribut hat einen eigenen fieldHandler, welcher im Konstruktor __construct verwendet wird, um es abzurufen

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

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

Dabei definiert CLERK_ATTRIBUTE_NAME den Namen, den Sie in Clerk verwenden wollen, und PRESTASHOP_LOGIC enthält den Code zum Abrufen des Attributs aus Prestashop.

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

Auswahl der zu importierenden Produkte #

Sie können das PrestaShop-Modul so konfigurieren, dass alle Produkte an Clerk gesendet werden, anstatt wie standardmäßig nur die verkaufbaren.

Gehen Sie dazu wie folgt vor und suchen Sie diese Datei per FTP:

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

Suchen Sie in der Funktion getJsonResponse() folgende Zeile:

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

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

Wenn Sie dies tun, empfehlen wir, ein zusätzliches Attribut in diese Datei einzufügen, das angibt, ob ein Produkt nicht verkaufbar ist, damit Sie es in Ihrem Design anzeigen können.

Wenn Sie beispielsweise ein Attribut mit dem Namen is_saleable erstellen, das entweder true oder false sein kann, können Sie dies in Designs wie folgt verwenden:

{% raw %}
{% if product.is_saleable %}
   <div class="in-stock">In Stock</div>
{% else %}
  <div class="not-in-stock">Not In Stock</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.

Auftragssynchronisation deaktivieren #

Nachdem die erste Datensynchronisation erfolgreich durchgeführt wurde, kann die Auftragssynchronisierung von Prestashop deaktiviert werden, da das Sales-Tracking des Moduls übernimmt.

Um die Auftragssynchronisierung zu deaktivieren, gehen Sie auf Verbessern => Module => Modulauswahl

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

Scrollen Sie zum Feld Einstellungen für die Datensynchronisierung und klicken Sie bei dem Text Synchronisation von Bestellungen deaktivieren auf JA:

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

Ihre Änderungen werden dann übernommen.