Chyby a jejich řešení

Tento průvodce obsahuje nejčastější chyby při používání pluginu WPify Woo Feedy a kroky k jejich vyřešení.

Chyby generování feedů

Soubor feedu je po vygenerování prázdný

Příčina: Feed byl vygenerován, ale žádné produkty nesplnily kritéria, nebo se jedná o problém s oprávněními souborů na serveru.

Řešení:

1. Ověřte, že máte publikované produkty skladem
2. Zkontrolujte, zda jsou kategorie produktů namapovány na kategorie feedu (pokud je zapnuto „Vyloučit produkty bez namapované kategorie”)
3. Ověřte oprávnění souborů na adresáři wp-content/uploads/xml/ — webový server musí mít právo zápisu
4. Pokud adresář neexistuje, smažte ho a nechte plugin jej vytvořit znovu při dalším generování
5. Kontaktujte podporu hostingu, pokud problémy s oprávněním přetrvávají

Generování feedu vyprší časový limit nebo se nedokončí

Příčina: V jedné dávce se zpracovává příliš mnoho produktů, nebo server má striktní limity na dobu běhu.

Řešení:

1. Snižte hodnotu Počet produktů na jeden běh v globálním nastavení (zkuste 50 nebo i 25)
2. Zkontrolujte nastavení PHP na serveru: max_execution_time a memory_limit
3. Zkuste vygenerovat feed přes WP-CLI: wp wpify_woo_feeds generate {nazev_feedu} — obchází limity webového serveru
4. Pokud používáte cachovací plugin, ujistěte se, že nenarušuje zpracování na pozadí

URL feedu vrací chybu 404

Příčina: Soubor feedu ještě nebyl vygenerován, nebo je cesta k adresáři uploads nesprávná.

Řešení:

1. Přejděte do nastavení pluginu a klikněte na Generovat u požadovaného feedu
2. Zkontrolujte, zda URL feedu v tabulce nastavení ukazuje na existující soubor
3. Ověřte, že adresář wp-content/uploads/xml/ existuje a je přístupný
4. Obnovte WordPress permanentní odkazy: Nastavení → Trvalé odkazy a klikněte Uložit změny

Chyby dat produktů

Produkty ve feedu chybí

Příčina: Produkty mohou být vyloučeny kvůli stavu skladu, chybějícímu mapování kategorie nebo nastavení vyloučení na úrovni produktu.

Řešení:

1. Zkontrolujte, zda je zapnuto Vyloučit produkty, které nejsou skladem — produkty bez skladu budou vynechány
2. Ověřte, zda jsou kategorie produktů namapovány na kategorie feedové služby
3. Otevřete editaci produktu a zkontrolujte záložku feedu — ujistěte se, že není zapnuto „Vyřadit z feedu”
4. U variabilních produktů zkontrolujte jak nadřazený produkt, tak jednotlivé varianty

Duplicitní produkty ve feedu (varianty)

Příčina: Variabilní produkty generují samostatný záznam pro každou variantu.

Řešení:

1. Toto je očekávané chování — každá varianta se ve feedu zobrazí jako samostatná položka
2. Pokud chcete vyloučit konkrétní varianty, použijte nastavení na úrovni varianty v editaci produktu
3. Použijte filtr {feed_name}_skip_product pro programatické řízení, které varianty se zobrazí

Špatný název produktu ve feedu

Příčina: Feed může používat uložený nebo nesprávný název produktu, zejména u Heureka feedů, kde jsou název a jméno oddělená pole.

Řešení:

1. Zkontrolujte záložku feedu v editaci produktu, zda nejsou nastaveny vlastní přepisy názvu/jména
2. Zkuste feed kompletně přegenerovat
3. Použijte filtr wpify_woo_feeds_item_title nebo wpify_woo_feeds_item_name pro přizpůsobení

Hodnoty EAN/GTIN chybí nebo jsou nesprávné

Příčina: Zdrojové pole pro EAN není správně nakonfigurováno.

Řešení:

1. Pokud používáte vestavěné pole EAN, ujistěte se, že je v globálním nastavení zapnuto Přidat pole EAN a hodnoty jsou vyplněny u produktů
2. Pokud používáte vlastní pole, ověřte správnost slugu pole v nastavení feedu
3. Pokud není pole EAN nakonfigurováno, plugin použije jako zálohu SKU produktu

Chyby specifické pro služby

Google Merchants odmítá feed

Příčina: Feed nesplňuje požadavky specifikace produktových dat Google.

Řešení:

1. Ujistěte se, že všechna povinná pole jsou vyplněna: název, popis, cena, dostupnost, odkaz, obrázek
2. Namapujte všechny kategorie produktů na Google kategorie
3. Nastavte stav produktu (Nové/Použité/Repasované)
4. Nakonfigurujte značku nebo GTIN — Google vyžaduje alespoň jeden identifikátor produktu
5. Zkontrolujte, že popisy produktů neobsahují HTML značky z page builderů

Heureka hlásí chybějící doručovací metody

Příčina: Doručovací metody nejsou nakonfigurovány v nastavení Heureka feedu.

Řešení:

1. Přejděte do nastavení Heureka feedu a nakonfigurujte Doručovací metody
2. Vyberte metody z předdefinovaného seznamu Heureka a zadejte ceny dopravy
3. Přidejte příplatky za dobírku tam, kde je to relevantní

Často kladené otázky (FAQ)

Jak často bych měl feedy přegenerovávat?

Pro většinu obchodů stačí regenerace jednou až dvakrát denně. Pro plánované generování použijte cron URL nebo WP-CLI. Funkce Automaticky pregenerovat při aktualizaci produktu udržuje feedy aktuální při jednotlivých změnách, ale měla by být vypnuta při hromadných operacích.

Mohu přizpůsobit, které produkty se zobrazí v konkrétním feedu?

Ano, použijte nastavení na úrovni produktu v editaci produktu (každý feed má vlastní záložku), nebo použijte filtr {feed_name}_skip_product pro programatické řízení. Produkty lze také globálně vyloučit podle stavu skladu nebo chybějícího mapování kategorie.

Jaký je rozdíl mezi hlavním Heureka feedem a dostupnostním feedem?

Heureka feed (CZ nebo SK) obsahuje úplná data produktů — název, popis, obrázky, cenu, parametry atd. Dostupnostní feed Heureka poskytuje pouze informace o skladové dostupnosti a je aktualizován častěji. Oba by měly být registrovány u Heureka pro optimální výsledky.

Mohu generovat feedy přes příkazový řádek?

Ano, použijte WP-CLI: wp wpify_woo_feeds generate {nazev_feedu}. Doporučeno pro velké katalogy, protože obchází limity webového serveru. Dostupné názvy feedů: feed_google_merchants, feed_heureka_cz, feed_heureka_sk, feed_heureka_availability, feed_zbozi, feed_alza.

Proč můj feed obsahuje značky editoru v popisech produktů?

Pokud používáte page buildery (Elementor, WPBakery aj.) pro popisy produktů, jejich shortcody nebo HTML značky se mohou zobrazit ve feedu. Přepněte nastavení Popis na Krátký popis pro zamezení tohoto problému, nebo použijte filtr dat položek pro vyčištění výstupu.

Do feedu se místo názvu značky propisuje „pa_znacka" nebo jiný slug

Příčina: Pole Značka a Typ hodnoty pro Značku spolu souvisí. Pokud zadáte slug vlastnosti produktu (např. pa_znacka), ale typ necháte na „Text”, do feedu se propíše doslovně text „pa_znacka” místo skutečného názvu značky.

Řešení:

1. V nastavení feedu najděte pole Značka a Typ hodnoty pro Značku
2. Pokud jako hodnotu zadáváte slug vlastnosti produktu (např. pa_znacka), vyberte typ Taxonomie
3. Pokud zadáváte slug vlastního pole (custom field), vyberte typ Vlastní pole
4. Pokud zadáváte přímo text (např. „MojeZnačka”), ponechte typ Text
5. Uložte nastavení a přegenerujte feed

Jak přidám custom labels (custom_label_0–4) do Google Merchants feedu?

Custom labels lze nastavit dvěma způsoby:

1. Na úrovni produktu: V editaci produktu otevřete záložku Google Merchants Feed a v sekci Vlastní pole přidejte parametr s názvem custom_label_0 (až custom_label_4) a požadovanou hodnotou.
2. Programaticky: Použijte filtr wpify_woo_feeds_google_merchants_item_data — viz příklad v dokumentaci pro vývojáře.

Heureka nepodporuje formát obrázků WEBP — jak posílat JPG?

Pokud na webu používáte obrázky ve formátu WEBP (ať už přímo nahrané nebo konvertované pluginem), Heureka je nemusí akceptovat. Řešení závisí na vašem nastavení:

1. Obrázky existují i v JPG: Použijte filtr wpify_woo_feeds_heureka_item_data pro nahrazení přípony v URL — viz příklad v dokumentaci pro vývojáře.
2. Na úrovni produktu: V editaci produktu v záložce Heureka Feed můžete ručně přepsat URL obrázku na JPG verzi.