Extension

Konfigurer dine Magento 2-udvidelsesindstillinger, administrer data-synkroniseringsmuligheder 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 lavet for at gøre det nemt at installere Clerk-udvidelsen i din Magento-webshop uden brug af Magento Connect.

Toolbox Scriptet køres direkte fra et 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 backup af Magento2-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 Username og Password.

Navigering til mappe #

1. Start med at logge ind på din Magento-server via terminal, ved at bruge dit Username og Domain sådan her:

ssh Stefan@mywebshop.com

2. Du bliver bedt om at indtaste adgangskoden for din bruger (terminalen giver ikke nogen feedback mens du skriver adgangskoden, men den registrerer det alligevel).

Naviger til root-mappen af Magento2. Det gør du ved at skrive:

cd /var/www/html

og skrive:

ls

Det giver dig en liste over mapper, som hjælper dig med at finde den rigtige:

I listen over mapper skal du finde den rigtige mappe, i dette tilfælde ville det være magento2.

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

cd NAME_FOLDER

NAME_FOLDER erstattes med det rigtige navn på mappen.

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-magento2/master/clerk_toolbox_magento2.sh

2. Skriv derefter denne linje for at se en liste over tilgængelige indstillinger i Toolbox:

sh clerk_toolbox_magento2.sh

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

4. Du bliver nu bedt om at indtaste dit password. Når du har gjort dette, laver scriptet en backup af din Magento2-mappe og begynder at installere udvidelsen:

5. Færdig! Nu er udvidelsen installeret, og du kan konfigurere den i din Magento2 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_magento2.sh -u

Gendannelse

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

Brug denne linje til det:

sudo sh clerk_toolbox_magento2.sh -r

Backup

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

sudo sh clerk_toolbox_magento2.sh -b

my.clerk.io-indstillinger #

For at tilgå og ændre dine Magento 2-dataindstillinger i Clerk, gå til my.clerk.io, klik på “Data” fra venstremenuen, og gå derefter til “Configuration”.

Bemærk: Information om Magento 2 Clerk-udvidelsen, tilgængelig via Magento adminportalen, findes senere i denne artikel.

Her kan du indstille din butiks URL, sidestørrelse for dine data-synkroniseringer samt tidspunktet på dagen hvor dine data skal synkroniseres til Clerk (standarden er “when needed”).

Udvidelsesindstillinger #

Hvis du bruger v6.7.0 eller en nyere version af udvidelsen, vil du kunne tilgå nedenstående indstillinger på to måder efter at have tilføjet dine Public og Private Keys til udvidelsen:

• Via Magento2-backend under Stores > Settings > Configuration > Clerk > Configuration

• Via my.clerk.io under Developers > Extensions

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

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

Klik blot på “Edit” ved enhver indstilling for at se de tilgængelige muligheder:

Oversigt #

For at tilgå din Clerk-udvidelse i Magento 2, log ind på din webshops adminportal, og følg derefter stien Stores > Settings > Configuration > Clerk > Configuration

Generelt #

Du finder dit Clerk-udvidelsesversionsnummer samt din butiks public og private API-nøgler i sektionen Generelt.

For at inkludere Pages i din data-synkronisering med Clerk, vælg “Ja” i næste dropdown, og indtast eventuelle flere felter, du gerne vil have med i dine sideldata (f.eks. billeder eller sidetype) som kommaseparerede værdier.

Du kan også indstille standardsprog for dine synkroniserede butikdata i det sidste dropdown under Generelt.

Synkronisering #

I Synchronization-sektionen af Clerk-pluginet har du mulighed for at tilpasse dine synkroniserede kunde-, ordre-, kurv-, og produktdata.

Muligheder er gråtonede og ikke tilgængelige for opdatering, når du bruger webside-data, hvilket vises ved det markerede felt til højre i hver sektion.

Fjern blot markeringen i den relevante boks for at foretage ændringer.

• Use Real-time Updates: vælg “Ja” for at aktivere realtidsopdateringer af de data, som synkroniseres med Clerk.

• Collect Emails: vælg “Ja” her for at synkronisere kundemails.

• Collect Baskets: for at indsamle kurv-data og synkronisere til Clerk, vælg “Ja” her.

  • For at tilføje ekstra kurvdatafelter, inkludér disse som kommaseparerede værdier i sektionen “additional fields” nedenfor.

• I de næste to dropdowns, vælg “ja” for kun at synkronisere salgbare produkter og/eller kun at synkronisere produkter med visibility til Clerk.

• Hvis du har brug for at deaktivere ordresynkronisering kan du gøre det ved at vælge “Ja” i denne dropdown.

Kundesynkronisering #

Aktiver kundedatasynkronisering ved at vælge “Ja” i dropdown-menuen i denne sektion.

