Sync Data

Synkronisér dine WooCommerce-produkter, -kategorier, -ordrer og -sider til Clerk. Denne guide dækker det grundlæggende samt avancerede tilpasningsmuligheder.

Før du synkroniserer data, skal du sikre dig, at du har installeret og konfigureret Clerk-plugin’et i din WooCommerce-backend. Se kom-i-gang guiden for installationsvejledning.

Opsæt Sync #

For at synkronisere dine WooCommerce-butiksdata med Clerk, skal du konfigurere import-URL’en i Clerk.

1. I plugin’et, kopier din Import URL fra General-sektionen.

2. Aktiver Use Legacy Authentication i General-sektionen. Denne indstilling er påkrævet, når du bruger almindelige Clerk Private API keys.

3. Gå til my.clerk.io > Data > Configuration og indsæt Import URL’en i feltet Import URL.

4. Hvis du planlægger at bruge Email & Audience, skal du sætte Collect Emails til Ja i plugin’et og gemme.

5. Vælg sproget for dit domæne, hvis relevant.

6. Klik på Start Sync og vent på, at synkroniseringen er gennemført.

Clerk vil nu importere dine produkter, kategorier og ordrer.

Tilpasning af produktdata #

I WooCommerce kan du tilføje tilpassede produktattributter via WooCommerce-backend eller gennem Clerk-plugin’et i kode, hvis nødvendigt.

Tilføj simple attributter #

Hvis de attributter, du vil sende, allerede er tilgængelige som simple attributter i din WooCommerce-administration, kan de nemt tilføjes på Plugin-siden.

1. Gå til din WooCommerce-backend.

2. Navigér til Products > Attributes.

3. Find slug på attributten, du vil tilføje.

4. Klik på Clerk Plugin i venstre sidebjælkemenu.

5. I Data Sync-sektionen, tilføj attributten slug i Additional Fields. Du kan også tilføje flere forskellige, adskilt af kommaer.

6. Klik på Save Settings.

7. Gå til my.clerk.io > Data > Configuration og klik Start New Data Sync.

Tilføj attributter manuelt #

Attributter i WooCommerce kan også tilføjes gennem kode i to filer.

Disse filer bruges til at synkronisere produkter både manuelt og automatisk, når der foretages ændringer i webshoppen.

Dette er filerne:

1. I wp-content > plugins > clerkio > includes > class-clerk-realtime-updates.php, tilføj attributten i add_product.

2. I wp-content > plugins > clerkio > includes > class-clerk-rest-api-php, tilføj attributten til $product_array i product_endpoint_callback.

Hver attribut er struktureret sådan her:

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

Hvor ['sku'] definerer navnet, du ønsker, attributten skal have i Clerk, og = $product->get_sku() er WooCommerce-logikken til at hente attributten.

Functions.php attributter #

Du kan også tilføje nye attributter til Clerk ved at ændre functions.php-filen.

Disse ændringer bevares, selvom plugin’et opdateres.

Følg disse trin:

1. Tilføj følgende kode til Appearance > Theme Editor > functions.php:

// Ændrer clerk-parametre
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 ) {

// Bruges til at skjule skjulte produkter fra Search
   $params['catalog_visibility'] = $product->get_catalog_visibility();

// Vi bruger kun short_description
   $params['description'] = $product->get_short_description();

    return $params;
}

2. (Valgfrit) Hvis du ønsker at inkludere tilpassede attributter (såsom brand, farve eller materiale) i Clerk, skal du ændre funktionen sådan her:

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

    // Tilføj tilpassede attributter
    $params['brand'] = $product->get_attribute('brand');
    $params['color'] = $product->get_attribute('color');
    $params['material'] = $product->get_attribute('material');

    return $params;
}

3. Erstat “brand”, “color” og “material” med alle de WooCommerce-attributter, du vil synkronisere. Hvis attributterne ikke vises, skal du sikre, at de er defineret under Products > Attributes i din WooCommerce-backend.

4. Gå til sidst til my.clerk.io > Data > Configuration og klik på Start New Data Sync for at importere dine nye attributter.

