Extension

Installation med Toolbox-scriptet #

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

Toolbox Script vil blive kørt direkte fra en terminal. Vi foreslår disse:

- Apple: iTerm, du bliver nødt til at downloade det fra internettet;

- Windows: Kommandoprompt, i det er allerede installeret på din computer.

Scriptet er også opretter en sikkerhedskopi af Magento2-mappen, så det kan gendannes, hvis noget går galt.

Hvad har jeg brug for? #

For at installere det skal du bruge SSH- eller SFTP-adgang til din webshop, herunder din Brugernavn og Adgangskode

1. Naviger til Magento2-mappen #

1.1 Start med at logge ind på din Magento-server via en terminal ved at bruge dine Brugernavn og Domæne på denne måde:

ssh Stefan@mywebshop.com

1.2 Du bliver bedt om at indtaste adgangskoden til din bruger (terminalen giver dig ikke nogen feedback, mens du indtaster adgangskoden, men den registrerer den alligevel).

Naviger til rodmappe i Magento2. Det kan du gøre ved at skrive:

cd /var/www/html

og skrive:

ls

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

På listen over mapper skal du lede efter den rigtige mappe, i dette tilfælde er det magento2. Det, du skal gøre nu, er at gå ind i mappen, og det kan du gøre ved at skrive:

cd NAME_FOLDER

NAME_FOLDER erstattes af det rigtige navn på mappen.

2. Installation af udvidelse #

2.1. Når du er i din rodmappe, skal du downloade Toolbox Script med denne linje:

sudo wget https://raw.githubusercontent.com/clerkio/clerk-magento2/master/clerk_toolbox_magento2.sh

2.2. Skriv derefter denne linje for at se en liste over de tilgængelige muligheder i værktøjskassen:

sh clerk_toolbox_magento2.sh

2.3. Da du vil installere udvidelsen, skal du bruge -i sammen med Seneste versionsnummer af udvidelsen. Skriv denne linje:

sudo sh clerk_toolbox_magento2.sh -i

2.4. Du vil nu blive bedt om at indtaste din adgangskode. Når du har gjort det, vil scriptet tage backup af din Magento2-mappe og begynde at installere udvidelsen:

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

Valgmuligheder #

Afinstallation

Værktøjskassen giver dig også mulighed for at afinstallere udvidelsen. Det kan du gøre med denne linje:

sudo sh clerk_toolbox_magento2.sh -u

Gendannelse

Hvis noget går galt i din webshop, kan du altid gendanne den via den sikkerhedskopi, der laves, når du installerer udvidelsen.

Brug denne linje til at gøre det:

sudo sh clerk_toolbox_magento2.sh -r

Sikkerhedskopiering

Når du installerer udvidelsen, opretter scriptet altid en sikkerhedskopi først, men du kan også oprette en sikkerhedskopi separat med denne linje:

sudo sh clerk_toolbox_magento2.sh -b

my.clerk.io Indstillinger #

For at få adgang til og ændre dine Magento 2-dataindstillinger i Clerk.io skal du gå ind på my.clerk.io, klikke på “Data” i menuen til venstre og derefter rulle ned til “Data Sync Settings”.

Bemærk:_ _ Oplysninger om Magento 2 Clerk.io-udvidelsen, der er tilgængelig via Magento admin -portalen, findes senere i denne artikel.

Her kan du indstille din butiks URL, sidestørrelse for dine datasynkroniseringer samt tidspunkt på dagen, hvor dine data skal synkroniseres til Clerk.io (standardindstillingen er “når det er nødvendigt”).

Indstillinger for udvidelser #

Hvis du bruger v6.7.0 eller en senere version af udvidelsen, kan du få adgang til nedenstående indstillinger på to måder, når du har tilføjet Offentlige og Private nøgler til udvidelsen:

• Gennem Magento2-backend i Butikker > Indstillinger > Konfiguration > Ekspedient > Konfiguration
• Gennem my.clerk.io, under Indstillinger > Udvidelser

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

I my.clerk.io vil du også kunne se din aktuelle 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:

Oversigt #