Hvis du har ekstra kundeattributter, du ønsker inkluderet i Clerk-synkroniseringen, indtast deres værdier i tekstfeltet her som en kommasepareret liste.

Search #

Aktiver din butiks Search Page ved at vælge “Ja” i dropdown-menuen her.

• Når du har valgt “Enabled”, indtast dit Search Page Element-navn, som matcher det data-template felt, du finder i embed-koden for dit Element i my.clerk.io. I dette eksempel, search-page.

• Du kan indstille teksten vist ved " load more" og " no results" ved at skrive den ønskede sætning i disse tekstfelter.

Live search #

• Når du har valgt “Enabled” fra dropdown-menuen for at aktivere Live Search, vælg om du ønsker Categories vist i søgeresultaterne.

  • Du kan også angive antallet af suggestions, categories og content resultater, der skal vises i Live Search ud over dine produktresultater.

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

• Du kan vælge positionen af live search-dropdownen fra din søgeboks med Dropdown Positioning.

• Angiv navnet på Element for din live search, som du kan finde ved siden af data-template i din Live Search embed-kode i dit my.clerk.io Element. Det vil typisk være 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øgeboks i din browser og identificere ID eller klasse forbundet med dens input og form.

  • I dette eksempel anvendes #search som input selector, og at bruge websitet er valgt for at identificere form selector.

Facetnavigation #

For at tilføje facetter til din Search Page, skal du først sikre dig at “Enabled”-boksen er valgt under Faceted Navigation.

• Klik på attributterne du vil tilføje til dine facetter og klik gem konfiguration.

• Når de er tilføjet, vises dine tilføjede attributter under Titles. I denne sektion kan du oprette titlen, der skal vises for den pågældende facet, og hvilken position i facetlisten denne attribut skal have.

Bemærk: Du kan nu hente data for kategorier og sider i din Search page på samme måde som du gør i Live search, hvilket giver dig et større udvalg af information til at engagere dine kunder med. For mere information kan du se her.

Tilpasning af facetter #

• Clerk giver dig mulighed for at style dine søgeside-facetter indenfor designet, og du kan vise dette ved at henvise til design-ID-feltet.

• Design-ID kan findes i Clerk backend, i venstre kolonne på siden design overview page og nederst til venstre, når du går ind i designet for at redigere.

Powerstep og exit intent #

Ligesom Search aktiverer du din Clerk Powerstep ved at vælge “Ja” fra dropdown-menuen og vælges hvilken type powerstep du ønsker vist (enten Page eller Popup).

• Angiv navnet på Element for din Powerstep, som findes ved siden af data-template i embed-koden for dit Powerstep Element i my.clerk.io, fx power-step-others-also-bought i dette eksempel.

• Følg samme procedure som ovenfor for at aktivere Exit Intent, og identificér samt tilføj det relevante Exit Intent Element.

Recommendations #

Også ligesom Search, aktiver dine Clerk Product, Category og Cart Page Settings ved at vælge “Enabled” fra de relevante dropdowns.

• På samme måde som med Search funktionerne, kan du finde element-navnet ved siden af data-template i embed-koden i my.clerk.io > Recommendations > Elements.

  • I dette eksempel har vi aktiveret Product Page, Category Page og Cart Page indstillinger, og inkluderet category-page-popular som vores Category Page element, product-page-alternatives og product-page-others-also-bought på vores Product Page, samt cart-others-also-bought som vores Category Page element.

Logging #

Det første du skal gøre for at ændre logningsindstillingerne er at gå ind i din Magento2 backend og vælg Stores => Configuration => Clerk => Configuration:

Find dropdownen med navnet Logging Settings og angiv dine foretrukne logningsindstillinger.

Afslut ved at klikke på Save:

Logging-indstillingerne inkluderer:

Vælg logningsniveau

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

• Fejl + Advarsel: Logger også advarsler, der ikke forhindrer modulet i at fungere, men som kan være nødvendige at løse.

• 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.

Vælg hvor der logges

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

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

Opgradering #

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

Vigtigt: Husk at tage backups af alle ændrede filer, da de vil blive overskrevet.

Opgradering af Magento 2-udvidelsen foretages 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 (typisk " /var/www/your_domain/public_html")

3. Aktivér Root Access ved at taste su og derefter indtaste din adgangskode.

4. Indtast følgende kommandoer i rækkefølge:

   composer update clerk/magento2

   php bin/magento setup:upgrade

   php bin/magento setup:di:compile

5. Vent til udvidelsen er færdig.

Din Magento 2 er nu opgraderet til seneste version.

Afinstallation #

Ligesom når du installerer udvidelser i Magento 2, skal afinstallation ske via Command Line.

Indtast blot følgende kommandoer i rækkefølge for at fjerne den:

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

2. composer remove clerk/magento2