Import af produktindstillinger #

Som standard importerer Clerk’s WooCommerce-plugin kun publicerede produkter.

Dette kan ændres, hvis det er nødvendigt.

Følgende fil styrer, hvilke produkter som importeres til Clerk: wp-content > plugins > clerkio > includes > class-clerk-rest-api.php

1. I filen, find funktionen kaldet product_endpoint_callback.

2. I $products listen, under 'status', tilføj enhver Status, du vil inkludere, adskilt af kommaer:

3. Når du importerer ikke-publicerede produkter, skal du tilføje en is_saleable attribut, der returnerer true eller false for at spore tilgængelighed.

Dette gør det muligt at vise tilgængelighedsstatus i dine Designs sådan her:

{% if product.is_saleable %}
   <div class="in-stock">På lager</div>
{% else %}
  <div class="not-in-stock">Ikke på lager</div>
{% endif %}

4. Gå til my.clerk.io > Data og klik på Start New Sync for at importere de nye produkter.

Deaktiver ordresync #

Efter første datasynkronisering er gennemført, kan ordresync fra WooCommerce deaktiveres, da salgs-tracking fra udvidelsen overtager.

Du har to muligheder: fra my.clerk.io eller fra plugin’et i WooCommerce.

my.clerk.io #

1. Gå til my.clerk.io > Data > Configuration.

2. Rul ned og til højre, ændr indstillingen under Import Orders fra Yes til No, og klik så på Save.

Clerk vil nu ikke længere importere ordrer fra WooCommerce.

Plugin #

1. Gå til WooCommerce-backenden og klik på Clerk i venstre sidebjælkemenu.

2. I plugin-indstillingerne, rul ned til sektionen Data Sync: Orders. Afkryds boksen, der hedder Disable Order Synchronization.

3. Klik på Save Settings for at ændringerne træder i kraft.

Synkronisering af sider #

Vigtigt: For at dette skal fungere, skal du have WooCommerce installeret og aktiveret i din WordPress-installation. Du behøver ikke at bruge eller konfigurere det, men plugin’et har afgørende funktionalitet, som Clerk-plugin’et har brug for.

Da en butik i Clerk primært forbinder til din e-handelsplatform for at synkronisere kataloger, ordrer og kunder, kan det være udfordrende at holde eksternt blogindhold opdateret.

For at løse dette tilbyder vi nu en no-code løsning til at synkronisere blogindhold til enhver Clerk-butik uanset primær platform, hvis du administrerer dine blogs gennem WordPress/WooCommerce.

For at bruge denne funktion, følg disse trin:

1. Installer vores plugin i din WordPress-backend.

2. Når plugin’et er installeret, klik på Clerk i venstre sidebjælkemenu.

3. Indtast dine API-nøgler fra Developers > API keys i my.clerk.io for at konfigurere plugin’et.

4. Da vi kun vil importere skrevet indhold i dette tilfælde, skal du blot aktivere Use Real-time Updates i sektionen Data Sync: Pages.

5. Klik på Save Settings.

6. Efter at have gemt indstillingerne, finder du en Sync Pages-knap i sektionen Data Sync: Pages. Ved at klikke på denne knap synkroniseres alle dine sider straks med din my.clerk.io butik.

Plugin’et giver dig også mulighed for at tilpasse, hvilke sideattributter der synkroniseres.

Du kan angive Additional Fields der skal hentes for hver side og inkludere Page Additional Types som er oprettet af tredjeparts plugins.

Du bør kun skulle trykke på Sync Pages-knappen én gang, da enhver ændring af en side, udgivelse af en ny side, arkivering eller sletning bliver fanget af vores plugin og automatisk opdateret i my.clerk.io-butikken.

Deaktiver sideimport #

For at sikre, at sider kun synkroniseres fra WordPress og ikke fra andre kilder under Data Sync, skal du deaktivere sideimport i my.clerk.io:

1. Gå til Data > Configuration.

2. Find Import Pages-indstillingen og sæt den til No.

3. Klik på Save.