Sync Data

Synchronisieren Sie Ihre WooCommerce-Produkte, -Kategorien, -Bestellungen und -Seiten mit Clerk. Dieser Leitfaden behandelt die Grundlagen sowie erweiterte Anpassungsoptionen.

Bevor Sie Daten synchronisieren, stellen Sie sicher, dass Sie das Clerk-Plugin in Ihrem WooCommerce-Backend installiert und konfiguriert haben. Siehe die Erste Schritte Anleitung 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 Abschnitt Allgemein.

2. Aktivieren Sie Use Legacy Authentication im Abschnitt Allgemein. Diese Option ist erforderlich, wenn Sie reguläre Clerk Private API-Schlüssel verwenden.

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

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

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

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

Clerk importiert jetzt Ihre Produkte, Kategorien und Bestellungen.

Produktdaten anpassen #

In WooCommerce können Sie benutzerdefinierte Produktattribute entweder über das WooCommerce-Backend oder bei Bedarf durch Code im Clerk-Plugin hinzufügen.

Einfache Attribute hinzufügen #

Wenn die gewünschten Attribute bereits als einfache Attribute in Ihrer WooCommerce-Administration 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 Seitenmenü auf das Clerk-Plugin.

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

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 durch 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. In wp-content > plugins > clerkio > includes > class-clerk-realtime-updates.php fügen Sie das Attribut in add_product hinzu.

2. In wp-content > plugins > clerkio > includes > class-clerk-rest-api-php fügen Sie das Attribut zum $product_array in product_endpoint_callback hinzu.

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 zum Abrufen des Attributs.

Functions.php Attribute #

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

Diese Änderungen bleiben auch nach einem Plugin-Update erhalten.

Folgen Sie diesen Schritten:

1. Fügen Sie folgenden Code in 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 ) {

// Zum Ausblenden versteckter Produkte in der Suche
   $params['catalog_visibility'] = $product->get_catalog_visibility();

// Es wird nur die Kurzbeschreibung verwendet
   $params['description'] = $product->get_short_description();

    return $params;
}

2. (Optional) Möchten Sie benutzerdefinierte Attribute (wie brand, color oder material) in Clerk einbeziehen, 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();

    // Benutzerdefinierte 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 die WooCommerce-Attribute, die Sie synchronisieren möchten. Sollten die Attribute nicht erscheinen, stellen Sie sicher, dass sie unter Products > Attributes im WooCommerce-Backend 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 #

Standardmäßig importiert das WooCommerce-Plugin von Clerk 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, durch Kommas getrennt:

3. Beim Import von nicht-veröffentlichten Produkten 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">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 #

Nachdem die erste Datensynchronisation erfolgreich abgeschlossen wurde, kann die Bestellungssynchronisation von WooCommerce deaktiviert werden, da die Verkaufserfassung 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 importiert nun keine Bestellungen mehr aus WooCommerce.

Plugin #

1. Gehen Sie ins WooCommerce-Backend und klicken Sie im linken Seitenmenü auf Clerk.

2. Scrollen Sie in den Plugineinstellungen nach unten zum Bereich Data Sync: Orders. Aktivieren Sie das Kästchen bei Disable Order Synchronization.

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

Seiten synchronisieren #

Wichtig: Damit das funktioniert, müssen WooCommerce und das Plugin in Ihrer WordPress-Installation aktiviert sein. Sie müssen WooCommerce nicht verwenden oder konfigurieren, aber das Plugin stellt wichtige Funktionen bereit, die das Clerk-Plugin benötigt.

Da ein Shop in Clerk in erster Linie mit Ihrer E-Commerce-Plattform verbunden ist, um Kataloge, Bestellungen und Kunden zu synchronisieren, kann das Aktualisieren externer Blog-Inhalte schwierig sein.

Um dem entgegenzuwirken, bieten wir nun eine No-Code-Lösung an, um Blog-Inhalte mit jedem Clerk-Shop zu synchronisieren – unabhängig von der Primärplattform, sofern Sie Ihre Blogs über WordPress/WooCommerce verwalten.

Um diese Funktion zu nutzen, gehen Sie wie folgt vor:

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

2. Nach der Installation klicken Sie im linken Seitenmenü auf Clerk.

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

4. Da in diesem Fall nur schriftliche Inhalte importiert werden sollen, müssen Sie lediglich Use Real-time Updates im Abschnitt Data Sync: Pages aktivieren.

5. Klicken Sie auf Save Settings.

6. Nach dem Speichern finden Sie eine Sync Pages-Schaltfläche im Abschnitt Data Sync: Pages. Wenn Sie darauf klicken, werden alle Ihre Seiten sofort mit Ihrem my.clerk.io-Shop synchronisiert.

Das Plugin ermöglicht es auch, anzupassen, welche Seitenattribute synchronisiert werden.

Sie können Additional Fields zum Abrufen jeder Seite angeben und Page Additional Types einbeziehen, die von Drittanbieter-Plugins erstellt wurden.

In der Regel müssen Sie die Sync Pages-Schaltfläche nur einmal drücken. Änderungen an einer Seite, das Veröffentlichen einer neuen Seite, das Archivieren oder Löschen werden automatisch vom Plugin erkannt und im my.clerk.io-Shop aktualisiert.

Import von Seiten deaktivieren #

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

1. Gehen Sie zu Data > Configuration.

2. Suchen Sie die Einstellung Import Pages und setzen Sie sie auf No.

3. Klicken Sie auf Save.