Sync Data

Datensynchronisierung #

Um Daten von Ihrem WooCommerce-Shop zu Clerk.io zu importieren, befolgen Sie diese Schritte:

1. Erstellen Sie einen Shop in my.clerk.io.
2. Installieren Sie das Clerk.io-Plugin in WooCommerce.
3. Konfigurieren Sie das Plugin.
4. Synchronisieren Sie schließlich Ihren Store indem Sie diese Schritte befolgen:
   • Melden Sie sich bei my.clerk.io an.
   • Gehen Sie zu System Status > Data Sync.
   • Geben Sie Ihre Import URL ein, die die URL Ihrer Webshop-Domain ist. Sie finden dies auch im Abschnitt Allgemein des Clerk.io-Plugins in WooCommerce.
   • Klicken Sie auf Speichern.
   • Klicken Sie auf Neue Datensynchronisierung starten.

Clerk wird nun Ihre Produkte, Kategorien und Bestellungen importieren.

Anpassung der Produktdaten #

In WooCommerce können Sie Benutzerdefinierte Produktattribute über das WooCommerce-Backend oder über das Clerk.io-Plugin im Code hinzufügen, falls erforderlich.

Einfache Attribute hinzufügen #

Wenn die Attribute, die Sie senden möchten, bereits als einfache Attribute in Ihrem WooCommerce-Admin verfügbar sind, können sie einfach auf der Plugin-Seite hinzugefügt werden.

1. Gehen Sie zu Ihrem WooCommerce-Backend.
2. Navigieren Sie zu Produkte > Attribute.
3. Finden Sie den slug des Attributs, das Sie hinzufügen möchten.

4. Klicken Sie im linken Seitenmenü auf das Clerk.io-Plugin.

5. Fügen Sie im Abschnitt Datensynchronisierung das Attribut slug in die Zusätzliche Felder ein. Sie können auch mehrere verschiedene hinzufügen, durch Kommas getrennt.

6. Klicken Sie auf Einstellungen speichern.

7. Gehen Sie zu my.clerk.io > System Status > Data Sync und klicken Sie auf Neue Datensynchronisierung starten.

Attribute manuell hinzufügen #

Attribute in WooCommerce können auch über Code in zwei Dateien hinzugefügt werden. Diese Dateien werden verwendet, um Produkte sowohl manuell als auch automatisch zu synchronisieren, wenn Änderungen im Webshop vorgenommen werden. Dies sind die Dateien:

1. wp-content > plugins > clerkio > includes > class-clerk-realtime-updates.php in der Funktion add_product:

2. wp-content > plugins > clerkio > includes > class-clerk-rest-api-php in der Funktion product_endpoint_callback in $product_array:

Jedes Attribut ist wie folgt strukturiert:

$product_array['sku'] = $product->get_sku();

Wo ['sku'] den Namen definiert, den das Attribut in Clerk.io haben soll, und = $product->get_sku() die WooCommerce-Logik zum Abrufen des Attributs ist.

Functions.php Attribute #

Sie können auch neue Attribute zu Clerk.io hinzufügen, indem Sie die functions.php-Datei ändern. Diese Änderungen bleiben auch bestehen, wenn das Plugin aktualisiert wird. Befolgen Sie diese Schritte:

1. Fügen Sie den folgenden Code zu Design > Theme Editor > functions.php hinzu:

// Ändert die Clerk-Parameter
add_filter( 'clerk_product_sync_array', 'clerk_change_params', 10, 2 );
add_filter( 'clerk_product_array', 'clerk_change_params', 10, 2 );

function clerk_change_params( $params, $product ) {

// Wird verwendet, um versteckte Produkte aus der Suche auszublenden
   $params['catalog_visibility'] = $product->get_catalog_visibility();

// Wir verwenden nur short_description
   $params['description'] = $product->get_short_description();

    return $params;
}

2. (Optional) Wenn Sie benutzerdefinierte Attribute (wie Marke, Farbe oder Material) in Clerk.io einfügen möchten, ändern Sie die Funktion wie folgt:

add_filter('clerk_product_sync_array', 'clerk_change_params', 10, 2);
add_filter('clerk_product_array', 'clerk_change_params', 10, 2);

function clerk_change_params($params, $product) {

    $params['catalog_visibility'] = $product->get_catalog_visibility();
    $params['description'] = $product->get_short_description();

    // Fügen Sie benutzerdefinierte Attribute hinzu
    $params['brand'] = $product->get_attribute('brand');
    $params['color'] = $product->get_attribute('color');
    $params['material'] = $product->get_attribute('material');

    return $params;
}

3. Ersetzen Sie “brand”, “color” und “material” durch beliebige WooCommerce-Attribute, die Sie synchronisieren möchten. Wenn die Attribute nicht angezeigt werden, stellen Sie sicher, dass sie im Abschnitt Produkte > Attribute in Ihrem WooCommerce-Backend definiert sind.
4. Gehen Sie schließlich zu my.clerk.io > System Status > Data Sync und klicken Sie auf Neue Datensynchronisierung starten, um Ihre neuen Attribute zu importieren.

