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 <?xml version="1.0" encoding="iso-8859-2"?> <SHOP> <SHOPITEM> <PRODUCT>Akio Dresser</PRODUCT> <DESCRIPTION> </DESCRIPTION> <DISCUSSION_SIZE>0</DISCUSSION_SIZE> -- počet příspěvků do diskuse o produktu <DISCUSSION_URL>
http://demo.nostresscommerce.cz/review/product/list/id/41 </DISCUSSION_URL> -- url odkaz na diskusi o produktu, prefix adresy je tvořen stejně jako pro url produktu <URL> </URL> <ITEM_TYPE>new<ITEM_TYPE> -- tento tag se přidá s hodnotou "new" jen tehdy, pokud je produkt nastaven jako nový <AVAILABILITY>0</AVAILABILITY> -- tento tag se přidá s hodnotou "0" jen tehdy, pokud je produkt na skladě <IMGURL> </IMGURL> <PRICE>399.99</PRICE> <PRICE_VAT>432.99</PRICE_VAT> -- cena produktu s DPH </SHOPITEM> </SHOP> 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. <?xml version="1.0" encoding="windows-1250"?> <SHOP> <SHOPITEM> <MANUFACTURER>CN CLogs</MANUFACTURER> -- výrobce produktu <PRODUCT>Akio Dresser</PRODUCT> <DESCRIPTION> </DESCRIPTION> <URL> </URL> <PRICE>399.99</PRICE> <PRICE_VAT>432.99</PRICE_VAT> -- cena produktu s DPH <VAT>8.25</VAT> -- velikost DPH v procentech <CATEGORYTEXT>Bedroom</CATEGORYTEXT> -- kategorie do které je produkt zařazen <CATEGORYCENTRUM>111</CATEGORYCENTRUM> -- id kategorie podle vyhledavače Centrum.cz <IMGURL> </IMGURL> </SHOPITEM> </SHOP> 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 <?xml version="1.0" encoding="utf-8"?> <Offers> <Offer> <MerchantCategory>Bedroom</MerchantCategory> -- kategorie, do které je produkt zařazen <OfferID>41</OfferID> -- id produktu <Name>Akio Dresser</Name> <Brand>CN CLogs</Brand/> -- výrobce produktu <Description> </Description> <DeepLink> </DeepLink> <ProductID>384822</ProductID> -- SKU produktu <ImageUrl> </ImageUrl> <Delivery>Within 2-3 days</delivery> -- volitelný atribut pro nastavení dodací lhůty(nutno přidat v back-endu) <Prices>399.99</Prices> <ShippingCost>5 EUR</ShippingCost> -- volitelný atribut pro nastavení ceny doručení(nutno přidat v back-endu) <Currency>CZK</Currency> -- měna nastavená pro dané Store View </Offer> </Offers> Kelkoo.de link: http://www.kelkoo.de <?xml version="1.0" encoding="utf-8"?> <Products> <Product> <Merk>CN CLogs</Merk> -- výrobce produktu <Model>Akio Dresser</Model> <Omschrijving> </Omschrijving> <Prijs>399.99</Prijs> <Deeplink> </Deeplink> <Image> </Image> <Categorie>Bedroom</Categorie> -- kategorie, do které je produkt zařazen <Sku>384822</Sku> -- SKU produktu </Product> </Products> 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>.
Akio Dresser CN CLogs -- výrobce produktu 399.99 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 -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. <?xml version="1.0" encoding="iso-8859-1"?> <catalog> <product> <title>akio Dresser</title> <description> </description> <category>bedroom</category> -- kategorie, do které je produkt zařazen <price>399.99</price> <product_url> </product_url> <image_url_1> </image_url_1> <image_url_2/> -- tento atribut se nevyplňuje <image_url_3/> -- tento atribut se nevyplňuje <image_url_4/> -- tento atribut se nevyplňuje <image_url_5/> -- tento atribut se nevyplňuje <sku>384822</sku> -- SKU produktu <manufacturer>cn CLogs</manufacturer> -- výrobce produktu <ean13/> -- atribut nebyl blíže specifikován <weight>128.9700</weight> -- váha produktu <shipping_cost>100.0000</shipping_cost> -- náklady na přepravu produktu bez DPH </product> </catalog> LeGuide.fr link: http://www.leguide.fr Modul není hotov. <?xml version="1.0" encoding="iso-8859-1"?> <catalogue lang="fr" date="2005-06-28 12 :00" GMT= "+1"> <product place="1"> <categorie>bedroom</categorie> -- kategorie, do které je produkt zařazen <identifiant_unique>41</identifiant_unique> -- id produktu <titre>akio Dresser</titre> <prix>399.99</prix> <url_produit> </url_produit> <url_image> </url_image> <description> </description> <frais_de_livraison>0</frais_de_livraison> <D3E>0</D3E> <disponibilite>0</disponibilite> <marque>cn CLogs</marque> -- výrobce produktu <ean>0</ean> <garantie>0</garantie> <reference_modele>0</reference_modele> <occasion>0</occasion> <devise>czk</devise> -- měna nastavená pro dané Store View </product> </catalogue>