Přeskočit na obsah

Pro vývojáře

Modul zachytává WooCommerce e-maily pomocí filtru woocommerce_mail_callback_params a automaticky převádí křestní jméno do 5. pádu (vokativu) v pozdravu.

Vokativ se používá v češtině (a některých dalších slovanských jazycích) při přímém oslovení osoby. Jména mění svůj tvar - například “Václav” se změní na “Václave” při přímém oslovení. To zajišťuje gramaticky správné a přirozeně znějící pozdravy zákazníků.

// Původní: "Ahoj Václav," (gramaticky nesprávně)
// Po úpravě: "Ahoj Václave," (automaticky skloňováno, správný tvar)

Modul používá PHP knihovnu pro skloňování českých jmen. Podporuje:

  • Mužská jména
  • Ženská jména
  • Výjimky (např. jména končící na “nis”)

V nastavení Nahradit křestní jméno můžete použít:

ZnačkaPopis
{first_name}Křestní jméno v 5. pádu
{last_name}Příjmení v 5. pádu
{full_name}Celé jméno v 5. pádu

Modul podporuje omezení na konkrétní jazyky pomocí nastavení allowed_languages. To je užitečné pro vícejazyčné weby, kde by se vokativ měl aplikovat pouze pro e-maily v češtině.

Modul automaticky respektuje aktuální jazyk. Transformace na vokativ se aplikuje pouze tehdy, když jazyk e-mailu odpovídá povoleným jazykům nastaveným v modulu.

Modul používá prioritu 20 na filtru woocommerce_mail_callback_params. Pokud potřebujete upravit obsah e-mailu před nebo po transformaci na vokativ, můžete použít nižší nebo vyšší prioritu.