XML Feed — Články

Feed pro import blogových článků a rádců do UpSearch. Články se zobrazují ve výsledcích vyhledávání.

Struktura

<?xml version="1.0" encoding="utf-8"?>
<articles>
    <title>Název e-shopu</title>
    <link>https://www.example.com/</link>
    <item>
        <!-- data článku -->
    </item>
</articles>

Parametry položky

Parametr	Typ	Povinný	Popis
id	integer	✅ Ano	Unikátní identifikátor článku
name	string	✅ Ano	Titulek článku
annotation	string	❌ Ne	Krátký popis / perex článku
text	string	❌ Ne	Plný text článku (může obsahovat escapované HTML)
url	string (URL)	✅ Ano	URL článku
image	string (URL)	❌ Ne	Náhledový obrázek (min. 50×50 px)
image_2x_link	string (URL)	❌ Ne	Velký obrázek (min. 200×200 px)
badge	object	❌ Ne	Štítek/kategorie článku (může se opakovat)

Badge (štítek článku)

Články mohou mít jeden nebo více badge — typicky pro označení rubrik (např. „Rady a tipy", „Novinky").

Parametr	Typ	Povinný	Popis
badge/front_text	string	✅ Ano*	Text štítku
badge/front_text_color	string	❌ Ne	Barva textu (HEX nebo dark/light)
badge/front_background_color	string (HEX)	❌ Ne	Barva pozadí štítku

*Povinné, pokud je element badge přítomen

Příklad

<?xml version="1.0" encoding="utf-8"?>
<articles>
    <title>Název e-shopu</title>
    <link>https://www.example.com/</link>

    <!-- Článek s perexem a obrázky -->
    <item>
        <id>301</id>
        <name>Jak správně pečovat o kožené boty</name>
        <annotation>Správná péče prodlouží životnost vašich bot. Poradíme vám, jak na to.</annotation>
        <text>&lt;h3&gt;Pravidelná údržba&lt;/h3&gt;&lt;p&gt;Kožené boty je třeba pravidelně impregnovat...&lt;/p&gt;</text>
        <url>https://www.example.com/blog/pece-o-kozene-boty/</url>
        <image>https://www.example.com/images/articles/boty-thumb.jpg</image>
        <image_2x_link>https://www.example.com/images/articles/boty-large.jpg</image_2x_link>
        <badge>
            <front_text>Rady a tipy</front_text>
            <front_text_color>dark</front_text_color>
            <front_background_color>#ffffff</front_background_color>
        </badge>
    </item>

    <!-- Článek s více badge -->
    <item>
        <id>302</id>
        <name>Trendy v bydlení pro rok 2026</name>
        <annotation>Minimalistický design a přírodní materiály dominují letošním interiérům.</annotation>
        <url>https://www.example.com/blog/trendy-bydleni-2026/</url>
        <image>https://www.example.com/images/articles/interier-thumb.jpg</image>
        <image_2x_link>https://www.example.com/images/articles/interier-large.jpg</image_2x_link>
        <badge>
            <front_text>Novinky</front_text>
            <front_text_color>#ffffff</front_text_color>
            <front_background_color>#2563eb</front_background_color>
        </badge>
        <badge>
            <front_text>Bydlení</front_text>
            <front_text_color>dark</front_text_color>
            <front_background_color>#ffffff</front_background_color>
        </badge>
    </item>

    <!-- Jednoduchý článek -->
    <item>
        <id>303</id>
        <name>5 tipů jak ušetřit při nákupu online</name>
        <annotation>Nakupujte chytře a využijte slevy naplno.</annotation>
        <url>https://www.example.com/blog/tipy-online-nakup/</url>
    </item>
</articles>

Validátor feedu

Ověřte strukturu vašeho feedu pomocí XML Feed Validátoru — zkontroluje povinná pole a datové typy.