Sync Data

Synchronisieren Sie Ihre WooCommerce-Produkte, -Kategorien, -Bestellungen und -Seiten mit Clerk. Diese Anleitung behandelt die Grundlagen sowie fortgeschrittene Anpassungsoptionen.

Datensynchronisation #

Um Daten aus Ihrem WooCommerce-Shop zu Clerk zu importieren, führen Sie folgende Schritte aus:

1. Erstellen Sie einen Store in my.clerk.io.

2. Installieren Sie das Clerk Plugin in WooCommerce.

3. Konfigurieren Sie das Plugin.

4. Synchronisieren Sie abschließend Ihren Store, indem Sie diese Schritte befolgen:

   • Melden Sie sich bei my.clerk.io an.

   • Gehen Sie zu Data > Configuration.

   • Geben Sie Ihre Import URL ein, also die URL Ihrer Webshop-Domain. Sie finden diese auch im Bereich Allgemein des Clerk Plugins in WooCommerce.

   • Klicken Sie auf Save.

   • Klicken Sie auf Start new data sync.

Clerk importiert nun Ihre Produkte, Kategorien und Bestellungen.

Produktdaten anpassen #

In WooCommerce können Sie benutzerdefinierte Produktattribute entweder über das WooCommerce-Backend oder über den Clerk Plugin 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 leicht auf der Plugin-Seite hinzugefügt werden.

1. Gehen Sie in Ihr WooCommerce-Backend.

2. Navigieren Sie zu Products > Attributes.

3. Finden Sie den slug des Attributs, das Sie hinzufügen möchten.

4. Klicken Sie im linken Seitenleistenmenü auf das Clerk Plugin.

5. Fügen Sie im Abschnitt Datensynchronisation das Attribut slug unter Additional Fields hinzu. Sie können auch mehrere verschiedene, durch Kommas getrennt, hinzufügen.

6. Klicken Sie auf Save Settings.

7. Gehen Sie zu my.clerk.io > Data > Configuration und klicken Sie auf Start New Data Sync.

Attribute manuell hinzufügen #

Attribute in WooCommerce können auch per 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 aufgebaut:

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

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

functions.php Attribute #

Sie können Clerk auch neue Attribute hinzufügen, indem Sie die Datei functions.php anpassen.

Diese Änderungen bleiben auch nach Plugin-Updates erhalten.

Gehen Sie wie folgt vor:

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

// Alters clerk parameters
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 ) {

// Used to hide hidden products from search
   $params['catalog_visibility'] = $product->get_catalog_visibility();

// We only use short_description
   $params['description'] = $product->get_short_description();

    return $params;
}

2. (Optional) Wenn Sie benutzerdefinierte Attribute (wie Marke, Farbe oder Material) in Clerk einbeziehen möchten, passen Sie die Funktion folgendermaßen an:

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();

    // Add custom attributes
    $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 erscheinen, stellen Sie sicher, dass sie im WooCommerce-Backend unter Products > Attributes angelegt sind.

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

Produkteinstellungen importieren #

Standardmäßig importiert das Clerk WooCommerce Plugin nur veröffentlichte Produkte.

Dies kann bei Bedarf geändert werden.

Die folgende Datei steuert, welche Produkte zu Clerk importiert werden: wp-content > plugins > clerkio > includes > class-clerk-rest-api.php

1. Suchen Sie in der Datei die Funktion product_endpoint_callback.

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

3. Beim Import nicht-veröffentlichter Produkte fügen Sie ein Attribut is_saleable hinzu, das true oder false zurückgibt, um die Verfügbarkeit zu verfolgen.

So können Sie den Verfügbarkeitsstatus in Ihren Designs wie folgt anzeigen:

{% if product.is_saleable %}
   <div class="in-stock">In Stock</div>
{% else %}
  <div class="not-in-stock">Not In Stock</div>
{% endif %}

4. Gehen Sie zu my.clerk.io > Data und klicken Sie auf Start New Sync, um die neuen Produkte zu importieren.

Bestellungssynchronisierung deaktivieren #

Nachdem die erste Datensynchronisierung erfolgreich abgeschlossen wurde, kann die Bestellungssynchronisierung von WooCommerce deaktiviert werden, da das Verkaufstracking durch die Erweiterung übernommen wird.

Sie haben zwei Möglichkeiten: Über my.clerk.io oder über das Plugin in WooCommerce.

my.clerk.io #

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

2. Scrollen Sie nach unten und ändern Sie rechts die Option unter Import Orders von Yes auf No, dann klicken Sie auf Save.

Clerk wird nun keine Bestellungen mehr von WooCommerce importieren.

Plugin #

1. Gehen Sie in das WooCommerce-Backend und klicken Sie im linken Seitenleistenmenü auf Clerk.

2. Scrollen Sie in den Plugin-Einstellungen nach unten zum Abschnitt Data Sync: Orders. Aktivieren Sie das Kontrollkästchen Disable Order Synchronization.

3. Klicken Sie zur Übernahme der Änderungen auf Save Settings.

Seiten synchronisieren #

Wichtig: Damit das funktioniert, muss WooCommerce in Ihrer WordPress-Installation installiert und aktiviert sein. Sie müssen es nicht verwenden oder konfigurieren, aber das Plugin enthält wichtige Funktionalitäten, die das Clerk Plugin benötigt.

Da ein Store in Clerk primär 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 dem entgegenzuwirken, bieten wir jetzt eine No-Code-Lösung zum Synchronisieren von Blog-Inhalten mit jedem Clerk Store – unabhängig von der Hauptplattform – sofern Sie Ihre Blogs über WordPress/WooCommerce verwalten.

So verwenden Sie dieses Feature:

1. Installieren Sie unser Plugin in Ihrem WordPress-Backend.

2. Klicken Sie nach der Installation im linken Seitenleistenmenü auf Clerk.

3. Geben Sie Ihre API-Keys aus Developers > API keys in my.clerk.io ein, um das Plugin zu konfigurieren.

4. Da wir in diesem Fall nur Schriftinhalte importieren möchten, aktivieren Sie lediglich Use Real-time Updates im Abschnitt Data Sync: Pages.

5. Klicken Sie auf Save Settings.

6. Nach dem Speichern der Einstellungen finden Sie im Bereich Data Sync: Pages einen Sync Pages-Button. Ein Klick darauf synchronisiert sofort alle Ihre Seiten mit Ihrem my.clerk.io-Store.

Das Plugin ermöglicht es Ihnen außerdem, anzupassen, welche Seitenattribute synchronisiert werden.

Sie können angeben, welche Additional Fields für jede Seite abgerufen werden und Page Additional Types von Drittanbieter-Plugins einbeziehen.

Es reicht aus, die Sync Pages-Schaltfläche einmal zu drücken, da jede Änderung einer Seite, jede Veröffentlichung, Archivierung oder Löschung durch unser Plugin erkannt und automatisch im my.clerk.io-Store aktualisiert wird.

Import von Seiten deaktivieren #

Um sicherzustellen, dass Seiten nur aus WordPress und nicht aus anderen Quellen während der Datensynchronisation importiert werden, deaktivieren Sie den Seitenimport in my.clerk.io:

1. Gehen Sie zu Data > Configuration.

2. Finden Sie die Einstellung Import Pages und setzen Sie diese auf No.

3. Klicken Sie auf Save.