Magento 2

Extension

Installation med Toolbox-scriptet #

Clerk.io Toolbox-scriptet er lavet 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, i t er allerede installeret på din computer.

Scriptet opretter også en sikkerhedskopi af Magento2-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 og Adgangskode.

1. Navigering til Magento2-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 den alligevel).

Naviger til roden af Magento2. Du kan 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 kigge efter den rigtige mappe, i dette tilfælde ville det være magento2. 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.

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

2.3. Da du ønsker at installere udvidelsen, vil du bruge -i sammen med den nyeste 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. Efter at have gjort dette, vil scriptet sikkerhedskopiere 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.

Valgfrit #

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

I tilfælde af at 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_magento2.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_magento2.sh -b

my.clerk.io Indstillinger #

For at få adgang til og ændre dine Magento 2 dataindstillinger i Clerk.io, gå til my.clerk.io, klik på “Data” i venstre menu, og rul derefter ned til “Data Sync Indstillinger”.

Bemærk: Information om Magento 2 Clerk.io udvidelsen, tilgængelig gennem Magento admin-portalen, er senere i denne artikel.

Her kan du indstille din butiks URL, side størrelse af dine data synkroniseringer, samt tidspunktet på dagen, hvor dine data skal synkroniseres til Clerk.io (standard er “når det er nødvendigt”).

Udvidelsesindstillinger #

Hvis du bruger v6.7.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 Butikker > Indstillinger > Konfiguration > Clerk > Konfiguration
  • 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:

Oversigt #

For at få adgang til din Clerk.io udvidelse i Magento 2, log ind på din webshops admin-portal, og følg stien Butikker > Indstillinger > Konfiguration > Clerk > Konfiguration

Generelt #

Du vil finde dit Clerk.io Udvidelsesversionsnummer, samt din butiks offentlige og private API-nøgler i den Generelle sektion.

For at inkludere Sider i din data synkronisering med Clerk.io, vælg “Ja” i den næste dropdown, og indtast eventuelle yderligere felter, du gerne vil inkludere med dine side data (såsom billeder eller sidetype) som komma-separerede værdier.

Du kan også indstille det standard sprog for dine synkroniserede butiksdata i den sidste dropdown i Generelt.

Synkronisering #

I Synkronisering sektionen af Clerk.io plugin’et har du mulighed for at tilpasse dine synkroniserede kunde-, ordre-, kurv- og produktdata.

Muligheder er gråtonede og utilgængelige for opdatering, når du bruger webstedets data, angivet med den markerede boks til højre for hver sektion. Fjern blot markeringen af den relevante boks for at ændre.

  • Brug Real-time Opdateringer: vælg “Ja” for at aktivere real-time opdateringer til dine data synkroniseret med Clerk.io.

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

  • Indsaml Kurve: for at indsamle kurvdata og synkronisere til Clerk.io, vælg “Ja” her

    • For at tilføje eventuelle yderligere kurvdatafelter, inkluder disse som komma-separerede værdier i “yderligere felter” sektionen nedenfor.

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

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

Kundesynkronisering #

Aktiver kundedata synkronisering ved at vælge “Ja” fra dropdownen i denne sektion. Hvis du har nogen ekstra kundeattributter, du gerne vil inkludere i Clerk.io synkroniseringen, indtast deres værdier i tekstboksen her som en komma-separeret liste.

Søgning #

Aktiver din butiks Søgning ved at vælge “Ja” i dropdownen her.

  • Efter at have valgt “Aktiveret”, indtast dit Søgesideindhold navn, som matcher data-template-feltet, der findes i embed-koden for dit indhold i my.clerk.io. I dette eksempel, søgeside.

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

