# Fogyasztó Barát Shopify App - Shop tulajdonosi útmutató

Ez az útmutató röviden és érthetően leírja, hogyan használd a Fogyasztó Barát Shopify appot a napi működés során. A célja az, hogy gyorsan átlásd, melyik beállítás mire való, mit kell bekapcsolni, és mire kell figyelni, ha valami nem a várt módon jelenik meg.

## Tartalomjegyzék
1. [Mi az app célja](#1-mi-az-app-celja)
2. [Widget ID](#2-widget-id)
3. [Fogyasztó Barát widget](#3-fogyaszto-barat-widget)
4. [Értékelés a köszönő oldalon](#4-ertekeles-a-koszono-oldalon)
5. [ÁSZF oldal beállítása](#5-aszf-oldal-beallitasa)
6. [Adatkezelési oldal beállítása](#6-adatkezelesi-oldal-beallitasa)
7. [Checkout alján linkelt szabályzatok frissítése](#7-checkout-aljan-linkelt-szabalyzatok-frissitese)
8. [PDF csatolmány a rendelés-visszaigazoló emailhez](#8-pdf-csatolmany-a-rendeles-visszaigazolo-emailhez)
9. [Gyakori hibák](#9-gyakori-hibak)

## 1. Mi az app célja

Az app segít abban, hogy a Fogyasztó Barát elemek megjelenjenek a Shopify boltodban. Ide tartozik a Fogyasztó Barát widget, a köszönő oldali értékelés, valamint az ÁSZF és adatkezelési tartalmak kezelése normál Shopify oldalakon és a checkout alján linkelt jogi tartalmakban.

## 2. Widget ID

A `Widget ID` a Fogyasztó Barát rendszerből kapott egyedi azonosító. Ezt a Fogyasztó Barát admin felületén, a `Beágyazható kódok` menüben találod. A Fogyasztó Barát widget, az értékelés és a jogi tartalmak működéséhez ez az azonosító szükséges, ezért ezt mindig pontosan kell megadni.

## 3. Fogyasztó Barát widget

A Fogyasztó Barát widget bekapcsolása az appban csak az első lépés. Ahhoz, hogy a widget tényleg meg is jelenjen a boltban, a Shopify Theme Editorban az app embedet is be kell kapcsolni és el kell menteni.

Ha a widget az appban be van kapcsolva, de a storefronton mégsem látszik, akkor a legtöbb esetben a Theme Editor oldalon maradt el a bekapcsolás.

## 4. Értékelés a köszönő oldalon

Az értékelés kapcsoló a köszönő oldalon megjelenő értékelési blokkot engedélyezi. Ennek működéséhez azonban nem elég az appban bekapcsolni a funkciót. A Shopify checkout editorban a megfelelő blokkot is hozzá kell adni.

Fontos tudni, hogy a köszönő oldalon nem a klasszikus Fogyasztó Barát widget jelenik meg, hanem egy külön blokk, amely az értékelő oldalra vezeti át a vásárlót.

## 5. ÁSZF oldal beállítása

Ha szeretnéd, hogy az ÁSZF külön Shopify oldalon is megjelenjen, először létre kell hoznod egy oldalt hozzá, ha még nincs. Ezután az appban ki kell választanod ezt az oldalt, be kell kapcsolnod az `ÁSZF oldal script engedélyezése` opciót, majd el kell mentened a beállítást.

Ekkor az app a kiválasztott oldalra beilleszti a Fogyasztó Barát ÁSZF Multifunkciós kódját.

## 6. Adatkezelési oldal beállítása

Az adatkezelési oldal beállítása ugyanígy működik. Létre kell hoznod vagy ki kell választanod a megfelelő Shopify oldalt, majd be kell kapcsolnod az `Adatkezelési oldal script engedélyezése` opciót és el kell mentened a beállítást.

Ekkor az app a kiválasztott oldalra beilleszti a Fogyasztó Barát adatkezelési Multifunkciós kódját.

## 7. Checkout alján linkelt szabályzatok frissítése

Az appban külön gomb van az ÁSZF és külön gomb az adatkezelési popup frissítésére. Ezek nem a normál Shopify oldalakat frissítik, hanem a Shopify checkout alján linkelt szabályzatok tartalmát.

Az ÁSZF frissítő gomb a Szolgáltatási feltételek popup tartalmát frissíti az aktuális hatályos ÁSZF-re. Ezzel együtt a visszaküldési vagy refund szabályzat tartalma is frissül, ami a rendelés-visszaigazoló email PDF csatolmányánál is fontos lehet.

Az adatkezelési frissítő gomb a Shopify Adatvédelmi szabályzat tartalmát frissíti. Ha ez nem működik, annak egyik gyakori oka az, hogy a Shopifyban az adatvédelmi szabályzat automatizált kezelés alatt áll. Ilyenkor előbb ki kell kapcsolni ezt az automatizálást.

## 8. PDF csatolmány a rendelés-visszaigazoló emailhez

Az app nem szerkeszti automatikusan a Shopify rendelés-visszaigazoló email sablonját, ezt neked kell kézzel beállítanod a Shopify adminban.

Menüút:
- `Beállítások > Értesítések > Order confirmation`

Az email sablonban a záró `</html>` tag elé illeszd be ezt a kódot:

```liquid
{%- if shop.terms_of_service.body != blank -%}
  {{ shop.terms_of_service | attach_as_pdf: "Terms of service" }}
{%- endif -%}

{%- if shop.refund_policy.body != blank -%}
  {{ shop.refund_policy | attach_as_pdf: "Refund policy" }}
{%- endif -%}
```

Ez azt eredményezi, hogy a Shopify a megfelelő szabályzat (policy) tartalomból PDF csatolmányt készít a rendelés-visszaigazoló emailhez.

## 9. Gyakori hibák

### 9.1. Nem jelenik meg a Fogyasztó Barát widget

Lehetséges okok:
- hiányzik a `Widget ID`
- nincs aktív előfizetés
- az appban nincs bekapcsolva a Fogyasztó Barát widget
- a Theme Editorban nincs bekapcsolva az app embed

### 9.2. Nem jelenik meg az értékelés a köszönő oldalon

Lehetséges okok:
- az appban nincs bekapcsolva az értékelés
- a checkout editorban nincs hozzáadva a megfelelő blokk

### 9.3. Nem frissül az adatkezelési szabályzat

Lehetséges ok:
- a Shopify adatvédelmi szabályzata automatizált kezelés alatt áll

### 9.4. Nem tudod, melyik oldalt kell kiválasztani

Teendő:
- hozz létre külön Shopify oldalt az ÁSZF-nek
- hozz létre külön Shopify oldalt az adatkezelési tájékoztatónak
- utána térj vissza az appba és válaszd ki ezeket az oldalakat