Magento 1

Sync Data

Tilføjelse af yderligere produktegenskaber til Clerk via Magento-udvidelsen
Backend i Clerk.io backend

Synkroniser dine Magento 1-produkter, attributter og ordredata til Clerk. Denne guide dækker tilpasning af produktdata, valg af hvilke produkter der skal importeres, ændring af billedstørrelser og håndtering af ordresynkronisering.

Før du synkroniserer data, skal du sørge for, at du har installeret og konfigureret Clerk-udvidelsen i din Magento 1-backend. Se Kom godt i gang-guiden for installationsinstruktioner.

Opsæt Sync #

For at synkronisere dine Magento 1-shopdata med Clerk, skal du konfigurere import-URL’en i Clerk-udvidelsen og starte synkronisering.

  1. I Magento-udvidelsen skal du kopiere Import URL for din shop.

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

  3. Hvis du planlægger at bruge Email & Audience, skal du sætte Collect Emails til Yes i Magento-udvidelsen og gemme.

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

  5. Klik på Start Sync og vent på, at synkroniseringen bliver fuldført.

Deaktiver ordresynk #

Når den første datasynkronisering er gennemført, kan ordresynkronisering fra Magento1 deaktiveres, da salgssporing fra udvidelsen tager over.

For at deaktivere ordresynk, åbn System > Configuration i din Magento 1-backend.

Under Current Configuration Scope vælger du det site, du vil ændre.

Klik derefter på SETTINGS under CLERK-fanen i venstre sidebar, og ændr feltet ud for DISABLE ORDER SYNCHRONIZATION fra NO til YES.

Klik på Save Config for at anvende ændringerne med det samme.

Ændring af billedstørrelser #

Som standard henter Clerk-udvidelsen til Magento billeder i størrelsen 210x210 px.

Dette kan ændres i følgende fil:

app->code->community->Clerk->Clerk->Catalog->Product.php

I toppen af denne fil ændres $imageHeight og $imageWidth for at indstille billeddimensioner.

Ændr værdierne til den ønskede størrelse, og gem filen.

Gå derefter til my.clerk.io -> Data Sync og kør en ny synkronisering ved at klikke på Start Sync.

Dine nye billeder vil nu blive synkroniseret.

Valg af produkter til import #

Vise udsolgte produkter #

Hvis du også ønsker at vise produkter, der er udsolgt, i dine Clerk-resultater, kan du nemt styre dette i Magento-backenden.

Start med at gå til:

System -> Configuration -> CLERK -> Settings

Vælg din Store View fra venstremenuen, og gå til Clerk Settings.

Sæt Include Out Of Stock Products til Yes og klik på Save Config.

Gå til sidst til my.clerk.io -> Data og klik på Start New Data Sync for at importere alle produkter, inklusiv dem der er udsolgt.

Avancerede ændringer #

I Magento styrer følgende fil, hvilke produkter der importeres til Clerk:

app->code->community->Clerk->Clerk->Model->Productpage.php

Funktionen load($page,$limit) er ansvarlig for at styre collection af produkter, der sendes til Clerk.

Som standard importeres kun produkter med visibility: both (Catalog, Search), som også er på lager.

Du kan ændre produktkollektionen i load($page,$limit). Hvis du inkluderer produkter, der ikke kan sælges eller ikke er synlige, tilføj en attribut til at identificere dem i Clerk.io.

Hvis du ændrer produkterne, der importeres af Clerk, anbefaler vi stærkt, at du også tilføjer en ekstra attribut, som indikerer, når et produkt ikke kan sælges eller ikke er synligt, så du kan vise det i dit Design og filtrere på det.

Hvis du fx opretter en attribut, der hedder is_saleable, som enten er true eller false, kan du bruge den på denne måde i Designs:

{% if product.is_saleable %}
   <div class="in-stock">In Stock</div>
{% else %}
  <div class="not-in-stock">Not In Stock</div>
{% endif %}

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

Tilpasning af produktdata #

I Magento 1 kan du tilføje custom product attributes via Magento-backenden, eller gennem Clerk-udvidelsen i kode, hvis det er nødvendigt.

Tilføjelse af simple attributter #

Bemærk: Denne funktion virker kun fra v.4.2.3.

Hvis de attributter, du vil sende, allerede er tilgængelige som simple attributter i din Magento admin, kan de nemt tilføjes på Extensionsiden.

  1. I din Magento-backend, start med at gå til Catalog -> Attributes -> Manage Attributes

  2. Find attribute codes for de attributter, du vil tilføje:

  3. Gå til System -> Configuration

  4. Under Clerk -> Settings indtast dine attributter i Additional Fields og klik på Save Config:

  5. Efter at du har implementeret dine attributter, gå til my.clerk.io->Data og klik på Start New Data Sync øverst til højre.

Hvis de attributter, du vil sende, allerede er tilgængelige som en del af dine configurable/grouped products-data i Magento admin, kan de nemt blive synkroniseret på den nyeste version af dit plugin.

De vil fremgå som child_attribute, for eksempel child_color, child_skus osv.

Tilføjelse af attributter via kode #

Hvis din attribut bruger en standard Magento-funktion, kan dette implementeres direkte i Product.php:

app->code->community->Clerk->Clerk->code->Model->Catalog->Product.php

