Napojení PrestaShop
Přímé napojení e-shopu na platformě PrestaShop přes její Webservice API — alternativa k XML feedům. UpSearch si data (produkty, kategorie, značky) stahuje sám přímo z PrestaShopu, není potřeba generovat a udržovat XML.
Předpoklady na straně PrestaShopu
- Zapnuté Webservice API — v administraci PrestaShopu: Pokročilé nastavení → Webservice → Povolit PrestaShop webové služby: Ano.
- API klíč s právy pro čtení těchto zdrojů:
products— produktycategories— kategoriemanufacturers— výrobci (značky)stock_availables— skladová dostupnostlanguages— jazyky (pro jazykové mutace a URL prefixy)product_featuresaproduct_feature_values— parametry (pro filtry a hledání)
- URL e-shopu (např.
https://vas-eshop.cz).
Jak napojit
V administraci UpSearch (app.upsearch.cz): Data → Integrace.
- Zvolte platformu PrestaShop.
- Vyplňte URL e-shopu a API klíč.
- Tlačítkem Test spojení ověříte, že UpSearch na e-shop dosáhne a klíč má správná práva.
- Připojit — vytvoří napojení a načte dostupné jazyky.
- Synchronizovat — spustí první import dat.
Po připojení se v přehledu integrace zobrazí načtené jazyky a stav synchronizace. Kolekce naplněné z PrestaShopu jsou v sekci Kolekce označené jako PrestaShop API.
Co se synchronizuje
Napojení naplní tři kolekce (podle šablony TEMPLATE - PrestaShop):
| Kolekce | Obsah |
|---|---|
| Produkty | aktivní produkty vč. ceny, skladu, značky, kategorie, parametrů |
| Kategorie | aktivní kategorie (kromě kořenových) |
| Značky | aktivní výrobci |
Vícejazyčnost
PrestaShop drží obsah v jazykových mutacích. UpSearch mapuje každý jazyk na samostatný sales channel — pro vícejazyčný e-shop tedy vznikne napojení per jazyk. Názvy, popisy a URL (/{jazyk}/…) se lokalizují podle jazyka daného sales channelu; jazyky se načítají přímo z PrestaShopu (zdroj languages).
Mapování polí
Produkty
| Pole UpSearch | Zdroj v PrestaShopu |
|---|---|
name | název produktu (dle jazyka) |
code | reference |
ean | ean13 |
price | price |
price_view | dopočítá se automaticky z price a nastavení měny sales channelu |
annotation | description_short (bez HTML) |
link | {url}/{jazyk}/{kategorie}/{id}-{link_rewrite}.html |
image_link | {url}/{id_default_image}-large_default/{link_rewrite}.jpg |
brand_name | název výrobce (manufacturers) |
category_name | název výchozí kategorie |
in_stock | příznak active (výchozí) + reálný sklad ze stock_availables |
| parametry (filtry/hledání) | product_features → product_feature_values |
Kategorie a Značky
| Pole UpSearch | Zdroj |
|---|---|
name | název (dle jazyka) |
link | URL na kategorii (u kategorií) |
Synchronizace
- První import se spustí tlačítkem Synchronizovat.
- Průběžnou aktualizaci (ceny, sklad, nové produkty) zajišťuje na pozadí synchronizační worker.
- Pro odpojení použijte v integraci tlačítko Odpojit.
Poznámky a omezení
- Do UpSearch se přenášejí pouze aktivní produkty, kategorie a značky.
price_viewse negeneruje z PrestaShopu, ale dopočítává z ceny a měny sales channelu.- U kategorií a značek se přenáší název a odkaz; obrázky kategorií/značek se aktuálně neimportují.
- Kořenové kategorie PrestaShopu (id ≤ 2) se do vyhledávání nepřenášejí.