Tulostaa muotoiltavan listan tuotepaketeista, joihin näkymässä asetettu tuote kuuluu.

Kuvaus

Jos teeman asetuksissa on määritetty arvo <ProductBundles supported="false" />, {ProductShortDesc}-tagi tulostaa listan tuotepaketeista joihin tuote kuuluu.

Mikäli teeman asetuksissa on arvo <ProductBundles supported="true" />, {ProductShortDesc} ei tulosta tuotepaketteja, jolloin listaus on lisättävä teemaan {ProductBundles}-tagin avulla.

Mikäli jokin tuotepaketin sisältämistä tuotteista ei ole näkyvillä asiakkaan selaamassa versiossa, tuotepakettia ei näytetä listalla lainkaan.

Syntaksi

{ProductBundles(
    type: string,
    helper: string
)}

Näkyvyys

Toimii näkyvyydessä: tuote

Näkyvyys helper-attribuutissa: tuotepaketti

Tuotepakettien sisällyttäminen tuotelistoille

{ProductBundles}-tagin avulla voit tulostaa tuotepakettien tietoja tuotelistoille niin, että jokaisen listalla näytettävän tuotteen yhteydessä listataan tuotepaketit, joihin tuote kuuluu.

<!-- Päätuotelista -->
{Products(
    before: '<ul>',
    helper: 'helpers/list-product',
    after: '</ul>'
)}

<!-- helpers/list-product.html -->
<li>
    <a href="{ProductURL}">
        <h3>{ProductName}</h3>
        {ProductImage}
    </a>
    {ProductAddToCart}
    {ProductBundles(
        before: '
            <small><strong>Tuote kuuluu seuraaviin tuotepaketteihin:</strong></small>
            <ul>
        ',
        helper: 'helpers/product-bundle-list-item',
        after: '</ul>'
    )}
</li>

<!-- helpers/product-bundle-list-item.html -->
<li>
    <a href="{BundleURL}">
       <small>{BundleName}</small>
    </a>
</li>

Esimerkin sisäkkäiset helper-attribuutit eivät toimisi oikeasti, vaan ne tulee sijoittaa erillisiin tiedostoihin.

Tuotetietojen tulostaminen tuotepakettilistauksessa

Alla olevassa esimerkissä tulostetaan tuotteiden Vahvistin, Kitara ja 4x12-kaiutin jokainen tuotepaketti omana rivinään niin että jokaisella rivillä näytetään tuotteen ja tuotepaketin nimet.

{Products(
    id: 1|2|3,
    helper: 'helpers/list-product',
)}

<!-- helpers/list-product.html -->
{ProductBundles(
    helper: {{
        {ProductName}: {BundleName}
    }}
)}

Esimerkin sisäkkäiset helper-attribuutit eivät toimisi oikeasti, vaan ne tulee sijoittaa erillisiin tiedostoihin.

Tällöin tulostusmuoto olisi seuraavanlainen:

Vahvistin: Aloittelevan kitaristin kombo
Vahvistin: Metelipaketti
Kitara: Aloittelevan kitaristin kombo
Kitara: Metelipaketti
4x12-kaiutin: Metelipaketti



Esimerkissä kauppaan on siis luotu kaksi tuotepakettia, joiden sisällöt ovat seuraavat:

  • Aloittelevan kitaristin kombo (Vahvistin, Kitara)
  • Metelipaketti (Vahvistin, Kitara, 4x12-kaiutin)

Attribuutit

type:

Määrittää listan tulostusmuodon silloin, kun helper-attribuuttissa ei ole asetettu omaa merkkausta.

Sallitut arvot:

  • 'default': tulostetaan vain tuotepakettien nimet ja linkit <ul>-listana
  • 'normal': tulostetaan listalle tuotepaketin nimi ja kuva
helper:

Määrittää yksittäisen listaelementin sisällön ja tulostusmuodon.

Sallitut arvot: Interface- ja HTML-merkkaus, joilla määritellään tulostuksen merkkaus ja sisältö.

helper-attribuuttia on mahdollista käyttää kahdella tavalla:

  1. Voit kirjoittaa halutun merkkauksen suoraan attribuutin arvoksi tai
  2. Voit antaa attribuutin arvoksi viittauksen tiedostoon, joka sisältää halutun merkkauksen

    Anna viittaus suhteessa teeman juurihakemistoon.

Katso myös helper-attribuutin tarkemmat käyttöohjeet.

after/before:

after- ja before-attribuuteilla voit määritellä sisällön, joka tulostetaan ennen ja/tai jälkeen tagin tulostaman sisällön.

Sallitut arvot: HTML- ja Interface-merkkaus

Esim.:

  • before: '<p>Tämä merkkaus näytetään ennen tagin omaa sisältöä.</p>'
  • after: '<p>Tämä taas lisätään tagin oman sisällön jälkeen</p>'

after- ja before-attribuuttien sisältöä ei tulosteta, jos tagi itse ei tuota mitään sisältöä.

escape:

Asettaa tulostettavassa sisällössä pakomerkin ennen lainausmerkkejä.

Attribuutin tarkoitus on helpottaa tagin palauttaman sisällön käyttämistä JavaScriptin avulla.

Sallitut arvot: true / false. Oletusarvo false.

or:

Määrittää vaihtoehtoisen sisällön, joka näytetään mikäli tagi ei itse tuota mitään sisältöä.

Sallitut arvot: HTML- ja Interface-merkkaus

Esim. or: 'Sisältöä ei löytynyt.'