Temainställningar för produkter och sidor (tematillägg)

Vad är temainställningar för produkter och sidor?

Tematillägg (på engelska extensions) är extra fält som ditt tema tillhandahåller på produkter, kategorier, landningssidor, statiska sidor och blogginlägg. I admin finns fälten i kortet Temaninställningar, som tidigare hette ”Tillägg från ditt tema”. Det är temautvecklaren som definierar fälten, och som butiksägare fyller du i dem direkt i admin, t.ex. på produktens redigeringssida.

Typiska exempel är ett fält för en YouTube-video, en badge med text och färg, tilläggsprodukter till produkten eller en lista över egenskaper med titel, beskrivning och ikon. Temat använder de uppgifter du anger för att visa extra innehåll i webbutiken.

För butiksägare: Så här använder du temainställningarna

När du redigerar en produkt hittar du kortet Temaninställningar mellan korten Fält och Intern sökning, samt som genväg i menyn till höger. Klicka på kortet för att fälla ut det. Fälten är samlade i grupper med en rubrik, t.ex. Video, Badge och Tillval. För kategorier, statiska sidor, landningssidor och blogginlägg ligger kortet direkt under Allmänt.

Fyll i fälten efter behov. Vissa fält är enkla textfält, andra är färgväljare, bilduppladdningar eller kryssrutor. Varje fält har en titel och oftast en förklaring som beskriver vad det används till.

När du sparar sparas fälten tillsammans med produkten eller sidan, och temat använder dem för att visa relevant innehåll i webbutiken. Till exempel visar ett ifyllt YouTube-video-ID i Montana en video i produktens bildgalleri. Textfält på produkter ingår dessutom i webbutikens interna sökfunktion, såvida inte temautvecklaren har inaktiverat detta.

Du kan också använda produktfält på en landningssida. Välj regeln Utökat produktfält så visar landningssidan de produkter som har ett visst värde i fältet.

Temainställningar i Montana och MontanaB2B

I Montana och MontanaB2B är fälten på danska och förklaras direkt i admin. För produkter finns tre grupper:

• Video: fältet ”YouTube-video-ID”. ID:t är den sista delen av YouTube-länken, så i youtube.com/watch?v=dQw4w9WgXcQ är ID:t dQw4w9WgXcQ. Videon visas i produktens bildgalleri.
• Badge: fälten Badgetext, Badgebakgrundsfärg och Badgetextfärg. Badgen visas som en märkning på produktbilden, t.ex. Nyhet eller Endast online.
• Tilläggsprodukter: fältet Produkt-id:n för tilläggsprodukter. Ange id:n för de produkter som kunden kan lägga i varukorgen tillsammans med denna produkt, åtskilda med kommatecken, t.ex. 123,456. Produkt-id:et anges i adressfältet när du redigerar en produkt, och tillägg med varianter får en egen variantväljare. Läs mer under Tillägg på produktsidan.

Fält som inte fungerade som avsett har tagits bort från Montana och MontanaB2B:

• Kommentarfältet för produkten. Om kunden ska skriva en text till varan, t.ex. för en gravyr, ska du istället använda kundinmatning för produkter.
• Endast avhämtning, som endast visade lagerstatus på produktsidan och inte döljde de andra fraktalternativen i kassan.
• Dölj visningen av samlingspaket och dölj prislistor för mängdrabatt och varianter.
• Alla fält på kategorier, statiska sidor, blogginlägg och landningssidor. Därför visar Montana och MontanaB2B inte längre kortet Temainställningar där.

Data som du tidigare har sparat i fälten raderas inte, men de visas inte längre i admin, och temat använder dem inte. Om du använder din egen, anpassade kopia av Montana, förblir dina fält oförändrade, eftersom Shoporama inte ändrar butikernas egna teman. Andra teman, t.ex. Delaware, DelawareDK, California och Alaska2, har sina egna fält.

Stödda fälttyper

Temainställningarna stöder ett stort antal fälttyper:

• text: ett enkelt textfält för korta värden (t.ex. ett video-ID eller en badge-text).
• richtext: en HTML-redigerare med formateringsmöjligheter för längre texter med fetstil, kursiv stil, länkar m.m.
• longtext: ett stort textfält (textarea) för längre texter utan HTML-formatering.
• number: ett talfält för numeriska värden.
• bool: en kryssruta för ja/nej-värden (t.ex. ”Visa badge”).
• color: en färgväljare för att välja färger visuellt (t.ex. bakgrundsfärg för en badge).
• list: en rullgardinsmeny med fördefinierade alternativ.
• multi: flera kryssrutor för att välja flera alternativ samtidigt.
• image: uppladdning av en enskild bild.
• images: uppladdning av flera bilder (t.ex. ett galleri).
• date: ett datumväljare.
• datetime: en datum- och tidsväljare.
• repeater: upprepningsfält som gör det möjligt att lägga till ett dynamiskt antal grupper av fält (se separat avsnitt nedan).

