Začínáme

Tato příručka vás provede celým procesem — od instalace aplikace až po první správně oslovenou zprávu zákazníkovi. Nastavení zabere přibližně 10 minut.

Předpoklady

Před instalací zkontrolujte, že váš obchod splňuje tyto podmínky:

Shopify obchod s aktivním zákazníkem (pro ověření funkčnosti)
Zákazníci s českými jmény (aplikace je určena pro česká jména)
Volitelně: aktivní Klaviyo účet pro emailovou personalizaci

Krok 1: Instalace z App Store

Otevřete stránku aplikace Skloňování jmen na Shopify App Store.
Klikněte na Instalovat.
Přihlaste se do svého Shopify obchodu, pokud budete vyzváni.
Na obrazovce souhlasu s oprávněními klikněte na Instalovat.

Aplikace vyžaduje tato oprávnění:

Zobrazit (read_customers) — čtení zákaznických dat
Upravit (write_customers) — zápis výsledků skloňování jako metapole

Krok 2: Potvrzení tarifu

Po instalaci se zobrazí stránka s potvrzením tarifu. Aplikace automaticky detekuje, zda provozujete Shopify Plus obchod, a zobrazí odpovídající tarif předvybraný — Regular ($9.90/měsíc) nebo Shopify Plus ($19.99/měsíc). Stačí předplatné potvrdit.

Oba tarify zahrnují 14denní zkušební období zdarma.

Podrobnosti o tarifech najdete na stránce Tarify a ceny.

Krok 3: Nastavení šablony oslovení

Po aktivaci přejděte v aplikaci do sekce Jak použít a nastavte šablonu oslovení.

Výchozí šablona kombinuje křestní jméno i příjmení:

{{czechFirstName}} {{czechLastName}}

Výsledek: Jane Nováku

Šablona s titulem podle pohlaví:

{male:Pane }{female:Paní }{{czechFirstName}} {{czechLastName}}

Výsledek pro muže: Pane Jane Nováku Výsledek pro ženu: Paní Jano Nováková

Podrobný popis systému šablon a genderových podmínek najdete na stránce Šablony oslovení.

Krok 4: Ověření funkčnosti

Nejsnazší způsob, jak ověřit, že aplikace funguje správně:

Přejděte do Zákazníci v administraci Shopify.
Otevřete zákaznický profil s českým jménem.
Klikněte na tlačítko s třemi tečkami, vyberte Upravit a uložte zákazníka beze změn.
Počkejte přibližně 30 sekund.
Sjeďte dolů na sekci Metapole, klikněte na „Zobrazit vše” a nahoře klikněte na tlačítko „Zobrazit nestrukturovaná metapole” — hledejte hodnoty v namespace czech-names-app.

Měli byste vidět tři metapole:

Metapole	Příklad hodnoty
`czech-names-app.addressing`	`Jane`
`czech-names-app.last-name-addressing`	`Nováku`
`czech-names-app.gender`	`male`

Krok 5: Použití oslovení

Jakmile jsou metapole nastavena, můžete je začít používat:

Shopify emaily a notifikace — viz Použití v Liquid
Klaviyo kampaně — viz Integrace s Klaviyo

Omezení skloňování

Ne všechna jména lze vyskloňovat. Aplikace ponechá původní hodnotu (neskloňovanou) v těchto případech:

Jméno obsahuje pomlčku (např. Jan-Pavel)
Jméno obsahuje mezeru (např. María José)
Jméno obsahuje speciální znaky mimo českou abecedu
Jméno je kratší než 2 znaky

Pole gender bude v takovém případě nastaveno na unknown. Šablony s genderovými podmínkami pak použijí výchozí tvar.

Časté dotazy při prvním nastavení

Proč se metapole nezobrazují? Zkontrolujte nejprve stav předplatného — aplikace zpracovává zákazníky pouze při aktivní fakturaci. Pokud je fakturace aktivní, zkuste zákazníka ručně uložit v administraci Shopify a počkejte 30 sekund.

Lze zpracovat všechny stávající zákazníky najednou? Hromadné zpracování existujících zákazníků není v aplikaci dostupné. Metapole se zapisují při každé aktualizaci zákazníka — stávající zákazníci budou doplněni postupně, jak budou provádět nákupy nebo jak budete jejich profily upravovat.

Funguje aplikace i pro slovenská jména? Aplikace je optimalizována pro česká jména. Slovenská jména mohou být skloňována nesprávně.

Potřebujete další pomoc? Napište nám na integrace@soundsgood.agency.