> 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/raventic.md).

# Raventic

Modul Raventic přináší do vašeho e-shopu:

* Chytré sémantické vyhledávání produktů
* Vyhledávací dropdown s našeptávačem přímo ve vyhledávacím poli
* Přehlednou stránku výsledků hledání s filtry
* Analytiku chování zákazníků při vyhledávání
* Zobrazení kategorií a článků ve výsledcích

### Kde najdu modul?

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

### Co je sémantické vyhledávání?

Na rozdíl od běžného vyhledávání, které hledá pouze přesné shody slov, sémantické vyhledávání rozumí významu dotazu. Když zákazník napíše „červené boty na léto", najde relevantní produkty i když v názvu nemají přesně tato slova.

## Kde najdu nastavení

{% stepper %}
{% step %}

### Otevřete nastavení

V hlavním menu klikněte na **Nastavení**.
{% endstep %}

{% step %}

### Najděte Raventic

Vyhledejte sekci **Raventic** (nebo klikněte na ikonu lupy).
{% endstep %}

{% step %}

### Otevřete nastavení modulu

Otevře se nastavení modulu s těmito záložkami:

* **Obecné** - aktivace a základní nastavení
* **Dropdown** - nastavení našeptávače
* **Výsledky hledání** - nastavení stránky s výsledky
* **Pokročilé** - jazyk, měna a vlastní styly
  {% endstep %}
  {% endstepper %}

## Aktivace a propojení

{% stepper %}
{% step %}

### Získání API klíče

