Magento 2

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 skulle bruge Magento Connect.

Toolbox Scriptet skal køres direkte fra en terminal. Vi foreslår disse:

- Apple: iTerm, denne skal downloades fra internettet;

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

Scriptet opretter også en backup af Magento2-mappen, så den kan gendannes, hvis noget går galt.

Hvad skal jeg bruge? #

For at installere det skal du have SSH- eller SFTP-adgang til din webshop, inklusiv 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 for din bruger (terminalen vil ikke give nogen feedback, mens du taster adgangskoden, men den registrerer det alligevel).

Naviger til roden af Magento2. Det kan du gøre ved at skrive:

cd /var/www/html

og skrive:

ls

Dette vil give dig en liste over mapper, så du kan finde den rigtige:

I listen over mapper, find den rigtige mappe, i dette tilfælde ville det være magento2. Nu skal du blot gå ind i mappen, det gør du ved at skrive:

cd NAME_FOLDER

NAME_FOLDER udskiftes med det faktiske navn på mappen.

2. Installering af udvidelsen #

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. Herefter skal du skrive denne linje for at se en liste over de tilgængelige muligheder i Toolboxen:

sh clerk_toolbox_magento2.sh

2.3. Da du ønsker at installere udvidelsen, skal du bruge -i sammen med den 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 starte installationen af udvidelsen:

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

Valgfrie funktioner #

Afinstallering

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

sudo sh clerk_toolbox_magento2.sh -u

Gendannelse

Skulle der opstå problemer i din webshop, kan du altid gendanne via den backup, der laves ved installationen af udvidelsen.

Brug denne linje for at gøre det:

sudo sh clerk_toolbox_magento2.sh -r

Backup

Ved installation af udvidelsen opretter scriptet altid først en backup, men du kan også oprette en backup 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 menuen til venstre, og gå derefter til “Configuration”.

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

Her kan du indstille butikkens URL, sideantal for dine datasynkroniseringer, samt tidspunktet på dagen hvor dine data skal synkroniseres til Clerk.io (standard er “når nødvendigt”).

Udvidelsesindstillinger #

Hvis du bruger v6.7.0 eller en nyere version af udvidelsen, får du adgang til følgende indstillinger på to måder, efter at du har tilføjet dine Public og Private Keys til udvidelsen:

  • Gennem Magento2-backend under Stores > Settings > Configuration > Clerk > Configuration
  • Gennem my.clerk.io, under Developers > Extensions

Det er ligegyldigt, hvor du ændrer det, da udvidelsen synkroniserer med ændringerne i my.clerk.io og omvendt.

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

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

Overblik #

For at tilgå din Clerk.io-udvidelse i Magento 2 skal du logge ind i din webshops admin-portal og så følge stien Stores > Settings > Configuration > Clerk > Configuration

Generelt #

Du finder din Clerk.io-udvidelses versionsnummer samt butikkens public og private API-nøgler i sektionen Generelt.

For at inkludere Sider i din datasynkronisering med Clerk.io, vælg “Yes” i det næste dropdown og indtast eventuelle ekstra felter, du ønsker med i dine sidedata (som billeder eller sidetype) adskilt med komma.

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

Synkronisering #

I Synchronization-sektionen i Clerk.io-pluginet kan du tilpasse dine synkroniserede kunde-, ordre-, kurv- og produktdata.

Muligheder er gråtonede og ikke tilgængelige for opdatering ved brug af website-data, angivet ved det markerede felt til højre i hver sektion. Fjern blot markeringen for at ændre.

  • Use Real-time Updates: vælg “Yes” for at aktivere realtidsopdateringer på dine data synkroniseret med Clerk.io.

  • Collect Emails: vælg “Yes” her for at synkronisere kundeemails

  • Collect Baskets: for at indsamle kurvdata og synkronisere til Clerk.io, vælg “Yes” her

    • For at tilføje yderligere kurvdatafelter, inkluder disse adskilt med komma i sektionen “additional fields” nedenfor.

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

  • Hvis du har behov for at deaktivere ordre-synkronisering, kan du gøre dette ved at vælge “Yes” i dette dropdown.

