Temainnstillinger for produkter og sider (temautvidelser)

Hva er temainnstillinger for produkter og sider?

Tema-utvidelser (på engelsk «extensions») er ekstra felt som temaet ditt stiller til disposisjon på produkter, kategorier, landingssider, statiske sider og blogginnlegg. I administrasjonspanelet finner du feltene i kortet «Temainnstillinger», som tidligere het «Utvidelser fra temaet ditt». Det er temautvikleren som definerer feltene, og som butikkeier fyller du dem ut direkte i administrasjonspanelet, for eksempel på produktets redigeringsside.

Typiske eksempler er et felt for en YouTube-video, et merke med tekst og farge, tilleggsprodukter til varen eller en liste over egenskaper med tittel, beskrivelse og ikon. Temaet bruker dataene du legger inn til å vise ekstra innhold i nettbutikken.

For butikkeiere: Slik bruker du Temainnstillinger

Når du redigerer et produkt, finner du fanen «Temainnstillinger» mellom fanene «Felter» og «Intern søk», og som snarvei i menyen på høyre side. Klikk på kortet for å utvide det. Feltene er samlet i grupper med en overskrift, f.eks. «Video», «Badge» og «Tilleggsprodukter». På kategorier, statiske sider, landingssider og blogginnlegg ligger kortet rett under «Generelt».

Fyll ut feltene etter behov. Noen felter er enkle tekstfelt, andre er fargevelgere, bildeopplastinger eller avkryssingsfelt. Hvert felt har en tittel og vanligvis en forklaring som forteller hva det brukes til.

Når du lagrer, lagres feltene sammen med produktet eller siden, og temaet bruker dem til å vise det relevante innholdet i nettbutikken. For eksempel viser en utfylt YouTube-video-ID i Montana en video i produktets bildegalleri. Tekstfelt på produkter blir dessuten inkludert i nettbutikkens interne søk, med mindre temautvikleren har deaktivert dette.

Du kan også bruke produktfeltene på en landingsside. Velg regelen «Utvidet produktfelt», så viser landingssiden produktene som har en bestemt verdi i feltet.

Temainnstillinger i Montana og MontanaB2B

I Montana og MontanaB2B er feltene på dansk og forklart direkte i admin. For produkter er det tre grupper:

• Video: feltet «YouTube-video-ID». ID-en er den siste delen av YouTube-lenken, så i youtube.com/watch?v=dQw4w9WgXcQ er ID-en dQw4w9WgXcQ. Videoen vises i produktets bildegalleri.
• Merke: feltene «Merketekst», «Bakgrunnsfarge på merke» og «Tekstfarge på merke». Merket vises som et symbol på produktbildet, f.eks. «Nyhet» eller «Kun online».
• Tilleggsprodukter: feltet Produkt-ID-er for tilleggsprodukter. Skriv inn ID-ene til produktene kunden kan legge i handlekurven sammen med dette produktet, atskilt med komma, f.eks. 123,456. Produkt-ID-en står i adressefeltet når du redigerer et produkt, og tilleggskjøp med varianter får sin egen variantvelger. Les mer under «Tilleggskjøp» på produktsiden.

Felt som ikke fungerte som de skulle, er fjernet fra Montana og MontanaB2B:

• Kommentarfelt på produktet. Hvis kunden skal skrive en tekst til varen, f.eks. til en gravering, bør du i stedet bruke kundeinndata på produktene.
• «Kun henting», som kun viste lagerstatus på produktsiden og ikke skjulte de andre fraktalternativene i kassen.
• Skjul visning av samlepakker og skjul pristabeller for mengderabatt og varianter.
• Alle felter på kategorier, statiske sider, blogginnlegg og landingssider. Derfor viser ikke Montana og MontanaB2B lenger kortet «Temainnstillinger» der.

Data du tidligere har lagret i feltene, slettes ikke, men de vises ikke lenger i admin, og temaet bruker dem ikke. Hvis du bruker din egen, tilpassede kopi av Montana, forblir feltene dine uendret, siden Shoporama ikke endrer butikkenes egne temaer. Andre temaer, for eksempel Delaware, DelawareDK, California og Alaska2, har sine egne felt.

