Sync Data

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

Data synkronisering #

For at importere data fra din WooCommerce-butik til Clerk, følg disse trin:

1. Opret en butik i my.clerk.io.

2. Installer Clerk Plugin i WooCommerce.

3. Konfigurer plugin’et.

4. Synkronisér til sidst din Store ved at følge disse trin:

   • Log ind på my.clerk.io.

   • Gå til Data > Configuration.

   • Indtast din Import URL, som er din webshop’s domæne-URL. Du kan også finde denne i Generelt-sektionen i Clerk Plugin i WooCommerce.

   • Klik på Save.

   • Klik på Start new data sync.

Clerk vil nu importere dine produkter, kategorier og ordrer.

Tilpasning af produktdata #

I WooCommerce kan du tilføje Brugerdefinerede 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 WooCommerce-backend.

2. Naviger til Products > Attributes.

3. Find slug for den attribut, du vil tilføje.

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

5. I sektionen Data Sync tilføjer du 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 på Start New Data Sync.

Tilføj attributter manuelt #

Attributter i WooCommerce kan også tilføjes via 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. wp-content > plugins > clerkio > includes > class-clerk-realtime-updates.php i funktionen add_product:

2. wp-content > plugins > clerkio > includes > class-clerk-rest-api-php i funktionen product_endpoint_callback i $product_array:

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 forbliver, selv når 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 brugerdefinerede attributter (såsom brand, farve eller materiale) i Clerk, modificér funktionen således:

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 brugerdefinerede attributter
    $params['brand'] = $product->get_attribute('brand');
    $params['color'] = $product->get_attribute('color');
    $params['material'] = $product->get_attribute('material');

    return $params;
}

3. Udskift “brand”, “color” og “material” med de WooCommerce-attributter, du vil synkronisere. Hvis attributterne ikke vises, så sørg for, 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 Udgivne produkter.

Dette kan ændres om nødvendigt.

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

1. Find funktionen kaldet product_endpoint_callback i filen.

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

3. Når ikke-udgivne produkter importeres, tilføj en is_saleable attribut, som returnerer true eller false for at spore tilgængelighed.

Dette giver dig mulighed for at vise tilgængelighedsstatus i dine Designs således:

{% 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 ordre-synkronisering #

Når den første synkronisering af data er gennemført, kan ordresynkronisering fra WooCommerce deaktiveres, da salgstracking 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 derefter på Save.

Clerk vil ikke længere importere ordrer fra WooCommerce.

Plugin #

1. Gå til WooCommerce-backend og klik på Clerk i venstre sidemenu.

2. I plugin-indstillingerne rulles der ned til sektionen Data Sync: Orders. Marker feltet Disable Order Synchronization.

3. For at ændringerne skal træde i kraft, klik på Save Settings.

Synkronisering af sider #

Vigtigt: For at dette virker skal du have WooCommerce installeret og aktiveret i din WordPress-installation. Du behøver ikke bruge eller konfigurere det, men plugin’et har en grundlæggende funktionalitet, som Clerk-plugin’et kræver.

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

For at løse dette tilbyder vi nu en no-code-løsning til at synkronisere blogindhold med 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 det 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 skriftligt indhold i dette tilfælde, skal du kun aktivere Use Real-time Updates i sektionen Data Sync: Pages.

5. Klik på Save Settings.

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

Plugin tillader dig også at tilpasse, hvilke sideattributter der synkroniseres.

Du kan angive Additional Fields til at hente for hver side og inkludere Page Additional Types oprettet af tredjeparts-plugins.

Du behøver kun trykke på Sync Pages-knappen én gang, da enhver ændring af en side, udgivelse af en ny side, arkivering eller sletning registreres af vores plugin og automatisk opdateres i my.clerk.io-butikken.

Deaktiver sideimport #

For at sikre, at sider kun synkroniseres fra WordPress og ikke fra andre kilder under Data Sync, deaktiver sidesynkronisering i my.clerk.io:

1. Gå til Data > Configuration.

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

3. Klik på Save.