Live Søgning #

  • Efter at have valgt “Aktiveret” fra dropdownen for at aktivere Live Søgning, vælg om du vil have Kategorier vist inden for dine søgeresultater.

    • Du kan også vælge antallet af søge forslag, kategorier, og indhold resultater, der skal vises inden for Live Søgning ud over dine produktresultater.

  • Du har også mulighed for at vælge, hvilke sidetyper der vises som søgeresultater, for eksempel “CMS Sider”, “Blog Indlæg” eller “Alle”.

  • Du kan vælge positionen for live søgning dropdown fra din søgefelt med Dropdown Positionering.

  • Angiv det Indhold navn for din live søgning næste, som kan findes ved siden af data-template i din Live Søgning embed-kode inden for dit my.clerk.io Indhold. Dette er sandsynligvis live-søgning.

  • Til sidst har du mulighed for at angive din Live Søgning Input Selector og Form Selector, som kan findes ved at inspicere din webshops søgefelt med din browser og identificere ID’et eller klassen, der er knyttet til dens input og form.

    • I dette eksempel, #search som input-selector, og ved at bruge webstedet er valgt til at identificere form-selector.

Facetteret Navigation #

For at tilføje facetter til din Søgning, skal du først sikre dig at vælge “Aktiveret” boksen 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, vil dine tilføjede attributter vises under Titler. I denne sektion kan du oprette titlen, der skal vises for den facet, og hvilken position i listen over facetter, du gerne vil have, at den attribut skal vises.

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.

Tilpasning af Dine Søgeside Facetter #

  • Clerk.io giver dig mulighed for at style dine søgeside facetter fra inden for designet, og du kan vise dette ved at referere til det med design-ID-feltet.
  • Design-ID’et 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.

Powerstep og Exit Intent #

Ligesom med Søgning, aktiver din Clerk.io Powerstep ved at vælge “Ja” fra dropdownen, og vælg den type powerstep, du gerne vil have vist (enten Side eller Popup).

  • Angiv det Indhold navn for din Powerstep, som findes ved siden af data-template i embed-koden inden for 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 Exit Intent, og identificere og tilføje det passende Exit Intent Indhold.

Kategori, Produkt, og Kurvside #

Også ligesom med Søgning, aktiver dine Clerk.io Produkt, Kategori, og Kurvsideindstillinger ved at vælge “Aktiveret” fra de relevante dropdowns.

  • Ligesom med søgefunktionerne, kan du finde indholdsnavnet ved siden af data-template i embed-koden inden for my.clerk.io > Anbefalinger > Indhold.
    • I dette eksempel har vi aktiveret Produkt Side, Kategori Side, og Kurvsideindstillinger, og inkluderet category-page-popular som vores Kategori Side indhold, product-page-alternatives og product-page-others-also-bought på vores Produkt Side, samt cart-others-also-bought som vores Kategori Side indhold.

Logging #

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

Find dropdownen kaldet Logging Indstillinger og indstil dine foretrukne logging-indstillinger. Afslut med at klikke på Gem:

Logging-indstillingerne inkluderer:

Vælg 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 muligvis også skal rettes.

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

Vælg hvor der skal logges

  • Fil: Vil gemme loggen til 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 opgradering bryde dine Designs, da Clerk.js 2 vil blive brugt. Hvis du bruger en ældre version, følg denne vejledning i stedet.
Vigtigt: Husk at tage sikkerhedskopier af eventuelle ændrede filer, da de vil blive overskrevet.

Opgradering af Magento 2 udvidelsen sker via kommandolinje.

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

  1. Log ind på din server gennem kommandolinje.

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

  3. Aktivér Root Adgang ved at skrive 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 på, at udvidelsen afslutter.

Din Magento 2 er nu opgraderet til den nyeste version.

Afinstallation #

Ligesom når du installerer udvidelser i Magento 2, skal afinstallationen ske gennem Kommando Linje.

Skriv blot følgende kommandoer for at fjerne den:

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

  2. composer remove clerk/magento2

Denne side er oversat af en hjælpsom AI, og der kan derfor være sproglige fejl. Tak for forståelsen.