Kunde-synkronisering #

Aktiver synkronisering af kundedata ved at vælge “Yes” i denne sektion. Hvis du har ekstra kundeattributter, du ønsker inkluderet i Clerk.io-synkroniseringen, så skriv dem her som en kommasepareret liste.

Aktivér butikkens Search Page ved at vælge “Yes” i dropdown her.

  • Efter markering af “Enabled”, indtast navnet på din Search Page Content, der matcher data-template-feltet i indlejringskoden fra dit Content i my.clerk.io. I dette eksempel, search-page.

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

  • Efter valg af “Enabled” i dropdown for at aktivere Live Search, vælg om du vil vise Categories i dine søgeresultater.

    • Du kan også vælge, hvor mange suggestions, categories og content resultater, der skal vises i Live Search udover dine produktresultater.

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

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

  • Angiv Content-navnet for din live search, som kan findes ved siden af data-template i din Live Search-indlejringskode i dit my.clerk.io Content. Dette er sandsynligvis live-search.

  • Til sidst har du mulighed for at angive din Live Search Input Selector og Form Selector, som kan findes ved at inspicere din webshops søgeboks med din browser og finde ID eller klasse for input og form.

    • I dette eksempel, #search som input selector, og “using the website” vælges for at identificere form selector.

Faceted Navigation #

For at tilføje facetter til din Search Page, sørg først for at markere “Enabled” under Faceted Navigation.

  • Klik på de attributter, du vil tilføje til dine facetter og klik på “save config”.

  • Når de er tilføjet, vil dine attributter blive vist under Titles. Her kan du oprette titlen, der skal vises for facetten, og hvilken position den skal have på listen over facetter.

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

Tilpasning af dine Search Page-facetter #

  • Clerk.io giver dig mulighed for at style dine search page-facetter direkte i designet, og du kan vise dette ved at referere til feltet “design ID”.
  • Design ID findes i Clerk.io backend på yderste venstre kolonne ved hvert design på designoversigtssiden og nederst til venstre på siden, når du redigerer designet.

Powerstep og Exit Intent #

Ligesom Search, aktiver din Clerk.io Powerstep ved at vælge “Yes” i dropdown, og vælg derefter den ønskede type powerstep (enten Page eller Popup).

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

  • Følg samme procedure som ovenfor for at aktivere din Exit Intent og identificere og tilføje den korrekte Exit Intent Content.

Kategori-, produkt- og kurvside #

Ligesom med Search, kan du aktivere Clerk.io Product, Category og Cart Page Settings ved at vælge “Enabled” fra de pågældende dropdowns.

  • Ligesom med Search-funktionaliteterne finder du slider-navnet ved siden af data-template i indlejringskoden under my.clerk.io > Recommendations > Sliders.
    • I dette eksempel har vi aktiveret indstillinger for Product Page, Category Page og Cart Page, og inkluderet category-page-popular som vores Category Page slider, product-page-alternatives og product-page-others-also-bought på vores Product Page samt cart-others-also-bought som vores Category Page slider.

Logging #

Det første du skal gøre for at ændre log-indstillingerne er at gå til din Magento2-backend og vælge Stores => Configuration => Clerk => Configuration:

Find dropdown-menuen kaldet Logging Settings og sæt dine foretrukne log-indstillinger. Afslut med at klikke på Save:

Logging-indstillingerne inkluderer:

Vælg logniveau

  • Kun Fejl: Logger alle fejl, der får modulet til at stoppe med at virke korrekt

  • Fejl + Warn: Logger også advarsler, der ikke får modulet til at stoppe, men som kan være nødvendige at rette.

  • Fejl + Warn + 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 skal logges

  • Fil: Gemmer log på 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 backup af alle ændrede filer, da de vil blive overskrevet.

Opgradering af Magento 2-udvidelsen sker via commandline.

Det foregår således:

  1. Log ind på din server via commandline.

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

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

  4. Indtast følgende kommandoer i denne 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 den nyeste version.

Afinstallation #

Ligesom ved installation af udvidelser i Magento 2, skal afinstallation ske via Command Line.

Skriv 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

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