För temautvecklare: Definition av fält

Fälten definieras i JSON-filer i temats mapp extensions/. Filen namnges efter den typ av objekt som fälten gäller för:

• extensions/product.json: produkter
• extensions/category.json: kategorier
• extensions/landing_page.json: landningssidor
• extensions/static_page.json: statiska sidor
• extensions/blog_post.json: blogginlägg

Om filen inte finns eller endast innehåller en tom array, [], har temat inga fält av den typen, och kortet Tematinställningar visas inte i admin. Montana och MontanaB2B har till exempel tomma filer för kategorier, landningssidor, statiska sidor och blogginlägg.

JSON-filen är en array av grupper. Varje grupp har ett namn, en valfri beskrivning och en lista med fält. Namnet visas som rubrik i kortet, och en beskrivning visas efter namnet. Här är ett utdrag från Montana:

[
    {
        "name": "Video",
        "description": "",
        "fields": [
            {
                "title": "YouTube-video-ID",
                "description": "ID:t från YouTube-länken. I youtube.com/watch?v=dQw4w9WgXcQ är ID:t dQw4w9WgXcQ. Videon visas i produktens bildgalleri.",
                "id": "youtube_id",
                "type": "text"
            }
        ]
    },
    {
        "name": "Badge",
        "description": "",
        "fields": [
            {
                "title": "Badge-text",
                "description": "Visas som en märkning på produktbilden, t.ex. Nyhet eller Endast online.",
                "id": "badge",
                "type": "text"
            },
            {
                "title": "Badge-bakgrundsfärg",
                "id": "badge-bg",
                "type": "color",
                "default_value": "#fef3c7"
            },
            {
                "title": "Badge-textfärg",
                "id": "badge-color",
                "type": "color",
                "default_value": "#92400e"
            }
        ]
    }
]

Varje fält stöder följande egenskaper:

• id (obligatoriskt): unikt ID, används för att hämta värdet i mallar.
• title (obligatoriskt): etikett som visas i admin.
• type (obligatoriskt): fälttyp (se listan ovan).
• description: hjälptext som visas under fältet. Skriv den till butiksägaren så att det framgår tydligt vad fältet gör i butiken.
• placeholder: platshållartext i inmatningsfältet.
• default: standardvärde för text, longtext, richtext, number, date och datetime.
• default_value: standardvärde för color. Utan standardvärde startar färgväljaren på svart.
• options: alternativ för list- och multi-typer (objekt med nyckel/värde-par).
• searchable: gäller endast produkter. Text-, lista- och multival-fält inkluderas automatiskt i webbutikens interna sökfunktion. Ange "searchable": false för att utesluta ett fält.

Standardvärdet fylls i i admin och sparas först när produkten eller sidan sparas. Fram till dess har fältet inget värde i mallarna, så se till att temat fungerar även när fältet är tomt.

För temautvecklare: Användning av data i mallar

I Smarty-mallar hämtas värdena med metoden getExtensionValue('fält_id'). Metoden är tillgänglig för produkter, kategorier, landningssidor, statiska sidor och blogginlägg. Om fältet inte är ifyllt returnerar metoden false. Ett bool-fält ger true eller false, ett number-fält ett heltal, ett image-fält en bild och images- och multi-fält en lista.

Enkel textvärde:

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

Villkorlig 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}>

Enkel bild:

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

Flera bilder (galleri):

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

Datum med formatering:

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

Om du tar bort ett fält från JSON-filen finns de sparade värdena kvar. Fältet försvinner från admin och från REST API:et, men getExtensionValue() kan fortfarande läsa värdet. Ta därför även bort användningen i mallarna om fältet inte längre ska ha någon effekt.

Repetitionsfält (repeater)

Repeater-fält gör det möjligt att lägga till ett dynamiskt antal grupper av fält. Det är användbart för exempelvis en lista över funktioner, specifikationer eller fördelar med en produkt, där varje element kan ha sin egen titel, beskrivning och eventuellt en ikon.

JSON-definition av ett repeater-fält:

{
  "title": "Funktioner",
  "id": "features",
  "type": "repeater",
  "field_title": "Funktion",
  "description": "Lägg till funktioner till produkten",
  "fields": [
    { "id": "title", "type": "text", "title": "Titel", "placeholder": "T.ex.: Vattentät" },
    { "id": "description", "type": "longtext", "title": "Beskrivning" },
    { "id": "icon", "type": "image", "title": "Ikon" }
  ]
}

