Sync Data

Synkroniser dine WooCommerce produkter, kategorier, ordrer og sider til Clerk. Denne vejledning dækker det grundlæggende samt avancerede tilpasningsmuligheder.

Inden du synkroniserer data, skal du sikre dig, at du har installeret og konfigureret Clerk-pluginet 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-URLen i Clerk.

1. I pluginnet, kopier din Import URL fra Generelt-sektionen.

2. Aktiver Use Legacy Authentication i Generelt-sektionen. Denne valgmulighed er påkrævet ved brug af almindelige Clerk Private API-nøgler.

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

4. Hvis du planlægger at anvende Email & Audience, sæt Collect Emails til Ja i pluginnet og gem.

5. Vælg sprog for dit domæne, hvis det er relevant.

6. Klik på Start Sync og vent på, at synkroniseringen fuldføres.

Clerk vil nu importere dine produkter, kategorier og ordrer.

Tilpasning af produktdata #

I WooCommerce kan du tilføje Brugerdefinerede produktegenskaber via WooCommerce-backenden eller gennem Clerk-pluginet i kode, hvis nødvendigt.

Tilføj simple egenskaber #

Hvis de egenskaber, du ønsker at sende, allerede er tilgængelige som simple egenskaber i din WooCommerce-administration, kan de nemt tilføjes på Pluginsiden.

1. Gå til din WooCommerce-backend.

2. Naviger til Products > Attributes.

3. Find slug for den egenskab, du ønsker at tilføje.

4. Klik på Clerk-pluginet i venstremenuen.

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

6. Klik på Save Settings.

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

Tilføj egenskaber manuelt #

Egenskaber 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 egenskab er struktureret sådan her:

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

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

Functions.php egenskaber #

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

Disse ændringer forbliver, selv når pluginnet opdateres.

Følg disse trin:

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

// Alters clerk parameters
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 ) {

// Used to hide hidden products from search
   $params['catalog_visibility'] = $product->get_catalog_visibility();

// We only use short_description
   $params['description'] = $product->get_short_description();

    return $params;
}

2. (Valgfrit) Hvis du ønsker at tilføje brugerdefinerede egenskaber (såsom brand, farve eller materiale) i Clerk, rediger 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();

    // Add custom attributes
    $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 enhver WooCommerce-egenskab du ønsker at synkronisere. Hvis egenskaberne ikke vises, skal du sikre, at de er defineret under Products > Attributes i din WooCommerce-backend.

4. Til sidst, gå til my.clerk.io > Data > Configuration og klik på Start New Data Sync for at importere dine nye egenskaber.

Import af produktindstillinger #

Som standard importerer Clerks WooCommerce-plugin kun Publicerede produkter.

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

Følgende fil styrer, hvilke produkter der 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 de Status du ønsker at inkludere, adskilt med komma:

3. Ved import af ikke-publicerede produkter, tilføj en is_saleable egenskab, der returnerer true eller false for at spore tilgængelighed.

Dette giver mulighed for at vise tilgængelighedsstatus i dine Designs som vist 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.

Deaktivér ordre-sync #

Efter første datasynkronisering er kørt succesfuldt, kan ordre-sync fra WooCommerce deaktiveres, da salgssporingen fra udvidelsen overtager.

Du har to muligheder: Fra my.clerk.io eller fra pluginnet i WooCommerce.

my.clerk.io #

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

2. Scroll ned og til højre, skift valget 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 venstremenuen.

2. I plugin-indstillingerne, scroll ned til Data Sync: Orders sektionen. Afkryds boksen mærket Disable Order Synchronization.

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

Synkronisering af sider #

Vigtigt: For at dette fungerer, skal du have WooCommerce installeret og aktiveret i din WordPress-installation. Du behøver ikke bruge eller konfigurere det, men pluginnet har essentiel funktionalitet, som Clerk-pluginet har brug for.

Da en butik i Clerk primært forbindes 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 synkronisering af blogindhold med enhver Clerk-butik uanset primær platform, hvis du administrerer dine blogs via WordPress/WooCommerce.

Sådan bruger du funktionen:

1. Installer vores plugin via din WordPress-backend.

2. Når det er installeret, klik på Clerk i venstremenuen.

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

4. Da vi kun ønsker at importere skrevet indhold i dette tilfælde, behøver du blot at aktivere Use Real-time Updates i Data Sync: Pages sektionen.

5. Klik på Save Settings.

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

Pluginet giver dig også mulighed for at tilpasse, hvilke sideegenskaber der synkroniseres.

Du kan angive Additional Fields som skal hentes for hver side og inkludere Page Additional Types lavet af tredjepartsplugins.

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

Deaktiver side-import #

For at sikre at sider kun synkroniseres fra WordPress og ikke fra andre kilder under Data Sync, deaktiver 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.