Støttede felttyper

Temainnstillinger støtter en lang rekke felttyper:

• text: et enkelt tekstfelt for korte verdier (f.eks. en video-ID eller en badge-tekst).
• richtext: en HTML-editor med formateringsmuligheter for lengre tekster med fet skrift, kursiv, lenker osv.
• longtext: et stort tekstfelt (textarea) for lengre tekster uten HTML-formatering.
• number: et tallfelt for numeriske verdier.
• bool: en avkrysningsboks for ja/nei-verdier (f.eks. «Vis merket»).
• color: en fargevelger for å velge farger visuelt (f.eks. bakgrunnsfarge for et merke).
• list: en rullegardinmeny med forhåndsdefinerte valgmuligheter.
• multi: flere avkryssingsbokser for å velge flere alternativer samtidig.
• image: opplasting av et enkelt bilde.
• images: opplasting av flere bilder (f.eks. et galleri).
• date: en datovalg.
• datetime: en dato- og tidsvelger.
• repeater: gjentakelsesfelt, som gjør det mulig å legge til et dynamisk antall grupper av felt (se eget avsnitt nedenfor).

For temautviklere: Definering av felter

Feltene defineres i JSON-filer i temaets extensions/ -mappe. Filen har navn etter typen objekt som feltene gjelder for:

• extensions/product.json: produkter
• extensions/category.json: kategorier
• extensions/landing_page.json: landingssider
• extensions/static_page.json: statiske sider
• extensions/blog_post.json: blogginnlegg

Hvis filen ikke finnes, eller hvis den bare inneholder en tom matrise, [], har temaet ingen felt for denne typen, og kortet «Temainnstillinger» vises ikke i admin. Montana og MontanaB2B har for eksempel tomme filer for kategorier, landingssider, statiske sider og blogginnlegg.

JSON-filen er en matrise av grupper. Hver gruppe har et navn, en valgfri beskrivelse og en liste over felt. Navnet vises som overskrift i kortet, og en beskrivelse vises etter navnet. Her er et utdrag fra Montana:

[
    {
        "name": "Video",
        "description": "",
        "fields": [
            {
                "title": "YouTube-video-ID",
                "description": "ID-en fra YouTube-lenken. I youtube.com/watch?v=dQw4w9WgXcQ er ID-en dQw4w9WgXcQ. Videoen vises i produktets bildegalleri.",
                "id": "youtube_id",
                "type": "text"
            }
        ]
    },
    {
        "name": "Merke",
        "description": "",
        "fields": [
            {
                "title": "Badge-tekst",
                "description": "Vises som et merke på produktbildet, f.eks. Nyhet eller Kun online.",
                "id": "badge",
                "type": "text"
            },
            {
                "title": "Merke-bakgrunnsfarge",
                "id": "badge-bg",
                "type": "color",
                "default_value": "#fef3c7"
            },
            {
                "title": "Merketekstfarge",
                "id": "badge-color",
                "type": "color",
                "default_value": "#92400e"
            }
        ]
    }
]

Hvert felt støtter følgende egenskaper:

• id (påkrevd): unikt ID, brukes til å hente verdien i maler.
• title (påkrevd): etikett som vises i admin.
• type (påkrevd): felttypen (se listen ovenfor).
• description: hjelpetekst som vises under feltet. Skriv den til butikkeieren, slik at det er tydelig hva feltet gjør i butikken.
• placeholder: plassholdertekst i inndatafeltet.
• default: standardverdi for text, longtext, richtext, number, date og datetime.
• default_value: standardverdi for color. Uten standardverdi starter fargevelgeren på svart.
• options: valgmuligheter for list- og multi-typer (objekt med nøkkel/verdi-par).
• searchable: kun på produkter. Tekst-, liste- og flervalgsfelt blir automatisk inkludert i nettbutikkens interne søk. Sett «searchable»: false for å ekskludere et felt.

