Sync Data

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.

Deaktiver ordresynkronisering #

Efter den første data-synkronisering er kørt med succes, kan ordresynkronisering fra Magento1 deaktiveres, da salgs-sporingen fra udvidelsen overtager.

For at deaktivere ordresynkronisering, gå ind i din Magento1-backend, vælg SYSTEM i menulinjen og tryk KONFIGURATION:

Vælg hovedsite (den side, du forsøger at påvirke) under NUVÆRENDE KONFIGURATIONSOMRÅDE:

Herefter klik på INDSTILLINGER under CLERK-fanen i venstre sidebjælke, og ændr feltet ved siden af DISABLE ORDER SYNCHRONIZATION fra NEJ til JA.

Tryk GEM KONFIG for at få ændringerne til at træde i kraft 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 styrer variablerne $imageHeight og $imageWidth højden og bredden af hvert billede:

Ændr disse værdier til den størrelse, du ønsker billederne skal have, og gem filen.

Herefter gå til my.clerk.io -> Data og kør en ny synkronisering ved at klikke på Start Synkronisering.

Dine nye billeder vil nu blive synkroniseret.

Valg af produkter til import #

Visning af udsolgte produkter #

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

Start med at gå til:

System -> Konfiguration -> CLERK -> Indstillinger

Vælg din Butiksvisning i venstre menu, og gå til Clerk Indstillinger.

I dette afsnit sætter du Include Out Of Stock Products til Ja og klikker Gem Konfig:

Til sidst gå til my.clerk.io -> Data og klik på Start Ny Data-Synkronisering for at importere alle produkter, herunder dem der er udsolgte.

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 samlingen af produkter, der sendes til Clerk.

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

Dette kan ændres på de to følgende steder:

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

Forudsat at du opretter en attribut kaldet is_saleable, som enten er true eller false, kan du bruge den sådan i Designs:

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

Til sidst gå til my.clerk.io -> Data og klik på Start Ny Data-Synkronisering for at importere dine nye data.

Tilpasning af produktdata #

I Magento 1 kan du tilføje tilpassede produktattributter gennem Magento-backend’en, eller gennem Clerk-udvidelsen i kode, hvis nødvendigt.

Tilføjelse af simple attributter #

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

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

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

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

3. Gå til System -> Konfiguration

4. Under Clerk -> Indstillinger skriv dine attributter i Additional Fields og klik Gem Konfig:

5. Efter implementering af dine attributter, gå til my.clerk.io->Data og klik Start Ny Data-Synkronisering i øverste højre hjørne.

Hvis de attributter, du vil sende, allerede er tilgængelige som en del af dine konfigurerbare/grupperede produkter data i din Magento admin, kan de nemt synkroniseres i den nyeste version af dit plugin.

De vil fremgå som child_attribute, f.eks. child_color, child_skus osv.

Tilføj attributter gennem 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 produkt-objektet, med alle attributterne:

Du kan derefter tilføje nye attributter i listen med denne syntaks:

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

hvor setAttributeName definerer navnet, du vil have det til at have i Clerk, og insertMagentoLogic(); bruger en Magento-logik til at hente en værdi fra produktet.

Brug af tilpassede attributfunktioner #

Nogle gange kan en Magento-attribut kræve 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 tilpassede attributter.

Efter at have defineret en funktion, kan du inkludere den i Product.php ligesom de eksisterende funktioner.

For eksempel:

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

Efter implementering af dine attributter, gå til my.clerk.io->Data og klik Start Ny Data-Synkronisering i øverste højre hjørne.

Modificering af udvidelsen #

Tilføjelse/ændring af produktdata #

Hvis du vil tilføje ekstra attributter eller ændre eksisterende for dine produkter, skulle 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 giver dig mulighed for at tilføje simple attributter.

Productpage.php giver dig mulighed for at oprette avancerede logikker for 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, og dataene id, navn, URL og underkategorier 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 vil måske ændre den, så den passer til dine designs.

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’en til siden, mens powerpopup.phtml er til popup’en.

style.css indeholder CSS’en for alle dele af Clerk-udvidelsen, inklusive Powerstep.

Du kan bruge disse filer til at ændre udseendet af Powerstep.

Ændring af søgesiden #

Hvis du vil ændre layoutet af SØGESIDEN, tilføje en slider til siden uden resultater osv., skal du finde denne fil:

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

Dette giver dig mulighed for at ændre søge-embedkoden og andre dele af søgesiden.

Ændring af Live-søgesøgningstitler #

Titlerne vist i Live-søgningen for produkter og kategorier kan ændres i denne fil:

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

Her oversæt ganske enkelt Categories og Products til det, du ønsker:

Grupperede produkter 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 bedste praksis for Magento.

Dog, hvis du har opsat dine Variants ved hjælp af Grouped Products, vil dit salgs-sporingssystem ikke fungere, da du vil spore ID’er for produkter, som Clerk ikke har importeret fra din Magento webshop.

Dette er fordi Variants normalt ikke er synlige.

Clerk vil ikke være i stand til at se forbindelser mellem produkter, når de ikke importeres:

For Clerk har det normalt ingen betydning hvilken variant der købes, så længe det hovedprodukt, den tilhører, spores.

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

Salgs-sporingen #

Filen, der genererer salgs-sporingsdataene, er denne:

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

I denne fil, normalt omkring linje 65, bruges følgende stykke kode til at få ID-et på det købte produkt:

Dette skal ændres, så uanset hvilken grupperet produktvariant der er købt, sendes altid ID’et på “hoved” produktet.

Importerede ordrer #

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

Denne fil håndterer det:

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

Omkring linje 44, i funktionen orderFormatter($order) sendes produktets ID fra Magento:

Ændr dette til den samme logik som salgs-sporingen.

Check om dine ændringer virker #

Nu, gå til my.clerk.io -> Data og klik Start Ny Data-Synkronisering for at importere de nyeste data:

Fortsæt med at placere en testordre, hvor du køber et produkt, der har varianter.

Herefter går du til Ordrer og åbner den ordre, du netop har afgivet.

Hvis du kan se de Hoved-produkterne i ordren, inklusive deres navn og billede, virker din kode: