Extension
Installation med Toolbox-scriptet #
Clerk.io Toolbox-scriptet er udviklet for at gøre det nemt at installere Clerk.io udvidelsen i din Magento webshop, uden at bruge Magento Connect.
Toolbox-scriptet vil blive kørt direkte fra en terminal. Vi foreslår disse: - Apple: iTerm, du skal downloade det fra internettet; - Windows: Kommandoprompt, det er allerede installeret på din computer.
Scriptet opretter også en sikkerhedskopi af Magento-mappen, så den kan gendannes, hvis noget går galt.
Hvad har jeg brug for? #
For at installere det, har du brug for SSH eller SFTP-adgang til din webshop, inklusive dit Brugernavn, Adgangskode og Domæne.
Navigering til Magento-mappen #
1.1 Start med at logge ind på din Magento-server gennem en terminal, ved at bruge dit Brugernavn og Domæne som dette:
ssh Stefan@mywebshop.com
1.2 Du vil blive bedt om at indtaste adgangskoden til din bruger (terminalen vil ikke give dig nogen feedback, mens du indtaster adgangskoden, men den registrerer det alligevel).
1.3 Naviger til rodmappen af Magento. Ofte kan du gøre dette ved at skrive:
cd /var/www/html
og skrive:
ls
Dette vil give dig en liste over mapper, for at hjælpe dig med at finde den rigtige:

I listen over mapper skal du lede efter den rigtige mappe, i dette tilfælde ville det være magento1. På dette tidspunkt skal du komme ind i mappen, du kan gøre det ved at skrive:
cd NAME_FOLDER
NAME_FOLDER erstattes med det rigtige navn på mappen.
Installation af udvidelse #
2.1. Når du er i din Rodmappe, skal du downloade Toolbox-scriptet med denne linje:
sudo wget https://raw.githubusercontent.com/clerkio/clerk-magento/master/clerk_toolbox_magento.sh
2.2. Derefter skal du skrive denne linje for at se en liste over de tilgængelige muligheder inden for Toolbox:
sh clerk_toolbox_magento.sh

2.3. Da du ønsker at installere udvidelsen, vil du bruge -i sammen med . Skriv denne linje, hvor x.x.x er den version, du ønsker at installere:
sudo sh clerk_toolbox_magento.sh -i x.x.x
2.4. Du vil nu blive bedt om at indtaste din adgangskode. Efter at have gjort dette, vil scriptet sikkerhedskopiere din Magento1-mappe og begynde at installere udvidelsen:

2.5. Færdig! Nu er udvidelsen installeret, og du kan konfigurere den i din Magento1 backend.
Valgfrit #
Afinstallation Toolboxen 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 blevet beskadiget eller mangler, kan du lave en tvungen afinstallation som dette:
sudo sh clerk_toolbox_magento.sh -u --force
Gendannelse Hvis noget går galt i din webshop, kan du altid gendanne den gennem sikkerhedskopien, der laves, når udvidelsen installeres.
Brug denne linje til at gøre det:
sudo sh clerk_toolbox_magento.sh -r
Sikkerhedskopi Når du installerer udvidelsen, vil scriptet altid oprette en sikkerhedskopi først, men du kan også oprette sikkerhedskopier separat med denne linje:
sudo sh clerk_toolbox_magento.sh -b
my.clerk.io Indstillinger #
For at få adgang til dine synkroniseringsindstillinger mellem Clerk.io og din Magento 1 udvidelse, gå til my.clerk.io, klik på “Data” i venstre menu, og rul derefter ned til “Data Sync Indstillinger”.
Her finder du muligheder for at tilpasse, hvordan dine produkt-, kunde- og ordredata synkroniseres med Clerk. Mere information om Magento 1 Udvidelsen, tilgås gennem din Magento 1 Admin-portal, nedenfor.

Ordrehistorik #
Vælg den tidsperiode, du gerne vil synkronisere ordredata fra din butik til Clerk.io her.

Side Størrelse #
Vælg side størrelsen på dine synkroniserede data i dropdown-menuen nedenfor. Mindre sides størrelser kan hjælpe med at undgå host timeout under synkronisering, mens større sides størrelser kan synkronisere hurtigere.