Standardverdien fylles ut i admin og lagres først når produktet eller siden lagres. Inntil da har feltet ingen verdi i malene, så sørg for at temaet også fungerer når feltet er tomt.

For temautviklere: Bruk av data i maler

I Smarty-maler hentes verdiene med metoden getExtensionValue('felt_id'). Metoden er tilgjengelig for produkter, kategorier, landingssider, statiske sider og blogginnlegg. Hvis feltet ikke er fylt ut, returnerer den false. Et bool-felt gir «true» eller «false», et tallfelt gir et heltall, et bildefelt gir et bilde, og image- og multi-feltene gir en liste.

Enkel tekstverdi:

<{$product->getExtensionValue('youtube_id')}>

Betinget visning (bool):

<{if $product->getExtensionValue('show_badge')}>
    <span style="background:<{$product->getExtensionValue('badge-bg')}>; color:<{$product->getExtensionValue('badge-color')}>">
        <{$product->getExtensionValue('badge')|escape}>
    </span>
<{/if}>

Enkeltbilde:

<{if $img = $product->getExtensionValue('img')}>
    <img src="<{$img->getSrc(400, 400, 'fit')}>">
<{/if}>

Flere bilder (galleri):

<{foreach $product->getExtensionValue('gallery') as $image}>
    <img src="<{$image->getSrc(200, 200, 'box')}>">
<{/foreach}>

Dato med formatering:

<{$product->getExtensionValue('release_date')|date_format:'%d/%m/%Y'}>

Hvis du fjerner et felt fra JSON-filen, forblir de lagrede verdiene. Feltet forsvinner fra admin og fra REST API-et, men getExtensionValue() kan fortsatt lese verdien. Fjern derfor også bruken i malene hvis feltet ikke lenger skal ha noen effekt.

Repeteringsfelt (repeater)

Repeater-felt gir mulighet til å legge til et dynamisk antall grupper av felt. Dette er nyttig for eksempel for en liste over funksjoner, spesifikasjoner eller fordeler ved et produkt, der hvert element kan ha sin egen tittel, beskrivelse og eventuelt et ikon.

JSON-definisjon av et repeater-felt:

{
  "title": "Funksjoner",
  "id": "features",
  "type": "repeater",
  "field_title": "Funksjon",
  "description": "Legg til funksjoner for produktet",
  "fields": [
    { "id": "title", "type": "text", "title": "Tittel", "placeholder": "F.eks.: Vanntett" },
    { "id": "description", "type": "longtext", "title": "Beskrivelse" },
    { "id": "icon", "type": "image", "title": "Ikon" }
  ]
}

Repeater-felt har følgende tilleggsfunksjoner:

• fields: en matrise av underfelt (støtter text, richtext, longtext, number og image).
• field_title: tittelen som vises for hvert element i admin (f.eks. «Funksjon»).

I admin vises repeater-felt som kort som kan legges til, slettes og flyttes ved hjelp av dra-og-slipp. Som butikkeier klikker du på «Legg til»-knappen for å opprette et nytt element og fyller ut underfeltene.

Bruk av repeater-data i maler:

<{foreach $product->getExtensionValue('features') as $feature}>
    <h3><{$feature.title|escape}></h3>
    <p><{$feature.description|escape|nl2br}></p>
    <{if $feature.icon}>
        <img src="<{$feature.icon->getSrc(64, 64, 'fit')}>">
    <{/if}>
<{/foreach}>

Temainnstillinger for andre objekttyper

Feltene fungerer ikke bare på produkter. Temaet kan definere felt for flere objekttyper, og metoden getExtensionValue() er tilgjengelig på alle støttede objekter:

• Kategorier: defineres i extensions/category.json. Bruk: $category->getExtensionValue('felt_id')
• Landingssider: defineres i extensions/landing_page.json. Bruk: $landing_page->getExtensionValue('felt_id')
• Statiske sider: defineres i extensions/static_page.json. Bruk: $page->getExtensionValue('felt_id')
• Blogginnlegg: defineres i extensions/blog_post.json. Bruk: $blog_post->getExtensionValue('felt_id')