For at få adgang til din Clerk.io-udvidelse i Magento 2 skal du logge ind på din webshops admin -portal og derefter følge stien Butikker > Indstillinger > Konfiguration > Ekspedient > Konfiguration

Generelt #

Du finder dit Clerk.io-udvidelsesversionsnummer samt din butiks offentlige og private API-nøgler i afsnittet General.

Hvis du vil Inkluder sider din datasynkronisering med Clerk.io, skal du vælge “Ja” i den næste rullemenu og indtaste Yderligere felter, som du gerne vil inkludere i dine sidedata (f.eks. billeder eller sidetype) som kommaseparerede værdier.

Du kan også indstille standardsprog for dine synkroniserede butiksdata i den sidste dropdown under Generelt.

Synkronisering #

I afsnittet Synkronisering i Clerk.io-pluginet har du mulighed for at tilpasse dine synkroniserede kunde-, ordre-, kurv- og produktdata.

Indstillingerne er nedtonede og ikke tilgængelige for opdatering, når du bruger webstedsdataene, hvilket er angivet med afkrydsningsfeltet til højre for hvert afsnit. Du skal blot fjerne markeringen i det relevante felt for at ændre.

• Brug opdateringer i realtid: Vælg “Ja” for at aktivere opdateringer i realtid af dine data, der er synkroniseret med Clerk.io.

• Indsaml e-mails: vælg “Ja” her for at synkronisere kunde-e-mails

• Indsaml kurve: Vælg “Ja” her for at indsamle kurvedata og synkronisere dem med Clerk.io.

  • Hvis du vil tilføje yderligere kurvedatafelter, skal du inkludere disse som kommaseparerede værdier i afsnittet “Yderligere felter” nedenfor.

• I de næste to dropdowns skal du vælge “ja” til Synkroniser kun salgbare produkter og/eller Synkroniser kun produkter med synlighed til Clerk.io

• Hvis du får brug for deaktiver ordresynkronisering,, kan du gøre det ved at vælge “Ja” i denne dropdown.

Kundesynkronisering #

Aktivér synkronisering af kundedata ved at vælge “Ja” i rullemenuen i dette afsnit. Hvis du har nogle ekstra kundeattributter, som du gerne vil inkludere i Clerk.io-synkroniseringen, skal du indtaste deres værdier i tekstfeltet her som en kommasepareret liste.

Søg #

Aktivér din butiks søgeside ved at vælge “Ja” i rullemenuen her.

• Når du har valgt “Enabled”, skal du indtaste dit Indhold på søgesiden -navn, som matcher det data-template-felt, der findes i indlejringskoden for dit indhold i my.clerk.io. I dette eksempel er det search-page.

• Du kan indstille den viste tekst " indlæs mere" og " ingen resultater" ved at skrive den ønskede sætning i disse tekstfelter.

Live-søgning #

• Når du har valgt “Enabled” i rullemenuen for at aktivere Live Search, skal du vælge, om du vil have Kategorier vist i dine søgeresultater eller ej.

  • Du kan også vælge antallet af søgeresultater på forslag, kategorier, og indhold, der skal vises i Live Search ud over dine produktresultater.

• Du har også mulighed for at vælge, hvad Sidetyper skal vise som søgeresultater, f.eks. “CMS Pages”, “Blog Posts” eller “All”.

• Du kan vælge placeringen af live search-dropdown’en fra dit søgefelt med Placering af dropdown.

• Angiv navnet Indhold for din næste live-søgning, som findes ved siden af data-template i din Live Search-indlejringskode i dit my.clerk.io-indhold. Dette er sandsynligvis live-search.

• Til sidst har du mulighed for at angive din Live Search Input Selector og Form Selector, som du kan finde ved at inspicere din webshops søgefelt med din browser og identificere det ID eller den klasse, der er forbundet med input og formular.

  • I dette eksempel er #search valgt som inputvælger, og websitet er valgt til at identificere formularvælgeren.

Facetteret navigation #

For at tilføje facetter til din søgeside skal du først sørge for at vælge feltet “Enabled” under Facetteret navigation.

• Klik på de attributter, du gerne vil tilføje til dine facetter, og klik på Gem konfiguration.

