Redakční systémy - Joomla, Wordpress, Drupal

V dnešním krátkém článku si ukážeme jak vytvořit skript který nám bude generovat XML soubor, který budeme posílat na zbozi.cz. Nejdříve se tedy podíváme jak by vlastně takový XML soubor měl vypadat.

1) Jako první vkládáme hlavičku s kódováním:

<?xml version="1.0" encoding="windows-1250"?>

2) Poté vložíme tag <SHOP> mezi který budeme vkládat jednotlivé zboží

3) Jednotlivé položky oddělujeme tagem <SHOPITEM>, mezi tento tag vkládámejednotlivé parametry zboží. Výsledný kód pro jeden produkt tedy může vypadat například takto:

<?xml version="1.0" encoding="windows-1250"?>

<SHOP>

<SHOPITEM>

<PRODUCT>Světélkující podložka pod myš</PRODUCT>

<DESCRIPTION>Fosforeskující okraj, nevyžaduje baterie.</DESCRIPTION>

<URL>http://obchod.cz/podlozky-pod-mys/fosfor</URL>

<ITEM_TYPE>new</ITEM_TYPE>

<AVAILABILITY>24</AVAILABILITY>

<IMGURL>http://obchod.cz/obrazky/podlozky-pod-mys/fosfor.jpg</IMGURL>

<PRICE>620</PRICE>

<PRICE_VAT>756</PRICE_VAT>

</SHOPITEM>

</SHOP>

Nyní si vysvětlíme význam jednotlivých tagů:

SHOP - kořenová značka, v jejímž rámci je vše ostatní

SHOPITEM - v jejím rámci jsou informace týkající se jednoho výrobku

DUES /povinné - pokud se poplatky vztahují k nabízenému sorimentu a nejsou již obsaženy v ceně. Součet ceny všech poplatků, které je nutné zaplatit při zakoupení výrobku (cena uvedena včetně DPH, nezahrnuje dopravu a balné)

DISCUSSION_SIZE /nepovinné - počet příspěvků v diskuzi na stránkách obchodu k tomuto produktu

DISCUSSION_URL /nepovinné - URL stránky diskusního fóra k danému produktu

AVAILABILITY /nepovinné - dostupnost zboží jako číselná hodnota vyjadřující hodiny

• 0 = skladem
• 1 - 72 = do 3 dnů
• 73 - 168 = do týdne
• 169 a více = více než týden

SHOP_DEPOTS /nepovinné - identifikátor kamenných poboček, ve kterých je položka skladem. Jednotlivé identifikátory jsou odděleny středníkem. Vztahuje se pouze k jednomu IČ obchodu a jeho provozovnám. Identifikátor se přiděluje na žádost až po úspěšné registraci.

PRODUCT /povinné - stručný název výrobku (délky do 64 znaků)

DESCRIPTION /povinné - popis výrobku (délky do 512 znaků)

URL /povinné - odkaz na stránku s nabídkou daného výrobku

IMGURL /nepovinné - odkaz na obrázek výrobku

PRICE /nepovinné - v případě, že je uvedena značka PRICE_VAT - Cena v Kč bez DPH

VAT /nepovinné - v případě, že je uvedena značka PRICE_VAT – sazba DPH, hodnota se uvádí např. 19 nebo 0.19. Oba zápisy jsou ekvivalentní a představují sazbu 19 procent.

PRICE_VAT /nepovinné - v případě, že je uvedena značka PRICE a značka VAT - Cena v Kč s DPH

ITEM_TYPE /nepovinné - v případě, že je zboží nové - Typ zboží, jedna z hodnot: new (nové), bazaar (použité, renovované, repasované, bazarové), defaultní hodnota new

TOLLFREE /nepovinné - pouze pro obchody s placenou službou Zboží Standard - Pokud má obchod aktivovány přednostní výpisy, položka NEBUDE upřednostněna a proklik NEBUDE zpoplatněn. Hodnota se uvádí 1.

FIRMY_CZ /nepovinné - Obchod, který má zápis ve firmách může určit, jaké zboží bude v detailu a to tak, že ve svém XML feedu přidá k pěti vybraným položkám tag <FIRMY_CZ></FIRMY_CZ>, který má hodnoty 0 - nezobrazující se ve firemním detailu (default) , 1 - zobrazující se v detailu.

Toto jsou všechny tagy, které můžete používat,  klasicky se ovšem používá formá, který je uveden nahoře jako příklad zobrazení produktu. Nyní jdeme na samotný skript pro vytváření XML souboru. Tento skript byl publikován na fóru stránek prestashop.com, není tedy z mojí hlavy, ale je odzkoušen a funguje. Vytvoříme si v kořenovém adresáři nějaký adresář nezáleží na jménu, například xml a vložíme do něj tento php skript, můžeme ho nazvat třeba xml.php, jeho kód bude následující:

<?php
include(dirname(__FILE__).'/../config/config.inc.php'); // cesta k vasemu config souboru
$p=Product::getProducts(3, 0, 0, 'id_product', 'desc', false); //3 je id ceskeho jazyka v databazi
$products=Product::getProductsProperties(3, $p); //  3 je id ceskeho jazyka v databazi
header("Content-Type: text/xml");
echo '<?xml version="1.0" encoding="utf-8"?><SHOP>';
foreach ($products as $row) {
$img=Product::getCover($row['id_product']);
echo '
<SHOPITEM>
    <PRODUCT>'.str_replace("&","&", $row['name']).'</PRODUCT>
    <DESCRIPTION>'.str_replace(strip_tags( "&","&", $row['description_short'])).'</DESCRIPTION>
    <URL>http://www.vasedomena.cz'.$row['link'].'</URL>
    <IMGURL>http://www.vasedomena.cz/img/p/'.$row['id_product'].'-'.$img['id_image'].'.jpg</IMGURL>
    <PRICE_VAT>'.($row['price']*1).'</PRICE_VAT>
    <AVAILABILITY>0</AVAILABILITY>
</SHOPITEM>';
}
echo '</SHOP>';
?>  

Pokud chceme dostupnost produktu zobrazovat podle současných zásob vyměníme řádek AVAILABILITY za tento: 

<AVAILABILITY>’.($row[‘quantity’]).’</AVAILABILITY>

Pokud necháme 0, znamená to, že všechny produkty budeme uvádět jako že jsou skladem.  Dále je třeba změnit číslo na druhém a třetím řádku kódu, číslo udává id českého jazyka v databázi. Tabulka kde to můžeme zjistit se jmenuje ps_lang. Tím by měl generátor fungovat. Nyní stačí jen odkaz přidat na zbozi.cz, do kolonky URL feed v tomto případě zadáme adresu:

http://www.vasedomena.tld/xml/xml.php

To by bylo pro dnešek vše, v případě dotazů se obraťte do diskuze nebo napište komentář.