Funktionen getClerkExportData() bygger produktobjektet og dets attributter.

Du kan dernæst tilføje nye attributter i listen med denne syntaks:

$data->setAttributeName($this->insertMagentoLogic());

hvor setAttributeName definerer navnet, du ønsker, det skal have i Clerk, og insertMagentoLogic(); bruger en Magento-logik til at trække værdien fra produktet.

Brug af custom attributfunktioner #

Nogle gange kræver en Magento-attribut en mere avanceret logik end en simpel funktion.

I dette tilfælde skal du finde denne fil:

app->code->community->Clerk->Clerk->Model->Catalog->Productbase.php

I Productbase.php kan du skrive avancerede PHP-funktioner til at loade specialattributter.

Efter du har defineret en funktion, kan du inkludere den i Product.php præcis som de eksisterende funktioner.

For eksempel:

$data->setAge($this->getAge());

Efter at have implementeret dine attributter, skal du gå til my.clerk.io->Data og klikke på Start New Data Sync øverst til højre.

Ændring af udvidelsen #

Tilføjelse/ændring af produktdata #

Hvis du vil tilføje ekstra attributter eller ændre eksisterende for dine produkter, skal du finde disse filer:

app->code->community->Clerk->Clerk->Model->Catalog->Product.php

app->code->community->Clerk->Clerk->Model->Catalog->Productpage.php

Product.php bygger produktmodellen og lader dig tilføje simple attributter.

Productpage.php lader dig oprette avancerede logikker til at hente attributter og bruge dem i Product.php.

Ændring af kategoridata #

Måske har du brug for at omstrukturere kategorinavne eller fjerne specifikke kategorier fra Clerk.

I disse tilfælde skal du finde denne fil:

app->code->community->Clerk->Clerk->Model->Catalog->Product.php

Denne fil håndterer hvilke kategorier, der inkluderes, samt data id, name, URL og subcategories for hver kategori.

Du kan ikke tilføje ekstra data til hver kategori, men du kan ændre, hvad der bliver sendt.

Styling af powerstep #

Powerstep har en standard styling, men du ønsker måske at ændre den, så den matcher dit design.

Disse filer bruges til styling:

app->design->frontend->base->default->template->clerk->powerpage.phtml

app->design->frontend->base->default->template->clerk->powerpopup.phtml

skin->frontend->base->default->clerk->style.css

powerpage.phtml indeholder HTML for page, mens powerpopup.phtml er for popup.

style.css indeholder CSS for alle dele af Clerk-udvidelsen, inklusiv Powerstep.

Du kan bruge disse filer til at tilpasse udseendet af Powerstep.

Ændring af søgesiden #

Hvis du ønsker at ændre layoutet på Search Page, tilføje en slider til no-results-siden osv., skal du finde denne fil:

app->design->frontend->base->default->template->clerk->powerpage.phtml

Dette lader dig ændre søge embedcode og andre dele af søgesiden.

Ændring af live-search-titler #

Titlerne, der vises i Live-Search for produkter og kategorier, kan ændres i denne fil:

app->design->frontend->base->default->template->clerk->livesearch.phtml

Oversæt Categories og Products labels til den ønskede ordlyd, og gem derefter filen.

Gruppeprodukter som varianter #

Som standard bruger Magento Configurable Products til at håndtere hovedprodukter og varianter.

Clerk-udvidelsen er lavet til at understøtte dette, da det er best-practice for Magento.

Hvis du dog har opsat dine Variants ved at bruge Grouped Products, vil din salgssporing ikke virke, da du vil spore ID’s på produkter, som Clerk ikke har importeret fra din Magento-webshop.

Det skyldes, at Variants typisk ikke er synlige.

Clerk.io kan ikke kæde en købt variant med dens hovedprodukt, hvis varianten ikke er importeret.

For Clerk er det normalt ligegyldigt hvilken variant der købes, så længe det " main" produkt, den tilhører, spores.

For at løse dette skal du ændre 2 filer i udvidelsen, så det matcher din opsætning.

Salgssporingen #

Filen, der genererer salgssporingsdata, er denne:

app->code->Block->SalesTracking.php

I SalesTracking.php, find koden, der henter det købte produkt ID (typisk omkring linje 65).

Dette skal ændres, så uanset hvilken grouped product variant der er købt, er det altid ID’et på “main” produktet, der sendes.

De importerede ordrer #

Samme proces skal udføres for de tidligere ordrer, der importeres, så vi ved, hvilke “main” produkter, der tidligere er købt.

Denne fil håndterer det:

app->code->Model->Orderpage.php

I orderFormatter($order), find hvor Magento sender produkt ID’et (typisk omkring linje 44).

Ændr dette til samme logik som salgssporingen.

Tjek om dine ændringer virker #

Gå til my.clerk.io > Data og klik på Start New Data Sync for at importere de opdaterede data.

Foretag derefter en testordre, hvor du køber et produkt med varianter.

Gå bagefter til Orders og åbn den ordre, du lige har lagt.

Hvis ordren viser Main produkterne med deres navne og billeder, fungerer sporingsændringen.

Denne side er oversat af en hjælpsom AI, og der kan derfor være sproglige fejl. Tak for forståelsen.