Interface tagien tulostama HTML-koodi voidaan hakea myös osoitteen http://verkkokauppa.mycashflow.fi/interface/InterfaceTagi kautta. Voit lähettää ajax-kutsun tähän osoitteeseen JavaScriptillä tai hakea tiedot suoraan palvelinpuolen ohjelmointikielellä, kuten PHP:lla.
Interface tagin attribuutit voit antaa GET-parametreina lisäämällä osoitteen perään ?attribuutti1=arvo1. Jos parametrejä on useita, erottele ne & -merkillä. Esimerkiksi http://demo.mycashflow.fi/interface/NewProducts?limit=1 tai http://demo.mycashflow.fi/interface/NewProducts?limit=1&type=list
Esimerkkinä verkkokaupan uusien tuotteiden hakeminen
Ajaxilla (jQuery)
Ilman parametrejä:
$.get('http://demo.mycashflow.fi/interface/NewProducts', function(data) {
$('.result').html(data);
});
Parametrien kanssa:
$.get('http://demo.mycashflow.fi/interface/NewProducts', { limit : 1}, function(data) {
$('.result').html(data);
});
PHP:lla
Ilman parametrejä:
<?php
echo file_get_contents("http://demo.mycashflow.fi/interface/NewProducts");
?>
Parametrien kanssa:
<?php
echo file_get_contents("http://demo.mycashflow.fi/interface/NewProducts?limit=1");
?>
set-parametrit
Tuotteen Interface tagit, kuten {ProductName}, palauttavat sen tuotteen tiedot, jota asiakas on katsomassa. Kun kutsu tehdään /interface/ProductName osoitteen kautta täytyy halutun tuotteen yksillölinen id antaa setProduct-parametrina. Tällöin /interface/ProductName?setProduct=999 palauttaa saman kuin sivupohjassa oleva {ProductName} tagi osoitteessa /product/999/tuotenimi.
| Parametri | Vastaa osoitetta |
|---|---|
| setProduct=id | /product/id/... |
| setCategory=id | /category/id/... |
| setBrand=id | /brand/id/... |
| setPage=id | /page/id/... |
| setNewsItem=id | /news/id/... |
Rajoitukset ja tiedossa olevat puutteet
/interface/ osoitteen alta haettavissa tageissa on seuraavia tiedossa olevia puutteita ja rajoituksia:
- Tilauksien Interface tagit eivät ole käytettävissä
- CustomerNavigation, MiniCart, ShoppingCartTotal, ShoppingCartItems ja AdminTools tagien tulostus perustuu kävijäkohtaisen session tietoihin. Jos tageja kutsutaan palvelinpuolen ohjelmointikielellä (esim. PHP), niin kävijäkohtainen sessio täytyy välittää erikseen tai tagit eivät toimi oikein. Tämä rajoitus ei koske ajax-kutsuja.
- Kaupan sisäiset linkit ja polut kuviin on määritelty suhteellisena verkkotunnuksen juureen, esim.
href="http://www.mycashflow.fi/interface/product/id/tuotenimi". Kun tagin tulostus näytetään toisen verkkotunnuksen alla, tulee linkkien ja kuvien polun alkuun lisätä verkkotunnus.