Přihlaste se do administrace Raventic a zkopírujte váš API klíč (typicky začíná prefixem regionu, např. „euc…").
{% endstep %}

{% step %}

### Nastavení v e-shopu

Otevřete **Nastavení → Raventic**.

Na záložce **Obecné** vyplňte:

* **API klíč** - vložte klíč z administrace Raventic
* **Aktivovat Raventic na e-shopu** - zapněte přepínač

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

### Volba funkcí

Po zadání API klíče si můžete vybrat, které funkce chcete aktivovat:

* **Vyhledávací dropdown** - chytré tipy přímo ve vyhledávacím poli
* **Widget na stránce výsledků** - přehledná stránka s filtry a výsledky
* **Raventic Analytics** - měření a analytika vyhledávání

Všechny funkce lze zapínat a vypínat nezávisle na sobě.

## Vyhledávací dropdown

### Co je vyhledávací dropdown?

Dropdown je „našeptávač", který se zobrazí pod vyhledávacím polem, jakmile zákazník začne psát. Nabízí:

* Nalezené produkty s obrázky a cenami
* Kategorie odpovídající dotazu
* Články z blogu
* Doporučené a oblíbené produkty

### Nastavení chování

Na záložce **Dropdown** můžete nastavit:

**Zobrazení obsahu:**

* **Zobrazit bestsellery / oblíbené produkty** - ukáže doporučené produkty před zadáním dotazu
* **Zobrazit stav skladu** - u produktů se zobrazí dostupnost
* **Zobrazit kategorie** - v dropdownu se objeví i odpovídající kategorie
* **Zobrazit články** - zahrne do výsledků i články z blogu

**Počet výsledků:**

* **Počet výsledků v dropdownu** - kolik produktů se zobrazí (výchozí: 10)

### Úprava textů

Pokud chcete změnit výchozí texty, zaškrtněte **Upravit texty a popisky**. Můžete upravit:

* **Placeholder ve vyhledávání** - text v prázdném poli (např. „Napište, co hledáte")
* **Uvítací zpráva** - zobrazí se před zadáním dotazu
* **Text při žádných výsledcích** - když nic nenajdeme
* **Text tlačítka „zobrazit vše"** - pro přechod na stránku výsledků
* **Nadpisy sekcí** - produkty, kategorie, články, doporučené
* **Popisek tlačítka produktu** - typicky „Detail" nebo „Do košíku"

## Stránka výsledků hledání

### Jak funguje?

Widget na stránce výsledků nahradí standardní zobrazení vyhledávání. Zákazník získá:

* Přehledný výpis nalezených produktů
* Filtrování podle kategorií, výrobců a ceny
* Možnost řazení výsledků
* Responzivní zobrazení na všech zařízeních

### Nastavení chování

Na záložce **Výsledky hledání** nastavíte:

**Základní nastavení:**

* **Počet produktů na stránku** - kolik produktů se zobrazí najednou (výchozí: 60)
* **Zobrazit filtr výrobců** - přidá filtrování podle značek
* **Zobrazit stav skladu** - u produktů se zobrazí dostupnost

### Úprava textů

Zaškrtněte **Upravit texty a popisky** pro změnu:

* **Titulek výsledků** - text nad výsledky, např. „Hledáte: ..."
* **Titulek bez dotazu** - když zákazník otevře stránku bez zadání
* **Nadpisy filtrů** - výrobce, cena, filtry
* **Texty tlačítek** - zobrazit filtry, zrušit filtry

## Analytika

### Co měří Raventic Analytics?

Analytika sleduje, jak zákazníci používají vyhledávání:

* Co zákazníci hledají
* Na které výsledky klikají
* Které dotazy nevrací výsledky
* Jak úspěšné je vyhledávání

### Aktivace analytiky

{% stepper %}
{% step %}

### Zapněte analytiku

Na záložce **Obecné** zapněte **Zapnout Raventic Analytics**.
{% endstep %}

{% step %}

### Načtení měřicího kódu

Měřicí kód se automaticky načte na všech stránkách e-shopu.
{% endstep %}

{% step %}

### Zobrazte data

Data najdete v administraci Raventic.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Poznámka:** Analytika respektuje souhlas s cookies. Zákazníci, kteří odmítnou analytické cookies, nebudou sledováni.
{% endhint %}

## Pokročilé nastavení

### Jazyk a měna

Na záložce **Pokročilé** můžete nastavit:

* **Locale** - kód jazyka (např. cs-CZ, sk-SK, en-US)
* **Měna** - kód měny (např. CZK, EUR)
* **Počet desetinných míst u ceny** - kolik míst za čárkou

Pokud necháte prázdné, použijí se hodnoty z nastavení e-shopu.

### Query parametr

* **Query parametr (URL)** - název parametru v URL pro vyhledávání (výchozí: `q`)

Příklad: `vaseshop.cz/hledat?q=boty`

### Vlastní styly

Pole **Vlastní CSS styly** umožňuje upravit vzhled widgetů:

* Barvy tlačítek a odkazů
* Velikosti písma
* Skrytí nebo zobrazení prvků

## Často kladené otázky

### Obecné

<details>

<summary>Q: Kde získám API klíč?</summary>

A: API klíč získáte v administraci Raventic po registraci a aktivaci účtu.

</details>

<details>

<summary>Q: Musím používat všechny funkce?</summary>

A: Ne, každou funkci (dropdown, stránka výsledků, analytika) můžete zapínat a vypínat nezávisle.

</details>

<details>

<summary>Q: Funguje Raventic i na mobilních zařízeních?</summary>

A: Ano, všechny widgety jsou plně responzivní a fungují na všech zařízeních.

</details>

### Vyhledávání

<details>

<summary>Q: Proč zákazníci nenacházejí některé produkty?</summary>

A: Ověřte, že jsou produkty správně naimportované do Raventic. Synchronizace produktů probíhá automaticky.

</details>

<details>

<summary>Q: Mohu ovlivnit, které produkty se zobrazí jako první?</summary>

A: Ano, pořadí výsledků můžete ovlivnit v administraci Raventic pomocí pravidel řazení.

</details>

<details>

<summary>Q: Jak dlouho trvá, než se změny projeví?</summary>

A: Změny v nastavení se projeví okamžitě. Změny produktů se synchronizují průběžně.

</details>

### Vzhled

<details>

<summary>Q: Dropdown se nezobrazuje správně – co dělat?</summary>

A: Zkontrolujte, zda máte správně nastavené CSS selektory pro vyhledávací pole. Výchozí hodnoty fungují pro standardní šablonu.

</details>

<details>

<summary>Q: Mohu změnit barvy widgetů?</summary>

A: Ano, použijte pole Vlastní CSS styly na záložce Pokročilé.

</details>

<details>

<summary>Q: Widget překrývá jiné prvky na stránce – jak to vyřešit?</summary>

A: Pomocí vlastních CSS stylů můžete upravit vrstvení (z-index) nebo pozicování prvků.

</details>

### Cookies a ochrana osobních údajů

<details>

<summary>Q: Respektuje Raventic souhlas s cookies?</summary>

A: Ano, analytika se načítá pouze pokud zákazník souhlasí s analytickými cookies.

</details>

<details>

<summary>Q: Ukládá Raventic osobní údaje?</summary>

A: Raventic zpracovává pouze anonymizovaná data o vyhledávání. Podrobnosti najdete v dokumentaci Raventic.

</details>