Fra design til et trygt temautkast NO
Velg CMS eller Liquid, kontroller butikk og tilganger, og skill mellom utkast, forhåndsvisning og endringer som går live.
Denne veiledningen er for den som skal overføre et design til en butikk og få det godkjent før publisering. Kaduno Web er i beta. Fremgangsmåten er kildekontrollert 13. november 2026; dere må fortsatt prøve den med egen versjon, tilgang og butikkoppsett før produksjonsbruk.
Et utkast er ikke alltid en sikkerhetsgrense. MCP-verktøyenes utkastflyt beskytter det aktive temaet. En REST-oppdatering, vanlig CLI-push eller Git-synkronisering til et allerede aktivt tema kan derimot endre den levende butikken umiddelbart. Ikke bruk produksjonstemaet som arbeidskopi.
Velg hva dere bygger
| Behov | Arbeidsmåte | Hva kunden ser |
|---|---|---|
| En innholdsside eller en ny forside innenfor dagens ramme | CMS-side som utkast | Temaets eksisterende topp og bunn rundt siden |
| Seksjoner og sidemaler i en Liquid-butikk | En egen temakopi som utkast | Temaets samlede oppsett i en forhåndsvisning |
| Endre farger og skrifter for hele butikken | Butikkens utseendeinnstillinger | En butikkinnstilling, ikke bare et sideutkast |
For vanlig sideredigering, start med Kaduno Web. En CMS-side og et Liquid-tema har forskjellige publiseringsløp. Godkjenn også endringer i butikkens globale stil separat.
Før dere begynner
- Avklar butikk, salgsflate og hvem som godkjenner. Flere salgsflater kan ha ulike temaer.
- Noter hvilket tema og hvilken forside som er aktive. Behold en kjent, fungerende kopi av temaets filer og eventuelle stilinnstillinger før dere endrer dem.
- Bruk testbutikk og eksempeldata der det er mulig. En temaforhåndsvisning på det virkelige domenet er ikke et isolert testsystem for ordre, kunder eller betaling.
- Avklar tilgang: REST-temaarbeid bruker
themes:readellerthemes:write. MCP bruker brukerens rolle og agentpolicy, ikke den samme REST-nøkkelen. - Designimport må være aktivert under Innstillinger → Utseende. Den er av som standard. Skrivetilgang til importverktøyene krever operatørnivå eller høyere.
Fra Figma eller Claude Design til importgrunnlag
Eksporter designet som HTML og CSS. Fra Figma trengs et verktøy som gir HTML, for eksempel Figma Make eller en egnet eksportplugin. En Figma-lenke eller et skjermbilde er ikke i seg selv en ferdig Kaduno-mal.
Kontroller bilder, skrifter og bruksrettigheter før overføring. Bilder bør ha full HTTPS-adresse. Importerte skript beholdes ikke, og funksjonalitet som skjema, innlogging og handlekurv må knyttes til Kadunos egne funksjoner. Kontroller importens merknader; et visuelt likt resultat betyr ikke at alle funksjoner fulgte med.
Farger og skrifter kan analyseres til et stilforslag uten å lagre det.
Å bruke stilforslaget er en separat skrivehandling: onboarding.applyDesignDraft
endrer valgt butikks farger og skrifter, og omfanget brand kan også endre logo
og header. Ikke anta at navnet «Draft» gjør disse butikkinnstillingene til en
isolert kladd. Gjør slike endringer i testbutikk eller etter egen godkjenning.
Vei A: CMS-side
- La designimporten lage en ny kladdeside med
draft_from_design. - Les merknadene om elementer som ikke kunne overføres. Kontroller om siden bruker riktige produkter, lenker og skjemaer, og at innholdet kan redigeres.
- Åpne forhåndsvisningen på mobil og skrivebord. Sammenlign den med designet, inkludert temaets topp og bunn.
- Stopp og få godkjenning av den konkrete siden og endringene som skal gå live.
- Publisering, valg av ny hjemmeside og endring av butikkens forsidekilde er
egne steg. For en CMS-forside må riktig side være valgt og
storefront_homepage_sourceværecms_page.
En ny kladdeside skal ikke erstatte den publiserte forsiden. Hvis dere senere vil
bruke temaets forside igjen, kontroller tidligere oppsett før forsidekilden settes
tilbake til theme. Dette er også en endring av den levende butikken.
Vei B: Liquid-tema
- Bruk
create_drafttil å lage en kopi med en ny, ubrukt slug. Oppgi riktig salgsflate hvis endringen gjelder en annen enn hovedbutikken. Kontroller at kopien har status utkast før videre arbeid. - Bruk
section_from_designmedwriteTo.draftSlugfor å skrive en seksjon til kladden. Tekster, lenker og bilder blir redigerbare innstillinger. Temaetssections/ogtemplates/index.jsonmå beskrive den ønskede rekkefølgen. - Valider hele temaet. En gyldig filpakke er ikke bevis på at layout, tilgjengelighet eller kjøpsflyt fungerer.
- Bruk
preview_urlfor kladden. Lenken er tidsbegrenset; kontroller utløpstidspunktet og del den bare med de som skal gjennomgå utkastet. - Stopp før
activate. Aktivering er handlingen som velger temaet for kundene, og krever en egen gjennomgang og godkjenning.
Designimport med section_from_design krever status utkast og avviser både aktivt
og planlagt tema. MCP-handlingen write_files avviser aktivt tema, men gir ikke
samme garanti for planlagte temaer. Kontroller derfor alltid at arbeidskopien er
et utkast uten planlagt aktivering. Se også forskjellene mellom grensesnittene under.
CLI, REST, Git og filpakker
Et Liquid-tema er en filpakke med theme.manifest.json og mapper som layout/,
templates/, sections/, snippets/, config/, assets/ og locales/.
Start fra et tema som passer butikkens funksjoner, ikke en vilkårlig HTML-side.
| Grensesnitt | Sikker arbeidsmåte | Viktig grense |
|---|---|---|
| MCP | Ny kladd → skriv → valider → forhåndsvis → egen aktivering | Utkastverktøy nekter aktivt tema |
| CLI | kaduno theme validate, deretter arbeid mot en identifisert kladd | dev lager en dev-kladd dersom valgt tema er aktivt; vanlig push til aktivt tema går live |
| REST | Les status før skriving; bruk egen ny slug for utkast | PUT erstatter alle filer og beholder status på eksisterende tema; PATCH endrer filer i det valgte temaet |
| Git | Egen kladd og kontrollert gren før synkronisering | Synk erstatter temafilene fra repoet; synk til aktivt tema påvirker kundene |
| ZIP/filpakke | Kontroller importmål, validering og status i importdialogen | Ikke anta at import er det samme som godkjent aktivering |
En seksjon som bare er skrevet i Kaduno kan forsvinne ved neste Git-synk.
Før endringer tilbake til temaets repo, inkludert tilhørende mal og innstillinger,
før dere fortsetter å synkronisere. Ikke bruk --yes eller automatisk aktivering
som standard i en gjennomgangsflyt.
Liquid skriver ikke automatisk ut tekst som ufarlig HTML. Bruk escape for
vanlig tekst fra produkter, kunder, import og innstillinger. Bruk bare bevisst
HTML der feltets kontrakt sier at innholdet er sanert. En validering erstatter
ikke kontroll av escaping og skript i temaet.
Kontroll før godkjenning
- Riktig butikk, salgsflate, språk og utkast; den offentlige forsiden er uendret.
- Forside, kategori, produkt og relevante CMS-sider på mobil og skrivebord.
- Tomme lister, lange tekster, manglende bilder og meny med tastatur.
- Produktvalg, handlekurv og relevante B2B-funksjoner med avtalte testdata. Ikke legg en virkelig ordre bare for å teste et tema.
- Ingen hemmelige nøkler, kundedata eller ikke-godkjente sporingsskript i filene.
- En navngitt godkjenner har sett den samme versjonen som skal aktiveres.
Når noe går galt
Validering feiler: rett den oppgitte filen eller malen i kladden. Ikke omgå validering eller endre aktivt tema for å få forhåndsvisningen til å fungere.
Forhåndsvisning mangler: kontroller slug, salgsflate og utløpstidspunkt. Lag en ny forhåndsvisningslenke ved behov, ikke aktiver temaet for å «teste».
Designet endres etter Git-synk: sammenlign repoets filer med kladden. Velg én arbeidskilde og ta vare på endringene før neste synkronisering.
Dere må gå tilbake: gjenaktivering av et tidligere, fungerende tema er en ny live-endring og må valideres og godkjennes. Det gjenoppretter ikke nødvendigvis butikkens globale stil, CMS-innhold eller andre innstillinger. Behold tidligere filer og innstillinger; ikke slett temaer som del av vanlig tilbakeføring.
Se API og rettigheter og AI-agenter og kontroller før tilgang gis til en utvikler eller assistent.