Export zboží pro vyhledávače Live demo
http://demo.nostresscommerce.cz/index.php/export/adminhtml_export/ login: admin; heslo: admin123
Popisek Modul umožňuje export produktů do XML souboru vhodném pro různé vyhledávače zboží (agregátory). Lze vytvořit libovolné množství profilů, přičemž pro každý profil lze zvolit typ exportu, kategorie, které se budou exportovat, název souboru a též frekvenci generování. Následně dochází ke generování XML souboru a je zobrazena jeho URL, kterou lze vložit již do vlastního vyhledávače. Pokud se produkt nachází ve více kategoriích, je exportován pouze jednou, a to v té kategorii, která je výše v hierarchii kategorií v Magento.
Návod na použití Po nainstalování modulu a obnovení cache paměti je možné přejít na vytváření/editaci profilů pro export produktů přes System -> Import/Export -> Export produktů pro vyhledávače.
Obrázek 1.1: Přístup k profilům Nejdříve je nutné vytvořit nový profil. Pomocí tlačítka „Přidat nový profil“ se spustí průvodce tvorbou profilu.
Obrázek 1.2: Vytvoření nového profilu
Tvorba profilu V prvním kroku se vybírá Store View, pro které se bude export provádět. Tento atribut profilu není možné později měnit.
Obrázek 1.3: Výběr Store View V dalším kroku se nastavují následující atributy:
Název profilu Status exportu – pro vypnutí/zapnutí pravidelného generování xml souboru Čas – čas kdy se bude spouštět generování Frekvence generování Název souboru Vyhledávač - vyhledávače se liší specifikací xml souboru, zobrazují se pouze nainstalované moduly Centrum category – speciální kategorie pouze pro vyhledavač Centrum.cz, slouží pro lepší zatřídění produktů do kategorii Kategorie pro export - do xml souboru se exportuji produkty z vybraných kategorií, pokud je vybraná nějaká kategorie exportují se produkty pouze z ní, podkategorie nejsou automaticky exportovány, musejí být také vybrány
Uložením nastavení se přejde zpět na přehled profilů.
Obrázek 1.4: Příklad nastavení profilu
Editace profilu V profilu je možné měnit všechna nastavení kromě Store View. Pokud je při editaci změněn jeden z atributů "Vyhledávač", "Centrum kategorie" nebo "Kategorie pro exportování", dojde ke smazání generovaného souboru (pokud existuje). Pokud se změní atribut "Název souboru", dojde pouze k přepsání názvu souboru. V ostatních případech se souborem není manipulováno.
Nastavení modulu Nastavení skriptu pro export produktů Toto nastavení je přístupné přes "System -> Nastavení -> Export produktů pro vyhledávače -> Vykonávání skriptu pro export produktů" (viz Obrázek 1.5). Nelze nastavit pro jednotlivá Store View. Nastavuje se pouze pro "Výchozí nastavení". Popis jednotlivých nastavení:
Počet produktů pro export v jednom cyklu
o o
Určuje maximální počet produktů načtených z databáze do paměti. Produkty se exportují z databáze po skupinách, protože se tím předejde případnému zahlcení paměti a nečekanému zastavení skripu pro export produktů.
Čas řádného zastavení skriptu (sekundy) o Určuje čas, který má skript na své řádné ukončení. o Doba běhu skriptu je omezena nastavením na serveru. o Pokud bude nastavena velká skupina v "Počet produktů pro export v jednom cyklu" a málo času na řádné ukončení, může skript skončit chybou. To může mít za následek nevyexportování některých produktů. o Doporučuje se ponechat nastavené hodnoty a případně měnit oba atributy současně.
Obrázek 1.5: Nastavení skriptu pro export produktů
Generování XML souboru XML soubor je možné vygenerovat manuálně pomocí stisknutí „Generate NOW“ v přehledu profilů na příslušném řádku. Další možností je automatické generování ve zvolený čas. V tomto případě je nutné mít správně nastavený Cron. Server musí přiměřeně často spouštět skript cron.php. Produkty jsou nejprve exportovány po malých skupinách do dočasného souboru. Pokud dojde k exportu všech zvolených produktů (v závislosti na vybraných kategoriích), dočasný soubor je přejmenován na požadované jméno. Tento postup je použit z důvodu časového limitu, kterým může být omezena doba běhu skriptu na serveru. Výsledný soubor tedy může být vytvořen až po několika spuštěních generačního procesu.
Obrázek 1.6: Manuální generování souboru
Automatické generování Pro automatické generování musí být nastavené automatické spouštění skriptu cron.php (viz http://www.magentocommerce.com/wiki/how_to/how_to_setup_a_cron_job). Pro správnou funkčnost se doporučuje spouštět cron.php každých 5 - 10 minut. Funkčnost může být dále ovlivněna nastavením v "System > Nastavení -> Rozšířené -> Systém -> Cron (Scheduled Tasks) - all the times are in minutes" (viz Obrázek 1.7). V tomto nastavení není třeba měnit původní (default) hodnoty.
Obrázek 1.7: Nastavení pro Cron
Specifikace tvaru XML souboru pro jednotlivé vyhledávače Společné vlastnosti pro všechny vyhledávače
Do XML souboru jsou exportovány vlastnosti produktů, které jsou nastavené pro zvolené Store View. Url adresy produktů jsou složeny dvou částí. Prefix tvoří unsecure base_link_url zvoleného Store View. Unsecure base_link_url je doménová adresa (pro front-end část) daného Store View, která je nastavitelná v backendu (viz Obrázek 2.1). Sufix adresy je tvořen pomocí Url key daného produktu (viz Obrázek 2.2). Do adresy je zahrnut název kategorie v závislosti na nastavení přes "System -> Nastavení -> Katalog -> Optimalizace pro vyhledávání -> Použít" cestu kategorie pro URL produktu (viz Obrázek 2.3).
Obrázek 2.1: Nastavení url adresy produktu - prefix.
Obrázek 2.2: Nastavení url adresy produktu - url key.
Obrázek 2.3: Nastavení url adresy produktu - kategorie v adrese.
Z důvodu omezeného počtu znaků je pro export popisu produktu použit krátký popis (short description) produktu nebo meta popis produktu, pokud je vyplněn. Na místo obyčejného názvu produktu je exportován meta název v případě, že není prázdný. Pro generování url odkazu na obrázek produktu je použita bázová adresa celého Magenta. Pro export správné ceny produktu včetne DPH je třeba mít nastavenou daňovou politiku magenta. Důležité je nastavení způsobu výpočtu ceny s DPH. Nastavuje se pro vybrané Store View přes " System -> Nastavení -> Prodeje -> DPH/(Daň)->Calculation->Tax Based On". Musí být nastaveno na "Původ zásilky" (viz Obrázek 2.4).
Obrázek 2.4: Nastavení způsobu výpočtu ceny včetně DPH
Seznam.cz
link: http://www.seznam.cz
Výsledný XML soubor je použitelný také pro vyhledávače http://www.zbozi.cz a http://www.jyxo.cz Příklad XML specifikace: <SHOP> <SHOPITEM>
Akio Dresser -- název produktu
Our Akio dresser has a solid hardwood frame. -- popis produktu
0 -- počet příspěvků do diskuse o produktu
http://demo.nostresscommerce.cz/review/product/list/id/41 -- url odkaz na diskusi o produktu, prefix adresy je tvořen stejně jako pro url produktu
http://demo.nostresscommerce.cz/furniturecz/bedroom/akio-dresser.html -- url odkaz na webovou stránku s detaily o produktu
new -- tento tag se přidá s hodnotou "new" jen tehdy, pokud je produkt nastaven jako nový 0 -- tento tag se přidá s hodnotou "0" jen tehdy, pokud je produkt na skladě http://demo.nostresscommerce.cz/media/catalog/product/a/k/akio-dresser.jpg -- url odkaz na obrázek produktu 399.99 -- cena produktu bez DPH 432.99 -- cena produktu s DPH
Centrum.cz
link: http://www.centrum.cz
Obsahuje navíc zařazení do kategori podle vyhledavače Centrum.cz. Nutno vybrat při tvorbě profilu exportu. Slouží k lepšímu zařazení do databáze na serveru. Příklad XML specifikace: <SHOP> <SHOPITEM> <MANUFACTURER>CN CLogs -- výrobce produktu Akio Dresser -- název produktu Our Akio dresser has a solid hardwood frame. -- popis produktu http://demo.nostresscommerce.cz/furniturecz/bedroom/akio-dresser.html -- url odkaz na webovou stránku s detaily o produktu 399.99 -- cena produktu bez DPH 432.99 -- cena produktu s DPH 8.25 -- velikost DPH v procentech Bedroom -- kategorie do které je produkt zařazen 111 -- id kategorie podle vyhledavače Centrum.cz http://demo.nostresscommerce.cz/media/catalog/product/a/k/akio-dresser.jpg -- url odkaz na obrázek produktu
Heureka.cz Na modulu se pracuje.
link: http://sluzby.heureka.cz/napoveda/import/
Nejlepsiceny.cz Na modulu se pracuje.
link: http://www.nejlepsiceny.cz/pridat-obchod-napoveda.aspx
Ciao.de
link: http://www.ciao.de
Obsahuje navíc volitelné atributy pro nastavení dodací lhůty (delivery) a nákladů na dopravu (shipping). Používání modulu není podmíněno existencí těchto atributů. Atributy jsou exportovány, pouze pokud jsou vytvořeny a přiřazeny k produktům. Doporučené nastavení atributu 'delivery':
název 'delivery' a 'shipping' typ "Rozbalovací menu" (vlastnost Vstupní typ pro vlastníka obchodu). hodnoty atributu 'delivery':
o Within one month o Within two weeks o Within one week o Within 2-3 days možnost přídání dalších libovolných hodnot
Doporučené nastavení atributu 'shipping':
název 'shipping' typ "Rozbalovací menu" (vlastnost Vstupní typ pro vlastníka obchodu). hodnoty atributu: o 15 EUR o 10 EUR o 5 EUR o FREE SHIPPING možnost přídání dalších libovolných hodnot
Příklad XML specifikace: <MerchantCategory>Bedroom -- kategorie, do které je produkt zařazen 41 -- id produktu Akio Dresser -- název produktu CN CLogs -- výrobce produktu Our Akio dresser has a solid hardwood frame. -- popis produktu http://demo.nostresscommerce.cz/furniturecz/bedroom/akio-dresser.html -- url odkaz na webovou stránku s detaily o produktu 384822 -- SKU produktu http://demo.nostresscommerce.cz/media/catalog/product/a/k/akio-dresser.jpg -- url odkaz na obrázek produktu Within 2-3 days -- volitelný atribut pro nastavení dodací lhůty(nutno přidat v back-endu) 399.99 -- cena produktu bez DPH <ShippingCost>5 EUR -- volitelný atribut pro nastavení ceny doručení(nutno přidat v back-endu) CZK -- měna nastavená pro dané Store View
Kelkoo.de
link: http://www.kelkoo.de
Příklad XML specifikace: <Merk>CN CLogs -- výrobce produktu <Model>Akio Dresser -- název produktu Our Akio dresser has a solid hardwood frame. -- popis produktu 399.99 -- cena produktu bez DPH http://demo.nostresscommerce.cz/furniturecz/bedroom/akio-dresser.html -- url odkaz na webovou stránku s detaily o produktu http://demo.nostresscommerce.cz/media/catalog/product/a/k/akio-dresser.jpg -- url odkaz na obrázek produktu Bedroom -- kategorie, do které je produkt zařazen <Sku>384822 -- SKU produktu
Trovaprezzi.it
link: http://www.trovaprezzi.it
Liší se strukturou od ostatních specifikací. Nemé XML hlavicku. Jednotlivé atributy jsou exportovány bez XML tagů a jsou odděleny pomocí znaku "|". Jednotlivé produkty jsou odděleny pomocí tagu <endrecord>.
Příklad XML specifikace: Akio Dresser| -- název produktu CN CLogs| -- výrobce produktu Our Akio dresser has a solid hardwood frame. | -- popis produktu 399.99| -- cena produktu bez DPH 41| -- id produktu Disponibile| -- určuje, jestli je produkt na skladě,do souboru se vypisuje pouze konstanta "Disponibile" Bedroom| -- kategorie, do které je produkt zařazen http://demo.nostresscommerce.cz/media/catalog/product/a/k/akio-dresser.jpg| -- url odkaz na obrázek produktu -1| -- atribut nebyl blíže specifikován - týká se přepravy - exportuje se konstanta -1 384822| -- SKU produktu <endrecord>
Keldelice.com
link: http://www.keldelice.com
Modul není hotov. Příklad XML specifikace: <product> Akio Dresser -- název produktu <description> Our Akio dresser has a solid hardwood frame. -- popis produktu Bedroom -- kategorie, do které je produkt zařazen <price>399.99 -- cena produktu bez DPH <product_url> http://demo.nostresscommerce.cz/furniturecz/bedroom/akio-dresser.html -- url odkaz na webovou stránku s detaily o produktu http://demo.nostresscommerce.cz/media/catalog/product/a/k/akio-dresser.jpg -- url odkaz na obrázek produktu -- tento atribut se nevyplňuje -- tento atribut se nevyplňuje -- tento atribut se nevyplňuje -- tento atribut se nevyplňuje <sku>384822 -- SKU produktu <manufacturer>CN CLogs -- výrobce produktu <ean13/> -- atribut nebyl blíže specifikován <weight>128.9700 -- váha produktu <shipping_cost>100.0000 -- náklady na přepravu produktu bez DPH
LeGuide.fr
link: http://www.leguide.fr
Modul není hotov. Příklad XML specifikace: <product place="1"> Bedroom -- kategorie, do které je produkt zařazen 41 -- id produktu Akio Dresser -- název produktu <prix>399.99 -- cena produktu bez DPH http://demo.nostresscommerce.cz/furniturecz/bedroom/akio-dresser.html -- url odkaz na webovou stránku s detaily o produktu http://demo.nostresscommerce.cz/media/catalog/product/a/k/akio-dresser.jpg -- url odkaz na obrázek produktu <description> Our Akio dresser has a solid hardwood frame. -- popis produktu 0 0 0 <marque>CN CLogs -- výrobce produktu <ean>0 0 0 0 <devise>CZK -- měna nastavená pro dané Store View