Extension

Konfigurer dine Magento 1-udvidelsesindstillinger, administrer data-synkroniseringsmuligheder og tilpas search-, recommendations- og logningsfunktioner. Denne vejledning dækker også installation via Toolbox Script, opgradering og afinstallation.

Installation med toolbox #

Clerk Toolbox Script er udviklet for at gøre det nemt at installere Clerk-udvidelsen i din Magento-webshop uden at bruge Magento Connect.

Toolbox Scriptet køres direkte fra en terminal.

Vi foreslår disse: - Apple: iTerm, du skal hente det fra internettet; - Windows: Kommandoprompt, det er allerede installeret på din computer.

Scriptet laver også en backup af Magento-mappen så den kan gendannes, hvis noget går galt.

Hvad du skal bruge #

For at installere det, skal du have SSH- eller SFTP-adgang til din webshop, inklusiv dit Brugernavn, Password og Domæne.

Navigere til mappe #

1. Start med at logge ind på din Magento-server gennem en terminal ved at bruge dit Brugernavn og Domæne sådan her:

ssh Stefan@mywebshop.com

2. Du bliver bedt om at indtaste password for din Bruger (terminalen viser ingen tegn, mens du skriver password, men den registrerer det alligevel).

3. Naviger til root-mappen for Magento. Ofte kan du gøre dette ved at skrive:

cd /var/www/html

og skrive:

ls

Dette giver dig en liste over mapper, så du kan finde den rigtige:

I listen over mapper skal du finde den rette mappe, i dette tilfælde vil det være magento1.

På dette tidspunkt skal du ind i mappen, det gør du ved at skrive:

cd NAME_FOLDER

NAME_FOLDER erstattes med mappens rigtige navn.

Installation af udvidelse #

1. Når du er i din Root Folder, skal du downloade Toolbox Scriptet med denne linje:

sudo wget https://raw.githubusercontent.com/clerkio/clerk-magento/master/clerk_toolbox_magento.sh

2. Herefter skal du skrive denne linje for at se en liste over de tilgængelige muligheder i Toolboxen:

sh clerk_toolbox_magento.sh

3. Da du vil installere udvidelsen, bruger du -i sammen med versionen. Skriv denne linje, hvor x.x.x er den version, du vil installere:

sudo sh clerk_toolbox_magento.sh -i x.x.x

4. Du bliver nu bedt om at indtaste dit password. Efter dette tager scriptet backup af din Magento1-mappe og starter installationen af udvidelsen:

5. Færdig! Nu er udvidelsen installeret, og du kan konfigurere den i din Magento1-backend.

Valgfrie kommandoer #

Afinstallation Toolboxen giver dig også mulighed for at afinstallere udvidelsen. Det gør du med denne linje:

sudo sh clerk_toolbox_magento.sh -u

I nogle tilfælde, hvor filer er blevet ødelagt eller mangler, kan du foretage en force uninstall sådan her:

sudo sh clerk_toolbox_magento.sh -u --force

Gendannelse Hvis noget går galt i din webshop, kan du altid gendanne gennem den backup, der blev lavet under installationen af udvidelsen.

Brug denne linje for at gøre det:

sudo sh clerk_toolbox_magento.sh -r

Backup Når du installerer udvidelsen, laver scriptet altid først en backup, men du kan også lave backup separat med denne linje:

sudo sh clerk_toolbox_magento.sh -b

my.clerk.io indstillinger #

For at få adgang til dine synkroniseringsindstillinger mellem Clerk og din Magento 1-udvidelse, gå til my.clerk.io, klik på “Data” i menuen til venstre, og gå derefter til “Configuration”.

Her finder du muligheder for at tilpasse, hvordan dine produkt-, kunde- og ordredata synkroniseres med Clerk.

Mere information om Magento 1 Extension, som du får adgang til gennem din Magento 1 Admin portal, nedenfor.

Ordrehistorik #

Vælg, hvor lang tid tilbage du vil synkronisere ordredata fra din butik til Clerk her.

Sidestørrelse #

Vælg sidestørrelsen på dine synkroniserede data i dropdown-menuen nedenfor.

Mindre sidestørrelse kan hjælpe med at undgå host timeouts under synkronisering, mens større sidestørrelser kan gøre synkronisering hurtigere.

Server timeout #

