Variabler i et Shoporama-tema

Det finnes generelt to typer variabler i Shoporama-temaer: globale variabler, som finnes på alle sider, og variabler som bare finnes på utvalgte sider. De globale variablene er variabler som innholdet i handlekurven, mens de andre er landingssiden eller produktet som vises. Nedenfor finner du en liste over variabler som er til stede når maler kjøres via nettet, dvs. ikke i e-poster.

Hvis variabelen inneholder et objekt, finner du metodene på objektet i vår oversikt over mal-API-et.

Generelt anbefaler vi også at du tar en titt på Alaska-temaet vårt, som kan lastes ned gratis og inneholder eksempler på hvordan følgende fungerer.

Globale variabler

$webshop, nettbutikken som skal vises.

$inc, typen side som kjøres. Verdiene for denne kan også være , søk, kurv, adresse, frakt, godkjenne, betaling, takk, bestilling, produkt_anmeldelse, abonnement, blogg, bruker-registrering, bruker-pålogging, bruker-avmelding, bruker-redigering, bruker-tilbakestill-passord, bruker-profil, bruker-bestillinger, bruker-abonnementer, bruker-bytte-kort.

$shipping, den valgte forsendelsen.

$frontpage, hvis en statisk side er valgt som forside.

$pager_array, hvis siden som vises, inneholder sidevisning. Innhold er max, current, total, url, first_url.

$pager, personsøkerobjekt.

$current_url, den absolutte url-adressen til siden som vises.

$top_url, gjeldende relativ url.

$get, $post, $cookie. En matrise som inneholder verdiene for henholdsvis GET, POST og COOKIE.

Systemet angir følgende GET-parametere automatisk:

• payment_cancelled - settes til 1 når en kunde avbryter eller mislykkes i betalingsflyten. Bruk $smarty.get.payment_cancelled for å vise en feilmelding i temaet ditt.

$user_id, bruker-ID hvis kunden er logget inn.

$customer, kunden hvis kunden er innlogget.

$remote_addr, IP-adressen til kunden.

$selected_payment_gateway, id-en til den valgte gatewayen.

$join_mailinglist, om kunden har krysset av for at han eller hun ønsker å bli med i nyhetsbrevet.

$basket_url, nettadressen til handlekurven og innholdet i den.

$campaign_ids, kampanje-ID-er hvis produktene i handlekurven samsvarer med en kampanje.

$campaigns, hvis det finnes en aktiv kampanje.

$campaign_discount, rabatten fra de aktive kampanjene.

$campaign_matches, en matrise med produkter som matcher en kampanje. Hvis det ikke finnes noen produkter, er variabelen null.

$unpaid_order, hvis kunden (via lukket handlekurv) har en ubetalt bestilling.

$unpaid_recurring_order, ubetalt abonnement.

$basket, innholdet i handlekurven som en matrise, der de enkelte elementene er produktene i handlekurven, med verdiene:

id, unik id for linjen

product_id, id for produktet

in_stock, true/false hvis produktet er på lager

product, produktet

attributes, attributter for produktet

own_id, sku-nummeret

amount, beløpet i handlekurven

comment, kommentar, kommentar hvis aktuelt

bundle, matrise for produktet hvis produktet er en bundle

$subscriptions, kurvens abonnementer.

$price, delsummen av kurvinnholdet.

$shipping_price, fraktprisen.

$total_price, totalprisen for innholdet i handlekurven.

$vat, merverdiavgiften på innholdet i handlekurven.

$basket_weight, den totale vekten av handlekurven (for f.eks. frakt).

$total_amount, det totale antallet produkter i handlekurven.

$voucher, rabattkoden hvis det finnes en.

$voucher_discount, rabatten fra rabattkoden.

$shipping_country, det valgte fraktlandet.

$nofollow, true/false avhengig av om nofollow er angitt på siden.

$meta_title, tittelen på siden.

$meta_description, beskrivelse av siden.

$canonical, url til kanonisk.

$session_order, matrise med faktureringsadressen.

$session_del, matrise med leveringsadressen.

$session_extra, matrise med ekstra felt på bestillingen. Hvis et felt med extra[test]=123 er lagt inn, vil $session_extra.test være 123 og lagres på bestillingen.

Variabler per underside

Det er valgfritt å navngi filer i et Shoporama-tema. Noen filer er imidlertid påkrevd, f.eks. må det finnes en global.html, som er ansvarlig for kjøringen av alle andre filer. Det faktiske innholdet på siden ligger i $contents, og dette innholdet kommer fra index.html. Hvis du ikke bruker vår Theme Builder, må index.html vanligvis sjekke hvilken type side som skal vises, og deretter vise innholdet. For eksempel

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

product.html vil deretter være ansvarlig for å vise produktet. Et klassisk oppsett vil være:

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

Legg merke til at $inc er litt spesiell fordi det er den som kjører basket.html hvis du befinner deg i kurven.

Hvis Theme Builder brukes, må temaet først skrives i Bootstrap, og deretter må det inneholde en ekstra fil som heter default_contents.html, som har samme innhold som index.html hadde tidligere. Index.html skal nå inneholde følgende:

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

Der $tb_contents er innholdet fra Theme Builder.

Frakt

$shops, tilgjengelige pakkebutikker.

$shipping_module, navnet på fraktmodulen. For eksempel gls.

$xml_url, url for oppslag i fraktbutikk, hvis tilgjengelig.

$no_shops, true/false avhengig av om det finnes tilgjengelige pakkeshops.

$bird_delivery, true/false. Om Burd-levering er tilgjengelig på den valgte leveringsadressen.

Adresse

Ingen andre variabler enn de globale.

Approve

Ingen andre variabler enn de globale.

Også

$product, produktet som nettopp er lagt til i handlekurven.

Blogg

$blog_posts, en matrise med blogginnlegg.

Blogginnlegg

$blog_post, blogginnlegget som vises.

Kategori

$category, kategorien som vises.

$products, en matrise med produkter.

Front

$category, kategorien.

Landingsside

$landing_page, landingssiden som vises.

$meta, en matrise med ekstra felt

$products, en matrise med produkter.

Side

$page, den statiske siden som vises.

Produkt

$product, produktet som vises.

$meta, en matrise med ekstra felt

Bestilling

$order, bestillingen.

Produktanmeldelse

$ordre, ordren som gjennomgås.

Søk

$products, en matrise med produkter.

$landing_pages, matrise av destinasjonssider.

$categories, matrise av kategorier.

$count, antall resultater.