Variabler i ett Shoporama-tema

Det finns i allmänhet två typer av variabler i Shoporama-teman: globala variabler, som finns på alla sidor, och variabler som bara finns på utvalda sidor. De globala variablerna är variabler som t.ex. korginnehåll, medan de andra är landningssidan eller produkten som visas. Nedan följer en lista på variabler som finns med när mallar körs via webben, alltså inte i e-postmeddelanden.

Om variabeln innehåller ett objekt finns metoderna för objektet i vår översikt över mall-API:et.

Generellt rekommenderar vi också att ni tar en titt på vårt Alaska-tema som är fritt nedladdningsbart och som innehåller exempel på hur följande fungerar.

Globala variabler

$webshop, den webbshop som visas.

$inc, vilken typ av sida som körs. Värdena för denna kan vara also, search, basket, address, shipping, approve, payment, thanks, order, product_review, subscription, blog, user-sign-up, user-sign-in, user-sign-out, user-edit, user-reset-password, user-profile, user-orders, user-subscriptions, user-change-card.

$shipping, den valda frakten.

$frontpage, om en statisk sida har valts som förstasida.

$pager_array, om den sida som visas innehåller sidindelning. Innehållet är max, current, total, url, first_url.

$pager, personsökarobjekt.

$current_url, den absoluta webbadressen för den sida som visas.

$top_url, aktuell relativ webbadress.

$get, $post, $cookie. En array som innehåller värdena för GET, POST respektive COOKIE.

$user_id, användar-ID om kunden är inloggad.

$customer, kunden om den är inloggad.

$remote_addr, kundens ip-adress.

$selected_payment_gateway, id för den gateway som valts.

$join_mailinglist, om kunden har markerat att de vill gå med i nyhetsbrevet.

$basket_url, webbadressen till korgen och dess innehåll.

$campaign_ids, kampanj-ID om produkterna i korgen matchar en kampanj.

$campaigns, om det finns en aktiv kampanj.

$campaign_discount, rabatten från de aktiva kampanjerna.

$campaign_matches, en array av produkter som matchar en kampanj. Om det inte finns några produkter är variabeln null.

$unpaid_order, om kunden (via stängd korg) har en obetald order.

$unpaid_recurring_order, obetald prenumeration.

$basket, innehållet i korgen som en array, där de enskilda elementen är produkterna i korgen, med värdena:

id, unikt id för raden

product_id, produktens id

in_stock, true/false om produkten finns i lager

product, produkten

attributes, attribut för produkten

own_id, sku-numret

amount, beloppet i korgen

comment, kommentar om tillämpligt

bundle, produktens array om produkten är en bundle

$subscriptions, korgens prenumerationer.

$price, delsumman av korgens innehåll.

$shipping_price, fraktpriset.

$total_price, det totala priset för korgens innehåll.

$vat, momsen på korgens innehåll.

$basket_weight, korgens totala vikt (för t.ex. frakt).

$total_amount, det totala antalet produkter i korgen.

$voucher, rabattkoden om det finns en sådan.

$voucher_discount, rabatten från rabattkoden.

$shipping_country, det valda leveranslandet.

$nofollow, true/false beroende på om nofollow är inställt på sidan.

$meta_title, sidans titel.

$meta_description, beskrivning av sidan.

$canonical, webbadress till canonical.

$session_order, array med faktureringsadress.

$session_del, array med leveransadress.

$session_extra, array med extra fält på ordern. Om ett fält med extra[test]=123 läggs upp kommer $session_extra.test att vara 123 och lagras på ordern.

Variabler per undersida

Att namnge filer i ett Shoporama-tema är valfritt. Vissa filer är dock obligatoriska, t.ex. måste det finnas en global.html, som är ansvarig för exekveringen av alla andra filer. Det faktiska innehållet på sidan finns i $contents, och det innehållet kommer från index.html. Om du inte använder vår Theme Builder måste index.html vanligtvis kontrollera vilken typ av sida som visas och sedan visa innehållet. Till exempel

<{if $product}> <{include file="product.html" product=$product}> <{/if}>

product.html kommer därefter att vara ansvarig för att visa produkten. En klassisk inställning skulle vara:

<{if $inc}> <{include file=$inc}> <{elseif $category}> <{if $category->isFront()}> <{include file="front.html" category=$category}> <{else}> <{include file="category.html" category=$category}> <{/if}> <{elseif $landing_page}> <{include file="landing_page.html" landing_page=$landing_page}> <{elseif $product}> <{include file="product.html" product=$product}> <{elseif $page}> <{include file="page.html" product=$page}> <{elseif $blog_post}> <{include file="blog_post.html" product=$blog_post}> <{/if}>

Observera att $inc är lite speciell eftersom det är den som exekverar basket.html om du befinner dig i korgen.

Om Theme Builder används måste temat först vara skrivet i Bootstrap, sedan måste det innehålla en extra fil som heter default_contents.html, som har samma innehåll som index.html tidigare hade. Index.html bör nu innehålla följande:

<{if $tb_contents}> <{$tb_contents}> <{else}> <{include file="default_contents.html"}> <{/if}>

Där $tb_contents är innehållet från Theme Builder.

Frakt

$shops, tillgängliga paketbutiker.

$shipping_module, namnet på fraktmodulen. Till exempel gls.

$xml_url, webbadress för uppslagning av fraktbutiker, om tillgänglig.

$no_shops, true/false beroende på om det finns tillgängliga paketbutiker.

$bird_delivery, true/false. Om Burd-leverans är tillgänglig på den valda leveransadressen.

Adress

Inga andra variabler än de globala.

Godkänna

Inga andra variabler än de globala.

Även

$product, den produkt som just lagts till i korgen.

Blogg

$blog_posts, array av blogginlägg.

Blogginlägg

$blog_post, det blogginlägg som visas.

Kategori $category

$category, den kategori som visas.

$products, array av produkter.

Front

$category, kategorin.

Landningssida

$landing_page, den landningssida som visas.

$meta, array av extra fält

$products, matris med produkter.

Sidan

$page, den statiska sidan som visas.

Produkt

$product, den produkt som visas.

$meta, array av extra fält

Beställning

$order, beställningen.

Produktgranskning

$order, den order som granskas.

Sök

$products, array av produkter.

$landing_pages, uppsättning landningssidor.

$categories, array av kategorier.

$count, antal resultat.