Server Timeout #
Indstil længden af tid uden svar, før serveren timeout, både for at beskytte dine data og for at sikre, at du har givet nok tid til, at større datasæt kan synkroniseres med Clerk.io. Standard er 60 sekunder.

Data Parsing #
Vælg om du vil have dine Magento 1 data til at parse værdier automatisk i denne sektion. Automatisk parsing er standard og den anbefalede mulighed.

Synkroniseringstid #
Indstil det tidspunkt på dagen, du gerne vil have dine butikdata til at synkronisere med Clerk.io. Standard er “når det er nødvendigt”.

Udvidelsesindstillinger #
Hvis du bruger v4.8.0 eller en senere version af udvidelsen, vil du kunne få adgang til nedenstående indstillinger på to måder efter at have tilføjet dine Offentlige og Private Nøgler til udvidelsen:
- Gennem Magento2 backend i Clerk > Konfiguration > Indstillinger
- Gennem my.clerk.io, under Indstillinger > Udvidelser
Det betyder ikke noget, hvor du foretager ændringerne, da udvidelsen vil synkronisere med eventuelle ændringer foretaget i my.clerk.io og omvendt.
I my.clerk.io vil du også kunne se din nuværende version af udvidelsen, din platform og PHP-versionen.

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

Magento 1 Udvidelse Oversigt #
For at få adgang til din Magento 1 Clerk.io udvidelse, log ind på din butiks Admin-konto, og vælg “Konfiguration” > “Clerk” > “Indstillinger”.
Clerk Indstillinger #
Indstil nøgleparametre inden for Clerk Indstillinger sektionen af Magento 1 udvidelsen. Din evne til at aktivere/deaktivere Clerk.io udvidelsen, samt dine offentlige og private API-nøgler er også placeret her.
Real-time Opdateringer:
- Yderligere Felter
Inkluder Sider
- Yderligere Felter
Indsaml E-mails og Kunde Kurve:
Deaktiver Ordre Synkronisering:
Inkluder Udsolgte Produkter
Sprog & Import URL: Disse blev sandsynligvis indstillet, da du først installerede Clerk.io 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.

Søgeside og Live Søgning #
For at aktivere din Clerk.io Søgeside, Søgeside Facetter, og/eller Live Søgning, vælg “Ja” fra de relevante dropdown-menuer.
Søgeside Indstillinger:
Efter at have valgt “Ja”, vises muligheder for at indtaste dit Søgeside Indhold navn, som matcher data-template feltet, der findes i indlejringskoden af dit Indhold i my.clerk.io. I dette eksempel, søgeside.
Du kan også indstille teksten til " Load More" knappen her, samt teksten der vises, når ingen resultater findes for en forespørgsel.
Facetteret Søgning Indstillinger:
- Efter at have aktiveret facetteret søgning, får du muligheden for at indtaste de attributter, du gerne vil have til at vises som facetter på din Søgeside. Du kan også mærke disse facetter med de ønskede navne og vælge den rækkefølge, hvori hver facet vises.

Tilpasning af Dine Søgeside Facetter
- Clerk.io giver dig mulighed for at style dine søgeside facetter fra designet, og du kan vise dette ved at referere til det med design ID-feltet. Design ID kan findes i Clerk.io backend, i den yderste venstre kolonne af hvert design på designoversigtssiden og i nederste venstre af siden, når du går ind i designet for at redigere.

Bemærk: Du kan nu kalde data for kategorier og sider i din Søgeside på samme måde, som du ville i din Live søgning, hvilket giver dig et større udvalg af information til at engagere dine kunder med. For mere information kan du tjekke her.
Live Søgning Indstillinger
Efter at have aktiveret Live Søgning kan du vælge, om du vil have Kategorier til at vise i dine resultater, samt antallet af søge forslag, kategorier, og indhold resultater, der skal vises inden for Live Søgning.
Du har også muligheden for at vælge, hvilke side typer der vises som søgeresultater, for eksempel “CMS Sider” eller “Blog Indlæg”.
Du kan vælge positionen af live søgning dropdown fra din søgefelt med Dropdown Positionering.
Angiv indholdsnavnet for din live søgning næste, som kan findes ved siden af data-template i din Live Søgning indlejringskode inden for dit my.clerk.io Indhold. Dette er sandsynligvis live-søgning.
Sidst, angiv din Live Søgning Input Selector, som kan findes ved at inspicere din webshops søgefelt med din browser og identificere ID eller klasse, der er knyttet til dens input. I dette eksempel, #search.

