Tulostaa laajennuksien tuottamaa ja käyttämää sisältöä. {Extensions}-tagia suositellaan käytettäväksi aina laajennuksien omien tagien sijaan.

Kuvaus

Tämä tagi on pakollinen. Tagin jättäminen pois kaupan teemasta voi aiheuttaa merkittäviä ongelmia verkkokaupan käytettävyydessä ja ylläpidossa.

Laajennuksien tuottamaa sisältöä ovat esimerkiksi Facebook-laajennuksen OpenGraph-data ja Google Analyticsin (ja muiden seurantatyökalujen) skriptit.

Käytä {Extensions}-tagia teemassa aina kun verkkokaupassa on käytössä jokin laajennus.

Katso lisätietoja laajennuksien käyttöohjeista.

{Extensions}-tagi sijoitetaan tarpeen mukaan eri osiin HTML-dokumenttia (katso tarkemmat ohjeet).

Syntaksi

{Extensions(
    for: string,
    exclude: string
)}

Näkyvyys

Toimii näkyvyydessä: globaali

Tagia käytetään vain <head>-elementin lopussa tai <body>-elementin alussa. Katso tarkemmat ohjeet alta.

Laajennustuen lisääminen kaupan teemaan

{Extensions}-tagin avulla lisätään teemaan edellytykset käyttää useita MyCashflow'n laajennuksia verkkokaupassa. Seuraavissa esimerkeissä havainnollistetaan tagin käyttöä. MyCashflow'n kaikissa valmisteemoissa tagia on käytetty esimerkkien mukaisesti.

Varmista että teema sisältää molemmat seuraavista merkkauksista, jotta kaikki laajennusten tarvitsemat työkalut ja komponentit ovat saatavilla teemassa.

<head>-elementissä tagi sijoitetaan juuri ennen elementin loppua ja määritetään attribuutti for: 'head'

    {Extensions(
        for: 'head'
    )}
</head>
<body>               

<body>-elementtiin tulostettaessa tagi taas sijoitetaan heti avaavan <body>-tagin jälkeen ja määritetään attribuutti for: 'body'

</head>
<body>
    {Extensions(
        for: 'body'
    )}                  

Esimerkiksi MyCashflow'n Barebones-teemassa yllä mainitut elementit sijaitsevat tiedostossa helpers/header.html

Tuotetietojen piilottaminen Googlen Hausta

Voit piilottaa verkkokaupan tuotteiden tiedot Googlen Hausta määrittämällä {Extensions}-tagille attribuutin exclude: 'schema'

Attribuutti poistaa sivulta MyCashflow'n Schema.org-merkkauksen, josta Google lukee tuotteiden tiedot hakutuloksiin.

...
    {Extensions(
        for: 'head',
        exclude: 'schema'
    )}
</head>
<body> 

Attribuutit

for:

Määrittää tulostettavan sisällön sijainnin HTML-dokumentissa.

Sallitut arvot:
  • 'head': Sisältö tulostetaan HTML-dokumentin <head>-elementtiin.

    Käytä tällöin tagia <head>-elementin lopussa.

  • 'body': Sisältö tulostetaan HTML-dokumentin <body>-elementtiin.

    Käytä tällöin tagia <body>-elementin alussa.

exclude:

Määrittää komponentit, jotka suljetaan pois tagin tulostamasta sisällöstä.

Sallitut arvot:
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.'