JSON-strukturen og felttypene er identiske for alle objekttyper.

For utviklere: REST-API

Feltene kan også leses og skrives via REST-API-et i feltet extension_data på produkter, kategorier, blogginnlegg, statiske sider og landingssider. Bare felter som er definert i temaets JSON-fil, blir inkludert. Dette er praktisk når mange produkter skal ha det samme feltet utfylt.

AJAX-filtrering med utvidelsesfelt

Produkter kan filtreres etter verdiene ved hjelp av AJAX-filtrering. Dette gjør det mulig å lage filtre i nettbutikken basert på temaspesifikke felt.

Syntaksen bruker «extension.» som prefiks i URL-parametrene:

?extension.youtube_id=abc123
?extension.show_badge=1

Dette gir temautviklere muligheten til å lage avanserte filtreringsopplevelser som er skreddersydd til den enkelte nettbutikkens behov.

Ofte stilte spørsmål

Hvor har «Utvidelser fra temaet ditt» blitt av på produktsiden?

Fanen heter nå «Temainnstillinger » og ligger mellom fanene «Felter» og «Intern søk». Navnet er endret overalt: på produkter, kategorier, statiske sider, landingssider og blogginnlegg. Feltene og de lagrede verdiene dine er de samme som før, med mindre temaet ditt har fjernet et felt.

Jeg bruker Montana og ser ikke «Temainnstillinger» på kategoriene mine. Er det noe galt?

Nei. Montana og MontanaB2B har kun felt på produkter, og fanen vises bare når temaet har felt for den typen side. Feltene på kategorier og sider er fjernet, fordi temaet ikke brukte dem til noe. Det du tidligere hadde lagret der, blir ikke slettet.

Vi hadde satt noen varer til «Kun henting» i Montana. Hva skjer nå?

Feltet viste bare teksten «Kun henting» ved lagerstatus på produktsiden. Det skjulte ikke de andre fraktalternativene i kassen, så kundene kunne fortsatt velge levering. Derfor er feltet fjernet, og teksten vises ikke lenger. Hvis en vare kun skal kunne hentes, må du skrive det tydelig i beskrivelsen og kontakte support@shoporama.dk hvis du er i tvil om fraktinnstillingene dine.

Hvor finner jeg YouTube-video-ID-en?

Åpne videoen på YouTube, og kopier den delen av adressen som står etter v=. I youtube.com/watch?v=dQw4w9WgXcQ er ID-en dQw4w9WgXcQ. Sett inn bare ID-en, ikke hele lenken. I Montana vises videoen i produktets bildegalleri.

Kan jeg fylle ut temainnstillinger for flere produkter samtidig?

I admin fyller du ut feltene for hvert enkelt produkt. Hvis mange produkter skal ha det samme, for eksempel samme merke, kan dette gjøres via REST API-et eller med Claude, hvis du styrer nettbutikken med AI. Hvis du kopierer et produkt, følger feltene med i kopien.

Jeg har fjernet et felt fra utvidelsesfilen min. Er dataene borte?

Nei. Verdiene blir liggende, men feltet vises ikke lenger i admin eller i REST API-et. Maler kan fremdeles lese verdien med getExtensionValue(), så fjern også bruken i temaet. Hvis du legger til feltet igjen med samme ID, dukker de gamle verdiene opp igjen.

Hva er forskjellen mellom temainnstillinger og tilleggsfelt?

Feltene i Temainnstillinger er ferdige felt fra temaet med en tittel, en forklaring og en fast plass i nettbutikken. Ekstra felt er dine egne nøkler og verdier, som du skriver inn i kortet «Felt», og som først vises når et tema eller et feed henter dem frem. Les mer under «Utvidede felt».

Har du spørsmål om temainnstillinger og temautvidelser? Kontakt oss på support@shoporama.dk.