Angiv hvor lang tid uden svar før serveren timeout’er – både for at beskytte dine data og sikre, at du har givet nok tid til større datasæt kan synkronisere med Clerk.

Standard er 60 sekunder.

Data parsing #

Vælg om du vil have dine Magento 1-data til at parse værdier automatisk i dette afsnit.

Automatisk parsing er standard og anbefalet valg.

Synkroniseringstidspunkt #

Angiv tidspunkt for, hvornår du vil have dine butikkens data til at synkronisere med Clerk.

Standard er “when needed”.

Udvidelsesindstillinger #

Hvis du bruger v4.8.0 eller en nyere version af udvidelsen, kan du få adgang til nedenstående indstillinger på to måder, efter du har tilføjet dine Public og Private Keys til udvidelsen:

• Gennem Magento-backenden i Clerk > Configuration > Settings

• Gennem my.clerk.io under Developers > Extensions

Det er ligegyldigt hvor du foretager ændringerne, da udvidelsen synkroniserer med ændringerne i my.clerk.io og omvendt.

I my.clerk.io kan du også se din nuværende version af udvidelsen, din platform og PHP-versionen.

Klik blot på “Edit” på en hvilken som helst indstilling for at se de tilgængelige muligheder:

Udvidelsesoversigt #

For at få adgang til din Magento 1 Clerk-udvidelse, log ind i din butiks Admin-konto, og vælg “Configuration” > “Clerk” > “Settings”.

Clerk-indstillinger #

Angiv nøgleparametre i Clerk Settings-sektionen af Magento 1-udvidelsen.

Muligheden for at aktivere/deaktivere Clerk-udvidelsen samt dine public og private API-nøgler findes også her.

• Real-time opdateringer:

  • Additional Fields

• Inkluder sider

  • Additional Fields

• Indsaml Emails og kundekurve:

• Deaktiver ordre-synkronisering:

• Inkluder udsolgte produkter

• Sprog & Import URL: Disse blev sandsynligvis sat, da du først installerede Clerk-udvidelsen og synkroniserede til my.clerk.io. Hvis disse værdier ændrer sig, skal du blot vælge det nye butikssprog eller indsætte den opdaterede Import URL her.

Søgeindstillinger #

For at aktivere din Clerk Search Page, Search Page Facets og/eller Live Search, vælg “Yes” fra den relevante dropdown-menu.

Search Page Settings:

• Efter valg af “Yes” kommer der muligheder frem, hvor du kan skrive navnet på Search Page Elementet, som matcher data-template-feltet i embed-koden på dit Element i my.clerk.io. I dette eksempel, search-page.

• Du kan også angive teksten til knappen " Load More" her, samt teksten der vises, når ingen resultater findes for en søgning.

Faceted Search Settings:

• Efter aktivering af faceted search får du mulighed for at indtaste de attributter, du ønsker skal vises som facetter på din Search Page.

Du kan også navngive disse facetter og vælge rækkefølgen, de skal vises i.

Tilpasning af facetter #

Clerk giver dig mulighed for at style dine search page-facetter direkte fra designet, og du kan vise dette ved at henvise til det med design ID-feltet.

Design ID’et kan findes i Clerk backend, i helt venstre kolonne af hvert design på design oversigts-siden samt i nederste venstre hjørne af siden, når du redigerer designet.

Bemærk: Du kan nu kalde data for kategorier og sider i din Search page på samme måde som du gør i Live search, hvilket giver dig flere informationer at engagere dine kunder med. For mere information kan du tjekke her.

Live Search Settings

• Efter aktivering af Live Search kan du vælge, om du vil vise Categories i dine resultater, samt antallet af suggestions, categories, og content resultater, der vises i Live Search.

  • Du har også mulighed for at vælge hvilke side-typer der vises som søgeresultater, f.eks. “CMS Pages” eller “Blog Posts”.

  • Du kan vælge positionen på live search-dropdown fra din søgefelt med Dropdown Positioning.

• Find Element-navnet til din live search næste gang; det kan findes ved siden af data-template i din Live Search embed kode i din my.clerk.io Element. Det er sandsynligvis live-search.

• Til sidst skal du angive din Live Search Input Selector, som du finder ved at inspicere din webshops søgefelt i din browser, og identificere ID’et eller klassen for inputtet. I dette eksempel, #search.

