Magento 2

Extension

Konfigurer dine Magento 2-udvidelsesindstillinger, og administrer installation, opgraderinger og data synkroniseringsindstillinger

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

Toolbox Scriptet køres direkte fra en terminal.

Vi anbefaler 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 den, skal du have SSH- eller SFTP-adgang til din webshop, inklusive dit Brugernavn og Adgangskode.

  1. Start med at logge ind på din Magento-server via en terminal, ved at bruge dit Brugernavn og Domæne sådan her:
ssh Stefan@mywebshop.com
  1. Du vil blive bedt om at indtaste adgangskoden for din bruger (terminalen giver ingen feedback, mens du taster, men den registrerer det alligevel).

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

cd /var/www/html

og skrive:

ls

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

List of folders

Find den rigtige mappe i mappelisten, 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 erstattes med den rigtige mappenavn.

Installere udvidelse #

  1. Når du er i din Root Folder, skal du hente Toolbox Scriptet med denne linje:
sudo wget https://raw.githubusercontent.com/clerkio/clerk-magento2/master/clerk_toolbox_magento2.sh
  1. Skriv derefter denne linje for at se listen over tilgængelige muligheder i Toolboxen:
sh clerk_toolbox_magento2.sh
Toolbox options
  1. Da du ønsker at installere udvidelsen, skal du bruge -i sammen med seneste versionsnummer af udvidelsen. Skriv denne linje:
sudo sh clerk_toolbox_magento2.sh -i
  1. Du vil nu blive bedt om at indtaste din adgangskode. Efter dette tager scriptet backup af din Magento2-mappe og påbegynder installationen af udvidelsen:
Installation process
  1. Færdig! Nu er udvidelsen installeret, og du kan konfigurere den i din Magento2 backend.

Valgfrie kommandoer #

Afinstallation

Toolboxen 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 blev lavet under installationen af udvidelsen.

Brug denne linje for at gøre 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å lave en separat backup 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” i venstre menu og gå derefter til “Configuration”.

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

Her kan du sætte din butiks URL, sidelængde på dine datasynkroniseringer samt tidspunktet for, hvornår dine data skal synkroniseres til Clerk (standard er “when needed”).

Data configuration page

Udvidelsesindstillinger #

Hvis du bruger v6.7.0 eller senere version af udvidelsen, kan du tilgå nedenstående indstillinger på to måder efter tilføjelse af dine Public og Private Keys til udvidelsen:

  • Gennem Magento2 backend i Stores > Settings > Configuration > Clerk > Configuration

  • Gennem my.clerk.io under Developers > Extensions

Det betyder ikke noget, hvor ændringerne laves, 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, din platform og PHP-versionen.

Extension settings in my.clerk.io

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

Edit settings

Oversigt #

For at tilgå din Clerk-udvidelse i Magento 2, log ind på admin-portalen for din webshop, og følg stien Stores > Settings > Configuration > Clerk > Configuration

Clerk configuration page

Generelt #

Du finder dit Clerk Extension versionsnummer samt din butiks public og private API-nøgler i General-sektionen.

For at inkludere Pages i din data sync med Clerk, vælg “Yes” i den næste dropdown og indtast eventuelle ekstra felter, du vil inkludere med dine sidedata (f.eks. billeder eller sidetype) som kommaseparerede værdier.

Du kan også sætte standardsprog for dine synkroniserede butikdata i den sidste dropdown under Generelt.

General settings

Synkronisering #

I Synchronization-sektionen i 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 websitedataen, hvilket vises ved det afkrydsede felt til højre i hver sektion.

Fjern markeringen i det relevante felt for at foretage ændringer.

  • Use Real-time Updates: vælg “Yes” for at slå realtidsopdateringer til for dine synkroniserede data med Clerk.

  • Collect Emails: vælg “Yes” her for at synkronisere kunde-emails.

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

    • For at tilføje yderligere kurvdatifelter, inkluder disse som kommaseparerede værdier i afsnittet “additional fields” nedenfor.

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

  • Hvis du ønsker at deaktivere ordresynkronisering, kan du gøre det ved at vælge “Yes” i denne dropdown.

Synchronization settings

Kundesynkronisering #

Aktivér synkronisering af kundedata ved at vælge “Yes” fra dropdown i denne sektion.

Hvis du har ekstra kundeattributter, du gerne vil inkludere i Clerk sync, indtast værdierne i tekstfeltet her som en kommasepareret liste.

Customer synchronization settings

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

  • Når du har valgt “Enabled”, indtast navnet på dit Search Page Content, som matcher data-template feltet fundet i embedkoden for dit Content i my.clerk.io. I dette eksempel, search-page.

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

Search settings

  • 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 antallet af søgeresultater for suggestions, categories og content, der skal vises i Live Search udover dine produktresultater.

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

Live search settings

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

  • Angiv derefter Content-navn til din live search, som kan findes ved siden af data-template i din Live Search embedkode 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 identificere ID eller klasse knyttet til dens input og form.

    • I dette eksempel #search som input selector, og “using the website” vælges til identifikation af form selector.

Facetteret navigation #

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

Faceted navigation settings

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

  • Når de er tilføjet, vil dine tilføjede attributter komme frem under Titles. Her kan du oprette titlen, der skal vises for den facet, og vælge hvilken position på listen af facetter, attributten skal vises på.

Facet titles and positions

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

Tilpasning af facetter #

  • Clerk tillader dig at style dine search page facetter direkte i designet, og du kan vise dette ved at referere den med design ID-feltet.

  • Design ID’et kan findes i Clerk backend i yderste venstre kolonne på hvert design på designoversigtssiden samt i nederste venstre hjørne, når du åbner designet til redigering.

Design ID location
Design overview page

Powerstep og exit intent #

På samme måde som Search, aktiver din Clerk Powerstep ved at vælge “Yes” fra dropdown og vælg derefter, om du vil have typen Page eller Popup vist.

  • Angiv Content-navnet for din Powerstep, som findes ved siden af data-template i embedkoden under din my.clerk.io Powerstep Content, fx power-step-others-also-bought.

  • Følg samme proces for at aktivere din Exit Intent, og identificer samt tilføj den relevante Exit Intent Content.

Powerstep and exit intent settings

Recommendations #

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

  • Ligesom med Search-funktionerne, kan du finde elementnavnet ved siden af data-template i embedkoden via my.clerk.io > Recommendations > Elements.

    • I dette eksempel har vi aktiveret Product Page, Category Page og Cart Page-indstillingerne, 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.
Recommendations settings

Logging #

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

Clerk configuration

Find dropdownen Logging Settings og indstil de foretrukne logningsindstillinger.

Afslut ved at klikke på Save:

Logging settings

Logningsindstillinger omfatter:

Vælg logniveau

  • Only Errors: Logger alle fejl der forhindrer modulet i at virke korrekt.

  • Error + Warn: Logger også advarsler, som ikke får modulet til at stoppe, men som måske skal løses.

  • Error + Warn + Debug: Logger alt, som modulet interagerer med. Dette bør ikke aktiveres på en live webshop da det vil gøre siden langsom.

Vælg hvor der logges

  • File: Gemmer loggen til 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. Ved brug af ældre version, følg i stedet denne guide.

Vigtigt: Husk at tage backup af evt. ændrede filer, da de overskrives.

Opgradering af Magento 2-udvidelsen gøres 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/your_domain/public_html")

  3. Aktiver Root Access ved at skrive su og derefter indtaste din adgangskode.

  4. Skriv 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 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 gøres via Command Line.

Skriv blot følgende kommandoer i rækkefølge for at fjerne udvidelsen:

  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.