Extension

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

Installation med toolbox #

Clerk Toolbox Script er udviklet til 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 downloade den fra internettet; - Windows: Kommandoprompt, den er allerede installeret på din computer.

Scriptet opretter 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, adgangskode og domæne.

Naviger til mappen #

1. Start med at logge ind på din Magento-server gennem en terminal, ved at bruge dit brugernavn og domæne som her:

ssh Stefan@mywebshop.com

2. Du bliver bedt om at indtaste adgangskoden til din bruger (terminalen giver ingen feedback, mens du indtaster adgangskoden, men den registrerer den 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 mappelisten skal du lede efter den rigtige mappe, i dette tilfælde ville det være magento1.

Nu skal du blot gå ind i mappen ved at skrive:

cd NAME_FOLDER

NAME_FOLDER erstattes med det faktiske navn på mappen.

Installer udvidelsen #

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. Skriv herefter denne linje for at se en liste over de tilgængelige muligheder i Toolbox:

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 versionen, du vil installere:

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

4. Du bliver nu bedt om at indtaste din adgangskode. Efter at have gjort dette, laver scriptet backup af din Magento1-mappe og påbegynder installationen af udvidelsen:

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

Valgfrie kommandoer #

Afinstallation Toolbox giver dig også mulighed for at afinstallere udvidelsen. Du kan gøre det med denne linje:

sudo sh clerk_toolbox_magento.sh -u

I nogle tilfælde, hvis filer er beskadigede eller mangler, kan du foretage en tvungen afinstallation således:

sudo sh clerk_toolbox_magento.sh -u --force

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

Brug denne linje til dette:

sudo sh clerk_toolbox_magento.sh -r

Backup Når udvidelsen installeres, 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 venstre menu, 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, tilgås via din Magento 1 Admin portal, nedenfor.

Ordrehistorik #

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

Sidestørrelse #

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

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

Server-timeout #

Indstil den tid uden respons, før serveren får timeout, både for at beskytte dine data og for at sikre, at der er tid nok til, at større datasæt kan synkroniseres med Clerk.

Standard er 60 sekunder.

Data-parsing #

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

Automatisk parsing er standard og anbefalet.

Synkroniseringstidspunkt #

Indstil tidspunktet på dagen, hvor du vil have dine butiksdata til at synkronisere med Clerk.

Standard er “efter behov”.

Udvidelsesindstillinger #

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

• Via Magento-backend i Clerk > Configuration > Settings

• Via my.clerk.io, under Developers > Extensions

Det er underordnet, hvor du foretager ændringer, da udvidelsen synkroniserer med ændringer 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” ud for enhver indstilling for at se de tilgængelige muligheder:

Oversigt over udvidelse #

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

Clerk-indstillinger #

Indstil nøgleparametre under Clerk Settings-sektionen i Magento 1-udvidelsen.

Her kan du aktivere/deaktivere Clerk-udvidelsen samt finde dine public og private API keys.

• Real-time Updates:

  • Additional Fields

• Inkluder Sider

  • Additional Fields

• Indsaml Emails og Kundekurve:

• Deaktiver Ordresynkronisering:

• Inkluder Udsolgte Produkter

• Sprog & Import URL: Disse blev sandsynligvis sat, da du først installerede Clerk-udvidelsen og synkroniserede til my.clerk.io. Hvis værdierne ændres, vælg blot nyt butikssprog eller indsæt den opdaterede Import URL her.

Indstillinger for search #

For at aktivere din Clerk Search Page, Search Page Facets og/eller Live Search, vælg “Yes” i de relevante dropdowns.

Search Page Settings:

• Ved valg af “Yes” dukker muligheder op for at indtaste dit Search Page Content-navn, som matcher data-template-feltet i embed-koden til dit Content i my.clerk.io. I dette eksempel search-page.

• Du kan også indstille teksten til “Load More"-knappen her, samt teksten, der vises, når der ikke findes resultater for en forespørgsel.

Faceted Search Settings:

• Efter at have aktiveret facetteret search, får du mulighed for at indtaste attributter, du ønsker skal vises som facetter på din Search Page.

Du kan også navngive disse facetter efter ønske og vælge rækkefølgen, hvori hver facet vises.

Tilpasning af facetter #

Clerk giver dig mulighed for at style dine search-sidefacetter direkte fra designet, og du kan vise dem ved at referere til design-ID-feltet.

Design-ID’en kan findes i Clerk-backenden, på yderste venstre kolonne af hvert design på designoversigtssiden og nederst til venstre på siden når du åbner designet for redigering.

Bemærk: Du kan nu kalde data for kategorier og sider i din Search page på samme måde som i Live Search, hvilket giver dig et større informationsområde for at engagere dine kunder. Læs mere her.

Live Search Settings

• Når du har slået Live Search til, kan du vælge, om du vil have Categories vist i resultaterne, samt antallet af søge-forslag, kategorier og indholdsresultater der skal vises i Live Search.

  • Du kan også vælge, hvilke sider-typer, der vises som search-resultater, f.eks. “CMS Pages” eller “Blog Posts”.

  • Du kan vælge positionen af dropdown-menuen fra din søgeboks med Dropdown Positioning.

• Angiv Content-navnet for din live search, som kan findes ud for data-template i embed-koden for din Live Search i my.clerk.io Content. Typisk live-search.

• Til sidst skal du angive din Live Search Input Selector, som du kan finde ved at inspicere din webshops søgeboks med din browser og identificere det ID eller den klasse, der er tilknyttet inputfeltet. I dette eksempel #search.

Indstillinger for recommendations #

Ligesom search, aktiver din Clerk Powerstep, Exit Intent, Category Page, Product Page og Cart-indstillinger ved at vælge “Yes” i de relevante dropdowns.

Når du vælger “Yes” i den relevante dropdown, får du et felt, hvor du kan indtaste Element name for Clerk Recommendations, du vil inkludere på siden.

• Ligesom for search-funktionerne, kan du finde elementnavnet ved siden af data-template i embed-koden i my.clerk.io > Recommendations > Elements. I dette eksempel har vi aktiveret Category Page-indstillinger og inkluderet category-page-popular som vores element.

• Du kan tilføje flere elementnavne adskilt med komma, hvis du f.eks. vil vise flere elementer på siden.

Logging #

Logging-indstillingerne omfatter:

Logging-niveau

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

• Fejl + Advarsel: Logger også advarsler, der ikke får modulet til at stoppe, men som måske også bør løses.

• Fejl + Advarsel + Debug: Logger alt, hvad modulet interagerer med. Dette bør ikke aktiveres på en live-webshop, da det vil gøre siden langsommere.

Logging til

• Fil: Gemmer logen i en fil på Magento-serveren.

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

Oversættelse af tekster #

Clerk til Magento extension leveres med oversættelser til dansk, engelsk, hollandsk og italiensk.

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

Dette gøres ved at gå til denne mappe i FTP:

app->locale

Start med at gå til den danske mappe kaldet 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 downloade den nyeste udvidelse her:

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 taget backup af eventuelle ændrede filer, som du kan overføre til den nye udvidelse.

Normalt er de filer, som de fleste udviklere ændrer, Product.php og Productbase.php, der styrer product attributes.

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 følgende:

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

2. Herefter afinstalleres den enten via Magento Connect eller ved at slette filerne fra FTP, hvis du har installeret den direkte her.

Ellers kan din Configuration-side stoppe med at virke, og ingen af udvidelserne virker bagefter.

Installer seneste version #

Installer derefter den nyeste udvidelse igen, og flyt eventuelle backuppede filer til din FTP-server.

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

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

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

Afinstallation #

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

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

På den næste side finder du " Clerk" i venstre menu, og vælger " Settings".

Her vises “Clerk Settings”. Ud for " Enable" vælger du " No" i dropdown-menuen for at deaktivere Clerk-udvidelsen.

Hvis du har implementeret Clerk med 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 Clerk-elementer direkte via dine FTP-filer, skal du huske at fjerne de relevante embed-koder fra disse filer.