Recommendations-indstillinger #

På samme måde som med Search, skal du aktivere dine Clerk Powerstep, Exit Intent, Category Page, Product Page og Cart-indstillinger ved at vælge “Yes” i de relevante dropdowns.

Når du har valgt “Yes” i den relevante dropdown, får du et felt, hvor du kan angive Element-navnet for de Clerk Recommendations, du ønsker inkluderet på siden.

• Ligesom med Search-funktionerne, finder du element-navnet ved siden af data-template i embed-koden i my.clerk.io > Recommendations > Elements. I dette eksempel har vi aktiveret Category Page og inkluderet category-page-popular som vores element.

• Du kan tilføje flere element-navne som kommaseparerede værdier her, hvis du vil vise flere elementer på siden.

Logning #

Logningsindstillingerne inkluderer:

Logging Level

• Kun fejl: Logger fejl, der forhindrer modulet i at fungere korrekt.

• Fejl + Advarsel: Logger også advarsler, der ikke får modulet til at stoppe, men som kan være væsentlige at løse.

• Fejl + Advarsel + Debug: Logger alt, som modulet interagerer med. Dette bør ikke aktiveres på et live-shop, da det vil sænke hastigheden.

Logging til

• Fil: Gemmer loggen som en fil på Magento-serveren.

• my.clerk.io: Logger alt til Developers->Logs i my.clerk.io backend.

Oversættelse af tekster #

Clerk for Magento-udvidelsen indeholder indbyggede oversættelser for dansk, engelsk, hollandsk og italiensk.

Du kan nemt tilføje en oversættelse til dit sprog, så frontend-delene vises korrekt.

For at gøre dette skal du gå til denne mappe i FTP:

app->locale

Start med at gå til den danske mappe da_DA og kopier filen Clerk_Clerk.csv.

Find mappen for dit sprog (i Magento locale-mappen), og indsæt filen her.

Nu kan du oversætte teksterne til dit sprog i højre side af CSV-filen:

Opgradering #

Denne guide viser dig, hvordan du opgraderer fra tidligere versioner af vores udvidelse til den nyeste.

Du kan hente den nyeste udvidelse fra dette link:

https://github.com/clerkio/clerk-magento/releases/latest

Gem ændringer #

Inden du forsøger at opgradere, sørg for at du enten:

• Har gemt de ændrede filer lokalt på din FTP eller

• Har lavet en backup af de ændrede filer, så du kan overføre dem til den nye udvidelse.

Typisk er det filerne, som de fleste udviklere ændrer, Product.php og Productbase.php, der styrer produkt-attributter.

Disse filer findes her:

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

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

Deaktiver og afinstaller #

Før du forsøger at opgradere, er det meget vigtigt, at du gør dette:

1. Deaktiver den gamle udvidelse i Magento under System->Configuration->Clerk->Settings-siden. Sæt blot Enable til No og klik Save Config.

2. Herefter , afinstaller enten gennem Magento Connect eller ved at slette filerne via FTP hvis du installerede dem direkte her.

Ellers kan det ske, at din Configuration-side holder op med at virke, og ingen af udvidelserne fungerer bagefter.

Installer nyeste version #

Til sidst installeres den nyeste udvidelse igen, og du flytter eventuelle backup-filer til din FTP server.

Din konfiguration bør være gemt, også når den nye version installeres.

Tjek System->Configuration->Clerk for at sikre, at alt stadig er der.

Nu har du den nyeste version af Clerk til Magento installeret!

Afinstallation #

For at fjerne Clerk fra din Magento 1 butik skal du deaktivere udvidelsen i din Magento 1 admin-portal.

Log ind på din webshops Magento 1 portal, og vælg derefter “System” > “Configuration” fra topmenuen.

På næste side finder du “Clerk” i menuen til venstre og vælger “Settings”.

Her ser du “Clerk Settings” vises. Ved siden af “Enable” vælg “No” i dropdown-menuen for at deaktivere Clerk-udvidelsen.

Hvis du har implementeret Clerk via udvidelsen, kan du også deaktivere de enkelte moduler ved ligeledes at vælge “No” i de relevante Search- og Recommendations-dropdowns i dette afsnit:

Hvis du har installeret nogen elementer af Clerk direkte gennem dine FTP-filer, skal du huske at fjerne de relevante embed-koder fra disse filer.