Powerstep, Exit Intent, Kategori Side, Produkt Side, og Kurv Indstillinger #
Ligesom med Søgning, aktiver dine Clerk.io Powerstep, Exit Intent, Kategori Side, Produkt Side, og Kurv indstillinger ved at vælge “Ja” fra de relevante dropdown-menuer.

Efter at have valgt “Ja” fra den relevante dropdown, får du en boks til at indtaste indholdsnavnet for de Clerk.io Anbefalinger, du gerne vil inkludere på den side.
Ligesom med søgefunktionerne kan du finde indholdsnavnet ved siden af data-template i indlejringskoden inden for my.clerk.io > Anbefalinger > Indhold. I dette eksempel har vi aktiveret Kategori Side indstillinger og inkluderet kategori-side-populær som vores indhold.
Du kan tilføje flere indholdsnavne som kommaseparerede værdier her, hvis du gerne vil vise flere sliders på den side, for eksempel.

Logging #
Logging indstillingerne inkluderer:
Logging Niveau
Kun Fejl: Logger eventuelle fejl, der stopper modulet fra at fungere korrekt
Fejl + Advarsel: Logger også advarsler, der ikke får modulet til at stoppe med at fungere, men som måske også skal rettes.
Fejl + Advarsel + Debug: Logger alt som modulet interagerer med. Dette bør ikke aktiveres på en live webshop, da det vil sænke siden.
Logging til
Fil: Vil gemme loggen til en fil på Magento-serveren.
my.clerk.io: Logger alt til Data->Logs i my.clerk.io backend.
Oversættelse af tekster #
Clerk.io til Magento udvidelsen kommer indbygget med oversættelser til 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 kaldet da_DA og kopier filen Clerk_Clerk.csv.
Find mappen til 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 fra dette link:
https://github.com/clerkio/clerk-magento/releases/latest

1. Gem eventuelle ændringer til udvidelsesfiler #
Før du forsøger at opgradere, skal du sørge for, at du har enten:
Gemt de ændrede filer lokalt på din FTP eller
Lavet en sikkerhedskopi 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, 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
2. Deaktiver og afinstaller eksisterende udvidelse #
Før du forsøger at opgradere, er det meget vigtigt, at du gør dette:
- Deaktiver den gamle udvidelse i Magnetos System->Konfiguration->Clerk->Indstillinger side. Indstil blot Aktiver til Nej og klik på Gem Konfiguration.

2. Derefter afinstaller den enten gennem Magento Connect eller ved at slette filerne
fra FTP, hvis du installerede den direkte her.

Ellers kan din Konfiguration side stoppe med at fungere, og ingen af udvidelserne vil fungere bagefter.
3. Installer den nyeste udvidelse #
Til sidst, installer den nyeste udvidelse igen, og flyt eventuelle filer, du har sikkerhedskopieret, til din FTP-server.
Din konfiguration skal være gemt, selv når du installerer den nye version. Tjek System->Konfiguration->Clerk for at sikre, at alt stadig er der.
Nu har du den nyeste version af Clerk.io til Magento installeret!
Afinstallation #
For at fjerne Clerk.io fra din Magento 1 butik, skal du deaktivere udvidelsen inden for din Magento 1 admin portal.
Log ind på din webshops Magento 1 portal, og vælg derefter " System" > " Konfiguration" fra topmenuen.

På den næste side skal du finde " Clerk" i venstre menu, og vælge " Indstillinger". Herfra vil du se “Clerk Indstillinger” dukke op. Ved siden af " Aktiver", vælg " Nej" fra dropdown-menuen for ikke længere at aktivere Clerk.io udvidelsen.

Hvis du implementerede Clerk.io ved hjælp af udvidelsen, kan du også deaktivere de individuelle moduler ved lignende at vælge “Nej” fra de relevante Søgning og Anbefalinger dropdowns i denne sektion:

Hvis du installerede nogen elementer af Clerk.io direkte gennem dine FTP-filer, skal du sørge for at fjerne de relevante indlejringskoder fra disse filer.
Denne side er oversat af en hjælpsom AI, og der kan derfor være sproglige fejl. Tak for forståelsen.