Extension

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

Installation med toolbox #

Clerk Toolbox Script er udviklet for nemt at installere Clerk udvidelsen i din Magento webshop uden at bruge Magento Connect.

Toolbox Scriptet køres direkte fra en terminal.

Vi anbefaler disse: - Apple: iTerm, som skal downloades fra internettet; - Windows: Kommandoprompt, som allerede er 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, inklusive dit Brugernavn, Adgangskode og Domæne.

Navigere til mappen #

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

ssh Stefan@mywebshop.com

2. Du bliver bedt om at indtaste adgangskoden til din bruger (terminalen viser ingen feedback, mens du skriver adgangskoden, men den bliver registreret alligevel).

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

cd /var/www/html

og skrive:

ls

Kommandoen ls viser mapper, så du kan finde din Magento root-mappe.

I listen over mapper, kig efter den rigtige mappe, i dette tilfælde ville det være magento1.

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

cd NAME_FOLDER

NAME_FOLDER erstattes med det rigtige navn på mappen.

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

sh clerk_toolbox_magento.sh

3. Da du ønsker at installere udvidelsen, skal du bruge -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 din adgangskode. Når du har gjort det, tager scriptet backup af din Magento1-mappe og begynder installationen af udvidelsen:

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

Valgfrie kommandoer #

Afinstallation Toolbox tillader også, at du afinstallerer udvidelsen. Du kan gøre det med denne linje:

sudo sh clerk_toolbox_magento.sh -u

I nogle tilfælde, hvis filer er korrupte eller mangler, kan du udføre en tvangs-afinstallation sådan her:

sudo sh clerk_toolbox_magento.sh -u --force

Gendannelse Hvis noget går galt i din webshop, kan du altid gendanne den via backupen, der er taget ved installation af udvidelsen.

Brug denne linje for at gøre det:

sudo sh clerk_toolbox_magento.sh -r

Backup Ved installation af udvidelsen vil scriptet altid først lave en backup, men du kan også tage 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.

Indstillingerne nedenfor er tilgængelige i Magento 1 Extension gennem dit Magento 1 admin portal.

Ordrehistorik #

Vælg hvor lang tid du ønsker at synkronisere ordredatak retroaktivt fra din butik til Clerk her.

Sidestørrelse #

Vælg sidestørrelsen af 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 svar, før serveren timeout’er, både for at beskytte dine data og sikre, at der gives nok tid til større datasæt til at synkronisere med Clerk.

Standard er 60 sekunder.

Data parsing #

Vælg om du ønsker at din Magento 1-data skal parse værdier automatisk i dette afsnit.

Automatisk parsing er standard og anbefalet mulighed.

Synkroniseringstid #

Indstil tidspunktet på dagen, hvor du ønsker at din butiksdata skal synkroniseres med Clerk.

Standard er “når det er nødvendigt”.

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 backend i Clerk > Configuration > Settings

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

Det er ligegyldigt, hvor du foretager ændringerne, da udvidelsen synkroniserer alle ændringer, der laves i my.clerk.io, og omvendt.

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

Klik på Edit ud for en indstilling for at se de tilgængelige muligheder.

Udvidelsesoversigt #

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.

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

• Real-time opdateringer:

  • Ekstra felter

• Medtag sider

  • Ekstra felter

• Indsamling af e-mails og kundekurve:

• Sync Subscribers: Importerer nyhedsbrevstilstandsstatus til brug i Clerk.io email audiences.

• Deaktiver ordre-synkronisering:

• Medtag produkter, der ikke er på lager

• Kun synkroniser produkt med synlighed: Begrænser produkt-feed til produkter med de valgte Magento synlighedsværdier.

• Aktiver returfølge: Sender returnerede varer til Clerk.io, når Magento registrerer en returnering.

• Brugerdefineret billede bredde/højde: Indstiller dimensionerne for billeder sendt i produkt-feedet. Efterlad begge tomme for at bruge udvidelsens standard på 210 pixels.

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

Search indstillinger #

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

Search Page Settings:

• Når du vælger Yes, indtast navnet på Search Page-elementet fra embed-kodens data-template-felt. Brug eksempelvis search-page, hvis det er navnet på dit element.

• Her kan du også angive teksten til “Load More"-knappen samt teksten, der vises, når ingen resultater er fundet for en søgning.

