Sync Data

Data synkronisering #

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

1. Opret en butik i my.clerk.io.
2. Installer Clerk.io-plugin’et i WooCommerce.
3. Konfigurer plugin’et.
4. Endelig, synkroniser din Store ved at følge disse trin:
   • Log ind på my.clerk.io.
   • Gå til System Status > Data Sync.
   • Indtast din Import URL, som er din webshop-domæne-URL. Du kan også finde dette i den Generelle sektion af Clerk.io-plugin’et 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 gennem WooCommerce-backend eller gennem Clerk.io-plugin’et i kode, hvis nødvendigt.

Tilføj enkle attributter #

Hvis de attributter, du ønsker at sende, allerede er tilgængelige som enkle attributter i din WooCommerce-administration, kan de nemt tilføjes på plugin-siden.

1. Gå til din WooCommerce-backend.
2. Naviger til Products > Attributes.
3. Find slug for den attribut, du ønsker at tilføje.

4. Klik på Clerk.io-plugin’et i venstre sidebjælke.

5. I sektionen Data Sync, 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 > System Status > Data Sync og klik på 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. Disse 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åledes:

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

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

Functions.php Attributter #

Du kan også tilføje nye attributter til Clerk.io ved at ændre functions.php-filen. Disse ændringer vil bestå, 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 søgning
   $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.io, ændre 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. Erstat “brand”, “color” og “material” med eventuelle WooCommerce-attributter, du ønsker at synkronisere. Hvis attributterne ikke vises, skal du sikre dig, at de er defineret under Products > Attributes i din WooCommerce-backend.
4. Endelig, gå til my.clerk.io > System Status > Data Sync og klik på Start New Data Sync for at importere dine nye attributter.

Importer produktindstillinger #

Som standard importerer Clerk.io’s WooCommerce-plugin kun Offentliggjorte produkter. Dette kan ændres, hvis nødvendigt. Den følgende fil kontrollerer, hvilke produkter der importeres til Clerk.io: 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, som du ønsker at inkludere, adskilt af kommaer:

3. Når du importerer ikke-offentliggjorte produkter, tilføj en is_saleable-attribut, der 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 #

Efter den første data-synkronisering er kørt med succes, kan ordre-synkronisering fra WooCommerce deaktiveres, da salgsopfølgningen 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 > System Status > Data Sync.
2. Rul ned, og til højre, ændre 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 sidebjælke.
2. I plugin-indstillingerne, rul ned til sektionen Data Sync: Orders. Tjek boksen mærket Disable Order Synchronization.
3. For at få ændringerne til at træde i kraft, klik på Save Settings.

Synkronisering af sider #

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

Da en butik i Clerk.io 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 imødekomme dette giver vi nu en no-code-løsning til synkronisering af 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 på din WordPress-backend.
2. Når det er installeret, klik på Clerk i venstre sidebjælke.
3. Indtast dine API-nøgler fra Settings > API keys i my.clerk.io for at konfigurere plugin’et.
4. Da vi kun ønsker at importere skrevet 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, vil du finde en Sync Pages-knap i sektionen Data Sync: Pages. Klik på denne knap for straks at synkronisere alle dine sider med din my.clerk.io-butik.

Plugin giver dig også mulighed for at tilpasse, hvilke sideattributter der synkroniseres. Du kan specificere Additional Fields at hente for hver side og inkludere Page Additional Types oprettet af tredjeparts plugins.

Du skal kun trykke på Sync Pages-knappen én gang, da enhver ændring på en side, offentliggørelse af en ny side, arkivering eller sletning vil blive opfanget af vores plugin og opdateret i my.clerk.io-butikken automatisk.

Deaktiver sideimport #

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

1. Gå til System Status > Data Sync
2. Find indstillingen Import Pages og indstil den til No
3. Klik på Save