Sync Data

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

Stellen Sie vor dem Synchronisieren der Daten sicher, dass Sie das Clerk-Plugin in Ihrem WooCommerce-Backend installiert und konfiguriert haben. Siehe die Get Started guide für Installationsanweisungen.

Sync einrichten #

Um Ihre WooCommerce-Shopdaten mit Clerk zu synchronisieren, müssen Sie die Import-URL in Clerk konfigurieren.

1. Kopieren Sie im Plugin Ihre Import URL aus dem Bereich “Allgemein”.

2. Aktivieren Sie Use Legacy Authentication im Bereich “Allgemein”. Diese Option ist erforderlich, wenn Sie reguläre Clerk Private API-Keys verwenden.

3. Gehen Sie zu my.clerk.io > Data > Configuration und fügen Sie die Import-URL in das Import-URL-Feld ein.

4. Wenn Sie Email & Audience verwenden möchten, setzen Sie Collect Emails auf Ja im Plugin und speichern Sie.

5. Wählen Sie die Sprache für Ihre Domain, falls zutreffend.

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

Clerk importiert nun Ihre Produkte, Kategorien und Bestellungen.

Produktdaten anpassen #

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

Einfache Attribute hinzufügen #

Falls die Attribute, die Sie übertragen 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 zu Ihrem 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 Bereich Datenabgleich das Attribut slug im Feld Additional Fields hinzu. Sie können auch mehrere verschiedene hinzufügen, getrennt durch Kommas.

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 über Code in zwei Dateien ergänzt 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, den das Attribut in Clerk haben soll, und = $product->get_sku() ist die WooCommerce-Logik zur Abfrage des Attributs.

Funktionen.php Attribute #

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

Diese Änderungen bleiben auch nach Plugin-Updates bestehen.

Folgen Sie diesen Schritten:

1. Fügen Sie den folgenden Code in die Datei Appearance > Theme Editor > functions.php ein:

// Ändert 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 ) {

// Verwendet zur Ausblendung von versteckten Produkten aus Search
   $params['catalog_visibility'] = $product->get_catalog_visibility();

// Wir nutzen nur die Kurzbeschreibung
   $params['description'] = $product->get_short_description();

    return $params;
}

2. (Optional) Möchten Sie eigene Attribute wie Marke, Farbe oder Material in Clerk aufnehmen, passen Sie die Funktion wie folgt 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();

    // Eigene Attribute hinzufügen
    $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. Falls die Attribute nicht erscheinen, stellen Sie sicher, dass diese im Backend unter Products > Attributes definiert 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 #

Das WooCommerce-Plugin von Clerk importiert standardmäßig nur veröffentlichte Produkte.

Dies kann bei Bedarf angepasst 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' beliebige Status hinzu, die importiert werden sollen, getrennt durch Kommas:

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 kennzeichnen.

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

{% 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 > Data und klicken Sie auf Start New Sync, um die neuen Produkte zu importieren.

Bestellungssynchronisation deaktivieren #

Nach erfolgreicher erster Datensynchronisation kann die Bestellungssynchronisation aus WooCommerce deaktiviert werden, da das Verkaufstracking durch die Erweiterung übernommen wird.

Sie haben zwei Optionen: Über my.clerk.io oder im Plugin in WooCommerce.

my.clerk.io #

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

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

Clerk importiert keine Bestellungen mehr aus WooCommerce.

Plugin #

1. Gehen Sie ins WooCommerce-Backend und klicken Sie in der linken Seitenleiste auf Clerk.

2. Gehen Sie in den Plugin-Einstellungen zum Bereich Data Sync: Orders. Aktivieren Sie das Kontrollkästchen Disable Order Synchronization.

3. Um die Änderungen zu übernehmen, klicken Sie auf Save Settings.

Seiten synchronisieren #

Wichtig: Damit dies funktioniert, muss WooCommerce in Ihrer WordPress-Installation installiert und aktiviert sein. Sie müssen es nicht benutzen oder konfigurieren, das Plugin enthält jedoch wichtige Funktionalitäten, die der 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, ist es oft schwierig, externen Blog-Content aktuell zu halten.

Um dies zu erleichtern, bieten wir jetzt eine No-Code-Lösung zum Synchronisieren von Blog-Inhalten mit jedem Clerk-Store – unabhängig von der Hauptplattform, wenn Sie Ihre Blogs über WordPress/WooCommerce verwalten.

Gehen Sie folgendermaßen vor, um dieses Feature zu nutzen:

1. Installieren Sie unser Plugin im WordPress-Backend.

2. Nach der Installation klicken Sie in der linken Seitenleiste 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 Inhalte importieren möchten, müssen Sie lediglich Use Real-time Updates im Bereich Data Sync: Pages aktivieren.

5. Klicken Sie auf Save Settings.

6. Nach dem Speichern der Einstellungen finden Sie eine Schaltfläche Sync Pages im Bereich Data Sync: Pages. Mit einem Klick darauf synchronisieren Sie sofort alle Ihre Seiten mit Ihrem my.clerk.io Store.

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

Sie können Additional Fields angeben, die für jede Seite abgerufen werden, sowie Page Additional Types, die von Drittanbieter-Plugins erstellt wurden, einbeziehen.

In der Regel reicht es aus, einmal auf Sync Pages zu klicken, denn jede Änderung an einer Seite, Veröffentlichung einer neuen Seite, Archivierung oder Löschung wird vom Plugin erkannt und automatisch im my.clerk.io Store aktualisiert.

Seitenimport deaktivieren #

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

1. Gehen Sie zu Data > Configuration.

2. Finden Sie die Einstellung Import Pages und stellen Sie sie auf No.

3. Klicken Sie auf Save.