> For the complete documentation index, see [llms.txt](https://napoveda.rocketoo.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://napoveda.rocketoo.cz/rocketoo/rozsireni/glami.md).

# Glami

Modul **Glami** vám umožňuje:

* Automaticky generovat XML feed pro Glami.cz a Glami.sk
* Mapovat kategorie e-shopu na oficiální kategorie Glami
* Přizpůsobit názvy produktů pro feed
* Vybrat, které parametry se mají exportovat
* Vyloučit konkrétní kategorie z exportu

## Co je Glami?

[Glami](https://www.glami.cz/) je největší fashion vyhledávač v České a Slovenské republice zaměřený na módu a bydlení. Zákazníci zde hledají oblečení, obuv a bytové doplňky z desítek až stovek e-shopů. Vaše produkty se tak dostanou k tisícům potenciálních zákazníků.

### Kde najdu modul?

{% hint style="info" %}
Modul je nutné nejprve nainstalovat ve **Správci rozšíření**. 
{% endhint %}

Po instalaci modulu naleznete v menu **Rocketoo**→ **E-shop** → **Feedy**.

## Základní nastavení

{% stepper %}
{% step %}
V hlavním menu klikněte na **Rocketoo** → **E-shop** → **Feedy**
{% endstep %}

{% step %}
Najděte **Glami feed**
{% endstep %}

{% step %}
Klikněte na název feedu pro zobrazení nastavení a zkopírujte si odkaz na XML feed
{% endstep %}

{% step %}
Zaregistrujte se na Glami.cz (nebo Glami.sk)
{% endstep %}

{% step %}
V administraci Glami zadejte odkaz na váš XML feed
{% endstep %}
{% endstepper %}

### Jazyková verze

Modul automaticky pozná, zda provozujete:

* **České e-shop** - používá kategorie z Glami.cz
* **Slovenský e-shop** - používá kategorie z Glami.sk

Verze se nastaví podle hlavního jazyka vašeho e-shopu.

### Automatická aktualizace kategorií

Každé **úterý ve 3:20** se automaticky:

* Stáhne aktuální strom kategorií z Glami
* Aktualizují se názvy kategorií
* Odstraní se neaktivní kategorie
* Přidají se nové kategorie

Nemusíte nic dělat ručně, vše probíhá na pozadí.

## XML feed

### Kde najdu odkaz na feed?

{% stepper %}
{% step %}
V menu klikněte na **Rocketoo** → **E-shop** → **Feedy**
{% endstep %}

{% step %}
Najděte **Glami feed**
{% endstep %}

{% step %}
Kliknutím na řádek otevřete nastavení feedu a zkopirujte odkaz pod **Váš XML feed**
{% endstep %}

{% step %}
Tento odkaz zadejte do administrace Glami
{% endstep %}
{% endstepper %}

### Co obsahuje XML feed?

Feed exportuje pro každý produkt:

* **ITEM\_ID** - unikátní ID varianty
* **PRODUCTNAME** - název produktu (upravitelný)
* **PRODUCT** - název varianty
* **DESCRIPTION** - popis produktu
* **URL** - odkaz na detail produktu
* **IMGURL** - hlavní obrázek
* **IMGURL\_ALTERNATIVE** - další obrázky
* **CATEGORYTEXT** - kategorie Glami nebo e-shopu
* **PRICE\_VAT** - cena s DPH
* **EAN** - čárový kód
* **ITEMGROUP\_ID** - ID produktu (pro seskupení variant)
* **MANUFACTURER** - výrobce/značka
* **DELIVERY\_DATE** - dodací lhůta ve dnech
* **PARAM** - parametry produktu

### Nastavení exportovaných parametrů

V nastavení můžete zvolit, které typy parametrů se mají zahrnout do feedu:

#### Parametry pro filtrování

* Zaškrtněte **"Zahrnout do XML feedu parametry pro filtrování"**
* Exportují se parametry označené jako "Použít pro filtrování"
* Typicky: barva, velikost, materiál

#### Parametry pro detail produktu

* Zaškrtněte **"Zahrnout do XML feedu parametry pro detail produktu"**
* Exportují se parametry viditelné na detailu
* Typicky: složení, péče, vlastnosti

#### Parametry pro generování názvu

* Zaškrtněte **"Zahrnout do XML feedu parametry pro generování názvu produktu"**
* Exportují se parametry používané v názvu
* Typicky: barva, velikost

{% hint style="info" %}
**Doporučení:** Nechte všechny tři možnosti zapnuté, Glami si vybere, co potřebuje.
{% endhint %}

## Mapování kategorií

### Proč mapovat kategorie?

Glami má vlastní kategoriální strukturu optimalizovanou pro fashion vyhledávač. Správné mapování zajistí:

* **Lepší zařazení produktů** ve vyhledávání
* **Vyšší relevanci** pro zákazníky
* **Správné zobrazení** ve filtrech

### Jak přiřadit Glami kategorii?

{% stepper %}
{% step %}
V menu klikněte na **Rocketoo** → **E-shop** → **Feedy**
{% endstep %}

{% step %}
Rozklikněte **Glami feed** a v části **Volba kategorií** zaškrtněte hlavní kategorie Glami
{% endstep %}

{% step %}
Tyto kategorie budou nabízeny v jednotlivých kategoriích e-shopu
{% endstep %}

{% step %}
Klikněte **Uložit**
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Tip:** Vyberte jen ty kategorie, které odpovídají vašemu sortimentu. Usnadní to pozdější přiřazování.
{% endhint %}

{% stepper %}
{% step %}
Jděte do **Produkty** → **Kategorie**
{% endstep %}

{% step %}
Otevřete kategorii e-shopu (např. "Dámské boty")
{% endstep %}

{% step %}
Přejděte na záložku **Srovnávače**
{% endstep %}

{% step %}
V poli **Glami kategorie** vyberte odpovídající kategorii
{% endstep %}

{% step %}
Klikněte **Uložit**
{% endstep %}
{% endstepper %}

### Příklady správného mapování

| Kategorie e-shopu | Glami kategorie          |
| ----------------- | ------------------------ |
| Dámské boty       | Ženy > Boty              |
| Pánské košile     | Muži > Oblečení > Košile |
| Bytové textilie   | Bydlení > Textil         |
| Dětské oblečení   | Děti > Oblečení          |

### Co když nezvolím Glami kategorii?

Pokud kategorii nemapujete:

* Použije se **název kategorie z e-shopu**
* Glami se pokusí produkt zařadit automaticky
* Doporučujeme ale **vždy mapovat ručně** pro lepší výsledky

### Vyloučení kategorií z exportu

{% stepper %}
{% step %}
V menu klikněte na **Rocketoo** → **E-shop** → **Feedy**
{% endstep %}

{% step %}
Rozklikněte **Glami feed** a v části přejděte na sekci **Zakázat export z kategorií**
{% endstep %}

{% step %}
Zaškrtněte kategorie, které se **nemají** exportovat
{% endstep %}

{% step %}
Klikněte **Uložit**
{% endstep %}
{% endstepper %}

#### Kdy vyloučit kategorii?

* Kategorie "Akce" nebo "Výprodej" (ne produktové)
* Služby a poukazy
* Produkty, které nejsou móda ani bydlení
* Testovací kategorie

## Nastavení produktů

### Přizpůsobení názvu produktu pro feed

Pro produkty bez variant

{% stepper %}
{% step %}
Jděte do **Produkty**
{% endstep %}

{% step %}
Otevřete produkt
{% endstep %}

{% step %}
Přejděte na záložku **Pokročilé**
{% endstep %}

{% step %}
Do pole **Tag PRODUCTNAME** zadejte vlastní název

* Pokud necháte prázdné, použije se název produktu
  {% endstep %}

{% step %}
Klikněte **Uložit**
{% endstep %}
{% endstepper %}

Pro produkty s variantami

{% stepper %}
{% step %}
Jděte do **Produkty**
{% endstep %}

{% step %}
Otevřete produkt s variantami
{% endstep %}

{% step %}
Přejděte na záložku **Varianty**
{% endstep %}

{% step %}
Otevřete konkrétní variantu
{% endstep %}

{% step %}
Přejděte na záložku **Pokročilé**
{% endstep %}

{% step %}
Do pole **Tag PRODUCTNAME** zadejte vlastní název varianty
{% endstep %}

{% step %}
Klikněte **Uložit**
{% endstep %}
{% endstepper %}

#### Kdy použít vlastní název?

* Název na e-shopu obsahuje interní označení
* Chcete přidat klíčová slova pro vyhledávání
* Název potřebuje být stručnější nebo popisnější

#### Příklad:

* Název na e-shopu: `Košile DR-125-BL modrá`
* Název pro Glami: `Pánská modrá košile s dlouhým rukávem`

### Parametry produktu

Glami automaticky zpracuje parametry produktu nastavené v e-shopu:

{% stepper %}
{% step %}
Jděte do **Produkty**
{% endstep %}

{% step %}
Otevřete produkt
{% endstep %}

{% step %}
Na záložce **Parametry** nastavte:

* Název parametru (např. "Barva")
* Hodnotu (např. "Modrá")
* **Použít pro filtrování** - zaškrtněte pro důležité parametry
* **Použít pro detail** - zaškrtněte pro zobrazení detailu
* **Použít pro název** - zaškrtněte pro generování názvu
  {% endstep %}
  {% endstepper %}

### Důležité informace o produktu

Pro správné zobrazení v Glami zkontrolujte:

* **Obrázky** - min. 1 kvalitní fotka, doporučeno více
* **Popis** - vyplněný popis produktu
* **Kategorie** - produkt je v aktivní kategorii
* **Cena** - nastavená cena s DPH
* **Dostupnost** - správně nastavená skladová dostupnost
* **EAN/čárový kód** - pokud je k dispozici
* **Výrobce/značka** - vyplněná značka

## Export produktů

### Jaké produkty se exportují?

Do feedu se automaticky zahrnují produkty, které splňují tyto podmínky:

* **Produkt je aktivní** - publikovaný na e-shopu
* **Produkt má cenu** - nastavená prodejní cena
* **Produkt má obrázek** - min. jeden obrázek
* **Kategorie není vyloučena** - není v seznamu zakázaných kategorií

### Produkty bez mapování kategorie

Pokud produkt nemá přiřazenou Glami kategorii:

* Export proběhne normálně
* V XML feedu se použije název kategorie z e-shopu
* Glami se pokusí produkt zařadit automaticky

### Časté problémy

Produkt není ve feedu

* ❌ Není publikovaný
* ❌ Nemá nastavenou cenu
* ❌ Nemá obrázek
* ❌ Je v zakázané kategorii

Chybí kategorie

* ❌ Kategorie e-shopu nemá přiřazenou Glami kategorii
* ✅ Použije se název kategorie e-shopu

Chybějí parametry

* ❌ Parametry nejsou označené pro filtrování/detail/název
* ✅ Zkontrolujte nastavení exportu parametrů v modulu

## Často kladené otázky

### Obecné otázky

<details>

<summary><strong>Musím se registrovat na Glami?</strong></summary>

Ano, registrace na Glami.cz (nebo Glami.sk) je nutná pro aktivaci feedu a zpřístupnění produktů.

</details>

<details>

<summary><strong>Je Glami placené?</strong></summary>

Glami funguje na modelu cost-per-click (CPC) - platíte pouze za kliknutí na váš produkt. Registrace a feed jsou zdarma.

</details>

<details>

<summary><strong>Mohu používat Glami pro jiné produkty než módu?</strong></summary>

Glami je primárně určené pro módu a bydlení. Pro jiné produkty doporučujeme Heureku nebo Zboží.cz.

</details>

### XML feed

<details>

<summary><strong>Jak často Glami stahuje můj feed?</strong></summary>

Glami stahuje feed několikrát denně automaticky. Přesný harmonogram nastavuje Glami.

</details>

<details>

<summary><strong>Mohu mít vlastní URL pro feed?</strong></summary>

URL je pevně daná: /api/v1/feed/glami.xml. Lze ji ale přesměrovat pomocí .htaccess.

</details>

<details>

<summary><strong>Feed se nezobrazuje / hlásí chybu</strong></summary>

Zkontrolujte, zda je modul aktivní a zda máte v e-shopu nějaké aktivní produkty s obrázky.

</details>

### Kategorie

<details>

<summary><strong>Musím mapovat všechny kategorie?</strong></summary>

Není to povinné, ale velmi doporučené. Správné mapování zajistí lepší zařazení produktů.

</details>

<details>

<summary><strong>Mohu jednu kategorii e-shopu namapovat na více Glami kategorií?</strong></summary>

Ano, můžete vybrat více Glami kategorií. Produkt se zobrazí ve všech vybraných kategoriích.

</details>

<details>

<summary><strong>Co když moje kategorie neodpovídá žádné v Glami?</strong></summary>

Zvolte nejbližší možnou kategorii nebo nechte použít název z e-shopu.

</details>

<details>

<summary><strong>Jak často se aktualizují Glami kategorie?</strong></summary>

Automaticky každé úterý ve 3:20. Můžete také spustit manuálně v administraci.

</details>

### Produkty

<details>

<summary><strong>Můžu mít pro Glami jiný název než na e-shopu?</strong></summary>

Ano, v záložce Glami u každého produktu/varianty můžete zadat vlastní název.

</details>

<details>

<summary><strong>Zobrazí se v Glami i nepublikované produkty?</strong></summary>

Ne, exportují se pouze aktivní a publikované produkty.

</details>

<details>

<summary><strong>Mohu vyloučit konkrétní produkt z exportu?</strong></summary>

Přímo ne, ale můžete vyloučit celou kategorii nebo produkt deaktivovat.

</details>

### Parametry

<details>

<summary><strong>Které parametry se exportují do Glami?</strong></summary>

To závisí na nastavení v modulu - můžete zvolit parametry pro filtrování, detail nebo název.

</details>

<details>

<summary><strong>Musím mít vyplněný EAN kód?</strong></summary>

Není to povinné, ale doporučené. EAN pomáhá Glami správně identifikovat produkty.

</details>

<details>

<summary><strong>Co znamená "ITEMGROUP_ID"?</strong></summary>

Je to ID produktu sloužící k seskupení variant (např. stejná košile v různých velikostech).

</details>

### Technické otázky

<details>

<summary><strong>Jak dlouho trvá, než se změny projeví na Glami?</strong></summary>

Po změně v e-shopu musí Glami stáhnout feed (několik hodin) a indexovat data (do 24 hodin).

</details>

<details>

<summary><strong>Mohu testovat feed před spuštěním?</strong></summary>

Ano, otevřete odkaz na feed v prohlížeči a zkontrolujte XML strukturu.

</details>

<details>

<summary><strong>Feed je velmi velký, nezpomalí to e-shop?</strong></summary>

Ne, feed je předgenerovaný dopředu a je tak zajištěno rychlé načítání.

</details>