Importieren von Produkteinstellungen #

Standardmäßig importiert das WooCommerce-Plugin von Clerk.io nur Veröffentlichte Produkte. Dies kann bei Bedarf geändert werden. Die folgende Datei steuert, welche Produkte in Clerk.io importiert werden: wp-content > plugins > clerkio > includes > class-clerk-rest-api.php

1. Suchen Sie in der Datei die Funktion mit dem Namen product_endpoint_callback.

2. Fügen Sie in der Liste $products unter 'status' alle Status hinzu, die Sie einbeziehen möchten, durch Kommas getrennt:

3. Beim Import nicht veröffentlichter Produkte fügen Sie ein is_saleable-Attribut hinzu, das true oder false zurückgibt, um die Verfügbarkeit zu verfolgen. Dies ermöglicht es Ihnen, den Verfügbarkeitsstatus in Ihren Designs wie folgt anzuzeigen:

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

4. Gehen Sie zu my.clerk.io > Daten und klicken Sie auf Neue Synchronisierung starten, um die neuen Produkte zu importieren.

Deaktivieren der Bestellsynchronisierung #

Nachdem die erste Datensynchronisierung erfolgreich durchgeführt wurde, kann die Bestellsynchronisierung von WooCommerce deaktiviert werden, da die Verkaufsverfolgung von der Erweiterung übernommen wird. Sie haben zwei Optionen: Von my.clerk.io oder vom Plugin in WooCommerce.

My.clerk.io #

1. Gehen Sie zu my.clerk.io > System Status > Data Sync.
2. Scrollen Sie nach unten und ändern Sie rechts die Option unter Import Orders von Ja auf Nein, und klicken Sie dann auf Speichern. Clerk wird keine Bestellungen mehr von WooCommerce importieren.

Plugin #

1. Gehen Sie zum WooCommerce-Backend und klicken Sie im linken Seitenmenü auf Clerk.
2. Scrollen Sie in den Plugin-Einstellungen nach unten zum Abschnitt Data Sync: Orders. Aktivieren Sie das Kontrollkästchen mit der Bezeichnung Bestellsynchronisierung deaktivieren.
3. Um die Änderungen wirksam zu machen, klicken Sie auf Einstellungen speichern.

Synchronisieren von Seiten #

Wichtig: Damit dies funktioniert, müssen Sie WooCommerce in Ihrer WordPress-Installation installiert und aktiviert haben. Sie müssen es nicht verwenden oder konfigurieren, aber das Plugin hat grundlegende Funktionen, die das Clerk.io-Plugin benötigt.

Da ein Shop in Clerk.io hauptsächlich mit Ihrer E-Commerce-Plattform verbunden ist, um Kataloge, Bestellungen und Kunden zu synchronisieren, kann es eine Herausforderung sein, externe Blog-Inhalte aktuell zu halten.

Um dies zu lösen, bieten wir jetzt eine No-Code-Lösung für die Synchronisierung von Blog-Inhalten mit jedem Clerk-Shop, unabhängig von der primären Plattform, wenn Sie Ihre Blogs über WordPress/WooCommerce verwalten. Um diese Funktion zu nutzen, befolgen Sie diese Schritte:

1. Installieren Sie unser Plugin in Ihrem WordPress-Backend.
2. Nachdem es installiert ist, klicken Sie im linken Seitenmenü auf Clerk.
3. Geben Sie Ihre API-Schlüssel aus Einstellungen > API-Schlüssel in my.clerk.io ein, um das Plugin zu konfigurieren.
4. Da wir in diesem Fall nur schriftliche Inhalte importieren möchten, sollten Sie nur Echtzeit-Updates verwenden im Abschnitt Data Sync: Pages aktivieren.
5. Klicken Sie auf Einstellungen speichern.
6. Nachdem Sie die Einstellungen gespeichert haben, finden Sie eine Seiten synchronisieren-Schaltfläche im Abschnitt Data Sync: Pages. Wenn Sie auf diese Schaltfläche klicken, werden sofort alle Ihre Seiten mit Ihrem my.clerk.io-Shop synchronisiert.

Das Plugin ermöglicht es Ihnen auch, anzupassen, welche Seitenattribute synchronisiert werden. Sie können Zusätzliche Felder angeben, die für jede Seite abgerufen werden sollen, und Zusätzliche Seitentypen einbeziehen, die von Drittanbieter-Plugins erstellt wurden.

Sie müssen die Seiten synchronisieren-Schaltfläche nur einmal drücken, da jede Änderung an einer Seite, die Veröffentlichung einer neuen Seite, Archivierung oder Löschung von unserem Plugin erfasst und automatisch im my.clerk.io-Shop aktualisiert wird.

Deaktivieren des Seitenimports #

Um sicherzustellen, dass Seiten nur von WordPress und nicht von anderen Quellen während der Datensynchronisierung synchronisiert werden, deaktivieren Sie die Seitenimporte in my.clerk.io:

1. Gehen Sie zu System Status > Data Sync
2. Finden Sie die Einstellung Import Pages und setzen Sie sie auf Nein
3. Klicken Sie auf Speichern