Repeater-fält har följande ytterligare egenskaper:

• fields: en array av underfält (stöder text, richtext, longtext, number och image).
• field_title: den titel som visas för varje element i admin (t.ex. "Feature").

I admin visas repeater-fält som kort som kan läggas till, raderas och flyttas med dra-och-släpp. Som butiksägare klickar du på knappen "Lägg till" för att skapa ett nytt element och fyller i underfälten.

Användning av repeater-data i mallar:

<{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}>

Temainställningar för andra objekttyper

Fälten fungerar inte bara för produkter. Temat kan definiera fält för flera objekttyper, och metoden getExtensionValue() är tillgänglig för alla objekt som stöds:

• Kategorier: definieras i extensions/category.json. Användning: $category->getExtensionValue('fält_id')
• Landningssidor: definieras i extensions/landing_page.json. Användning: $landing_page->getExtensionValue('fält_id')
• Statiska sidor: definieras i extensions/static_page.json. Användning: $page->getExtensionValue('fält_id')
• Blogginlägg: definieras i extensions/blog_post.json. Användning: $blog_post->getExtensionValue('fält_id')

JSON-strukturen och fälttyperna är identiska för alla objekttyper.

För utvecklare: REST API

Fälten kan även läsas och skrivas via REST API:et i fältet extension_data för produkter, kategorier, blogginlägg, statiska sidor och landningssidor. Endast fält som är definierade i temats JSON-fil ingår. Detta är praktiskt när många produkter ska ha samma fält ifyllt.

AJAX-filtrering med tilläggsfält

Produkter kan filtreras efter värdena via AJAX-filtrering. Det gör det möjligt att skapa filter i webbutiken baserade på temaspecifika fält.

Syntaxen använder ”extension.” som prefix i URL-parametrarna:

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

Detta ger temautvecklare möjlighet att skapa avancerade filtreringsupplevelser som är skräddarsydda efter den enskilda webbutikens behov.

Vanliga frågor

Var har ”Tillägg från ditt tema” tagit vägen på produktsidan?

Fliken heter nu Tema-inställningar och ligger mellan flikarna Fält och Intern sökning. Namnet har ändrats överallt: på produkter, kategorier, statiska sidor, landningssidor och blogginlägg. Fälten och dina sparade värden är desamma som tidigare, såvida inte ditt tema har tagit bort ett fält.

Jag använder Montana och kan inte se "Temainställningar" på mina kategorier. Är det något fel?

Nej. Montana och MontanaB2B har endast fält på produkter, och kortet visas endast när temat har fält för den typen av sida. Fälten på kategorier och sidor har tagits bort eftersom temat inte använde dem till något. Det du tidigare hade sparat där raderas inte.

Vi hade ställt in vissa varor på ”Endast avhämtning” i Montana. Vad händer nu?

Fältet visade endast texten ”Endast avhämtning” vid lagerstatus på produktsidan. Det döljde inte de andra fraktalternativen i kassan, så kunderna kunde fortfarande välja leverans. Därför har fältet tagits bort och texten visas inte längre. Om en vara endast ska kunna hämtas, ange detta tydligt i beskrivningen och kontakta support@shoporama.dk om du är osäker på dina fraktinställningar.

Var hittar jag YouTube-videons ID?

Öppna videon på YouTube och kopiera den del av adressen som står efter v=. I youtube.com/watch?v=dQw4w9WgXcQ är id:et dQw4w9WgXcQ. Ange endast id:et, inte hela länken. I Montana visas videon i produktens bildgalleri.

Kan jag fylla i temainställningarna för flera produkter samtidigt?

I admin fyller du i fälten för varje enskild produkt. Om flera produkter ska ha samma inställningar, t.ex. samma badge, kan detta göras via REST API:et eller med Claude, om du styr butiken med AI. Om du kopierar en produkt följer fälten med i kopian.

Jag har tagit bort ett fält från min extensions-fil. Har uppgifterna försvunnit?

Nej. Värdena finns kvar, men fältet visas inte längre i adminpanelen eller i REST API:et. Mallar kan fortfarande läsa värdet med getExtensionValue(), så ta bort användningen även i temat. Om du lägger till fältet igen med samma ID dyker de gamla värdena upp igen.

Vad är skillnaden mellan temainställningar och extrafält?

Fälten i Temainställningar är färdiga fält från temat med en titel, en förklaring och en fast plats i webbutiken. Extra fält är dina egna nycklar och värden som du skriver in i kortet Fält och som först visas när ett tema eller ett flöde hämtar dem. Läs mer under Utökade fält.

Har du frågor om temainställningar och temautvidgningar? Kontakta oss på support@shoporama.dk.