Použití v Liquid

Jakmile aplikace zapíše metapole do zákaznického profilu, jsou dostupná ve všech Shopify Liquid šablonách — od notifikačních emailů až po stránky v obchodě. Tato stránka popisuje, jak k nim přistupovat a jak je bezpečně používat.

Dostupná metapole

Aplikace zapisuje tři metapole v namespace czech-names-app:

Klíč	Liquid přístup	Příklad hodnoty
addressing	customer.metafields['czech-names-app'].addressing	Jane
last-name-addressing	customer.metafields['czech-names-app']['last-name-addressing']	Nováku
gender	customer.metafields['czech-names-app'].gender	male

Upozornění

addressing obsahuje samotné křestní jméno v 5. pádu, nikoliv kompletní oslovení. Celé oslovení si složte z addressing a last-name-addressing.

Pokud aplikace neumí vyskloňovat křestní jméno zákazníka, nezapíše žádné z těchto tří metapolí. Šablona proto musí dávat smysl i bez jména.

Poznámka

Proměnné lze přidat buď přes přidání bloku aplikace v Customizeru šablony (Nastavení → Pokladna → Přizpůsobit → Bloky aplikací), nebo přímo do Liquid kódu šablony.

Základní použití

Nejjednodušší způsob, jak zobrazit oslovení v emailu nebo šabloně:

{{ customer.metafields['czech-names-app'].addressing }}

Pokud má zákazník metapole nastaveno, zobrazí se například Jane. Pokud metapole neexistuje, nebude zobrazeno nic.

Bezpečné použití s fallbackem

Metapole chybí u zákazníků vytvořených před instalací aplikace a u zákazníků, jejichž křestní jméno nelze vyskloňovat. Pro tyto případy potřebujete fallback.

Nebezpečí

Do fallbacku nikdy nedávejte customer.first_name. Shopify v tomto poli drží jméno v 1. pádu, takže vznikne „Dobrý den, Lenka” místo „Dobrý den, Lenko” — a to je přesně ten výsledek, kvůli kterému zákazníci hlásí, že aplikace nefunguje. Fallback se uplatní právě u zákazníků, pro které aplikace skloňovaný tvar nemá; správný 5. pád pro ně neexistuje. Jediná bezpečná varianta je pozdrav bez jména.

{% if customer.metafields['czech-names-app'].addressing != blank %}
  Dobrý den, {{ customer.metafields['czech-names-app'].addressing }},
{% else %}
  Dobrý den,
{% endif %}

Tip

Liquidový filtr default se tady nehodí — | default: customer.first_name doplní právě ten nesklonovaný tvar. Použijte podmínku, která celé jméno vynechá.

Použití v notifikačních emailech

Shopify notifikační emaily (objednávkové potvrzení, potvrzení přepravy apod.) jsou přístupné v Nastavení → Oznámení. Zde nahraďte standardní oslovení skloňovanou verzí.

Příklad — řádek s pozdravem v emailu:

{% assign czech_first = customer.metafields['czech-names-app'].addressing %}
{% if czech_first != blank %}Dobrý den, {{ czech_first }},{% else %}Dobrý den,{% endif %}

Příklad — s genderovým titulem pomocí metapole gender:

Po „Vážený pane” a „Vážená paní” následuje příjmení, tedy metapole last-name-addressing.

{% assign gender = customer.metafields['czech-names-app'].gender %}
{% assign czech_first = customer.metafields['czech-names-app'].addressing %}
{% assign czech_last = customer.metafields['czech-names-app']['last-name-addressing'] %}

{% if czech_last != blank and gender == 'male' %}
  Vážený pane {{ czech_last }},
{% elsif czech_last != blank and gender == 'female' %}
  Vážená paní {{ czech_last }},
{% elsif czech_first != blank %}
  Dobrý den, {{ czech_first }},
{% else %}
  Dobrý den,
{% endif %}

Upozornění

Šablony notifikačních emailů jsou sdílené pro všechny zákazníky obchodu. Vždy počítejte s větví bez jména — metapole u části zákazníků chybí a doplnit ho nesklonovaným jménem není řešení.

Použití ve Flow (automatizace)

Shopify Flow umožňuje použití metapolí v podmínkách a akcích. V editoru Flow přistupujte k metapolím zákazníka jako:

customer.metafields["czech-names-app"]["addressing"]

Typické použití: personalizovaný email odeslaný přes Flow, podmínka na hodnotu gender pro různé varianty zprávy.

Použití na stránkách obchodu (Theme)

Metapole zákazníka jsou dostupná v theme souborech na stránkách, kde je zákazník přihlášen — například na stránce účtu nebo v pokladně.

{% if customer %}
  {% if customer.metafields['czech-names-app'].addressing != blank %}
    Vítejte, {{ customer.metafields['czech-names-app'].addressing }}!
  {% else %}
    Vítejte!
  {% endif %}
{% endif %}

Poznámka

Metapole zákazníka nejsou dostupná na stránkách, kde není zákazník přihlášen. Condition {% if customer %} zajišťuje, že kód se spustí pouze pro přihlášené zákazníky.

Přímý přístup k příjmení a rodu

Pokud potřebujete pracovat se jménem a příjmením zvlášť, nebo ručně sestavit oslovení bez použití šablony:

{% assign first = customer.metafields['czech-names-app'].addressing %}
{% assign last = customer.metafields['czech-names-app']['last-name-addressing'] %}
{% assign gender = customer.metafields['czech-names-app'].gender %}

{% if last != blank and gender == 'male' %}
  Vážený pane {{ last }},
{% elsif last != blank and gender == 'female' %}
  Vážená paní {{ last }},
{% elsif first != blank %}
  Dobrý den, {{ first }},
{% else %}
  Dobrý den,
{% endif %}

Poznámka

Ani tady nepoužívejte | default: customer.first_name — doplnilo by jméno v 1. pádu. Když metapole chybí, vynechte jméno úplně.

UI Extensions

Aplikace obsahuje 5 UI Extensions, které zobrazují oslovení přímo v administraci Shopify na vybraných místech:

Extension	Umístění
profile	Zákaznický profil
order-index	Seznam objednávek
order-status	Detail objednávky
thank-you	Stránka s poděkováním
checkout-reductions-before	Pokladna (před slevami)

Tyto extensions přidáte do příslušných stránek v Nastavení → Pokladna → Přizpůsobit v sekci Bloky aplikací nebo přímým přetažením na canvas editoru.

---

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