• Vis kategorier, Antal kategorier, Antal sider og Sidetype styrer de ikke-produktresultater, der vises på Search Page.

Faceted Search Settings:

• Når facetteret søgning er aktiveret, 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 med de ønskede navne og vælge rækkefølgen for, hvordan facetterne vises.

Brug Multiselect Attributes for at lade besøgende vælge mere end én værdi i en facet ad gangen.

Tilpasning af facetter #

Clerk giver dig mulighed for at style dine søgeside-facetter direkte inde fra designet, og du kan vise dette ved at referere til design ID-feltet.

Design ID’et kan findes i Clerk backend, på yderste venstre kolonne i hvert design på designoversigtssiden og nederst til venstre på siden, når du redigerer designet.

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

Live Search Settings

• Når du aktiverer Live Search, kan du vælge, om du vil have Kategorier vist i dine resultater, samt hvor mange forslag, kategorier og indhold der vises i Live Search.

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

  • Du kan vælge hvor dropdown-menuen for live search placeres i forhold til din søgeboks med Dropdown Positioning.

• Angiv navnet på elementet til din live search, som findes ved siden af data-template i din Live Search embed-kode i dit my.clerk.io Element. Dette er sandsynligvis live-search.

• Giv Live Search Input Selector ved at inspicere din webshops søgeboks og identificere dens input-ID eller klasse. For et input med ID search, brug #search.

• Form Selector er selector for søgeformularen. Brug den, hvis dit tema benytter en brugerdefineret form, og den normale søgeredirektion ikke fungerer korrekt.

Recommendations indstillinger #

Ligesom for Search, kan du aktivere dine Clerk Powerstep, Exit Intent, Category Page, Product Page og Cart-indstillinger ved at vælge “Yes” i de relevante dropdown-menuer.

Når du har valgt “Yes” i den relevante dropdown, får du en boks til at indtaste navnet på det Clerk Recommendations-element, du ønsker vist på den side.

• Find elementnavnet i embed-kodens data-template-felt under Recommendations > Elements i my.clerk.io. Indtast f.eks. category-page-popular i Category Page-indstillinger, hvis det er navnet på dit element.

• Du kan tilføje flere elementnavne som kommaseparerede værdier her, hvis du ønsker at vise flere elementer på samme side.

• Filter Duplicates er tilgængelig for Powerstep, Category Page, Product Page og Cart-indstillinger. Aktiver den for at undgå at vise samme produkt i flere recommendation-slidere på siden.

Logging #

Logging-indstillingerne omfatter:

Logging Level

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

• Fejl + advarsel: Logger også advarsler, der ikke forårsager, at modulet stopper, men som kan være nødvendige at rette.

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

Logging til

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

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

Angiv Enable til Yes, før logging bruges. Når du logger til en fil, bruger udvidelsen stien til log-filen vist i konfigurationen. Debug Mode åbner udvidelsens debugging-vejledning.

Oversættelse af tekster #

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

Du kan let tilføje en oversættelse for dit sprog, så frontend-delen 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 kaldet da_DA og kopier filen Clerk_Clerk.csv.

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

Oversæt teksten i højre kolonne af CSV-filen og gem derefter.

Opgradering #

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

Du kan downloade den nyeste udvidelse via dette link:

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

Gem ændringer #

Før du forsøger at opgradere, skal du sørge for enten:

• At du har gemt de ændrede filer lokalt på din FTP, eller

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

Ofte er de filer, som flest udviklere ændrer, Product.php og Productbase.php, som styrer produktattributter.

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 #

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

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

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

Ellers kan din Configuration-side holde op med at fungere, og ingen af udvidelserne vil virke bagefter.

Installer seneste version #

Til sidst skal du installere den seneste udvidelse igen og flytte eventuelle backup-filer til din FTP-server.

Din konfiguration skulle gerne forblive gemt, selv når du installerer den nye version.

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" i topmenuen.

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

Her vil du se “Clerk Settings” vises. Ud for " Enable" vælger du " No" i drop-down-menuen for ikke længere at aktivere Clerk-udvidelsen.

Hvis du har implementeret Clerk.io gennem udvidelsen, kan du også deaktivere individuelle moduler ved at sætte relevante Search og Recommendations dropdowns til No.

Hvis du har installeret nogle Clerk-elementer direkte via dine FTP-filer, så husk at fjerne de relevante embed-koder fra disse filer.