• Når de er tilføjet, vises de tilføjede attributter under Titler.. I dette afsnit kan du oprette den titel, der skal vises for den pågældende facet, og hvilken position på listen over facetter du ønsker, at attributten skal vises.

Bemærk venligst: Du kan nu kalde data for kategorier og sider på din søgeside på samme måde, som du ville gøre i din Live-søgning, hvilket giver dig et større udvalg af oplysninger til at engagere dine kunder med. Du kan få flere oplysninger på kan tjekkes her.

Tilpasning af facetterne på din søgeside #

• Clerk.io giver dig mulighed for at style dine søgesidefacetter inde fra designet, og du kan vise det ved at henvise til det med design-ID-feltet.
• Design-ID’et kan findes på Clerk.io-backend, på Yderste venstre kolonne i hvert design på side med designoversigt og på nederst til venstre på siden, når du har oprettet den. indtast det design, du vil redigere.
  
  

Powerstep og Exit Intent #

Ligesom med Search skal du aktivere din Clerk.io Powerstep ved at vælge “Yes” i rullemenuen og derefter vælge den type powerstep, du vil have vist (enten Page eller Popup).

• Angiv navnet Indhold for din Powerstep, som findes ved siden af data-template i indlejringskoden i dit my.clerk.io Powerstep-indhold, power-step-others-also-bought i dette eksempel.

• Følg den samme proces som ovenfor for at aktivere din Afslut hensigt, og identificere og tilføje den relevante Indhold af udgangsintention.

Kategori-, produkt- og kurvside #

I lighed med Search skal du aktivere din Clerk.io Produkt, kategori, og Indstillinger for kurvside ved at vælge “Enabled” i de relevante dropdowns.

• Ligesom med søgefunktionerne kan du finde indholdsnavnet ved siden af data-template i indlejringskoden i my.clerk.io > Recommendations > Content.
  • I dette eksempel har vi aktiveret indstillingerne for produktside, kategoriside og indkøbskurv og inkluderet category-page-popular som indhold på vores kategoriside, product-page-alternatives og product-page-others-also-bought på vores produktside samt cart-others-also-bought som indhold på vores kategoriside.

Logning #

Det første, du skal gøre for at ændre logningsindstillingerne, er at gå ind i din Magento2-backend og vælge Butikker => Konfiguration => Ekspedient => Konfiguration :

Find den dropdown, der hedder Indstillinger for logning, og indstil dine foretrukne logningsindstillinger. Slut af med at klikke på Gem:

Logningsindstillingerne omfatter:

Vælg logningsniveau

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

• Fejl + advarsel: Logger også advarsler, som ikke får modulet til at holde op med at fungere, men som det måske også er nødvendigt at rette.

• Fejl + Advarsel + Debug: Logger alt, som modulet interagerer med. _Dette bør ikke være aktiveret på en live webshop, da det vil gøre siden langsommere.

Vælg, hvor der skal logges

• File: Gemmer loggen i en fil på Magento2-serveren.

• my.clerk.io: Vil logge alt til Data->Logs i my.clerk.io backend.

Opgradering #

Hvis du bruger en version før 3.0.0, vil en opgradering ødelægge dine designs, da Clerk.js 2 vil blive brugt. Hvis du bruger en ældre version, Følg denne vejledning i stedet.

Opgradering af Magento 2-udvidelsen sker via commandline..

Det gøres ved at følge disse trin:

1. Log ind på din Server via commandline.

2. Naviger til din webroot-mappe (normalt " /var/www/dit_domæne/public_html")

3. Aktivér Root-adgang via ved at skrive su og derefter indtaste din adgangskode.

4. Skriv følgende Kommandoer i rækkefølge:

composer opdater kontorist/magento2

php bin/magento setup:upgrade

php bin/magento setup:di:compile

5. Vent på, at udvidelsen er færdig.

Din Magento 2 er nu opgraderet til den nyeste version.

Afinstallation #

Ligesom når du installerer udvidelser i Magento 2, skal afinstallation ske gennem Kommandolinje.

Du skal blot indtaste følgende kommandoer for at fjerne den:

1. php bin/magento setup:module:disable Clerk_Clerk

2. composer fjerner clerk/magento2