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 Nováku`
`last-name-addressing`	`customer.metafields['czech-names-app']['last-name-addressing']`	`Nováku`
`gender`	`customer.metafields['czech-names-app'].gender`	`male`

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 Nováku. Pokud metapole neexistuje, nebude zobrazeno nic.

Bezpečné použití s fallbackem

Doporučujeme vždy použít podmínku s fallbackem na standardní hodnotu Shopify — pro případ, že zákazník byl vytvořen před instalací aplikace nebo jeho jméno nelze vyskloňovat:

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

Kratší zápis pomocí Liquid filtru default:

{{ customer.metafields['czech-names-app'].addressing | default: customer.first_name }}

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:

Dobrý den, {{ customer.metafields['czech-names-app'].addressing | default: customer.first_name }},

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

{% assign gender = customer.metafields['czech-names-app'].gender %}
{% if gender == 'male' %}
  Vážený pane {{ customer.metafields['czech-names-app'].addressing | default: customer.first_name }},
{% elsif gender == 'female' %}
  Vážená paní {{ customer.metafields['czech-names-app'].addressing | default: customer.first_name }},
{% else %}
  Dobrý den, {{ customer.metafields['czech-names-app'].addressing | default: customer.first_name }},
{% endif %}

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, {{ customer.first_name }}!
  {% endif %}
{% endif %}

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 | default: customer.first_name %}
{% assign last = customer.metafields['czech-names-app']['last-name-addressing'] | default: customer.last_name %}
{% assign gender = customer.metafields['czech-names-app'].gender %}

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

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.