Chcete-li správně skloňovat jméno osoby, která vyplní váš formulář, přímo v e-mailu, který se automaticky zašle – je to snadné.
Nejprve se zaregistrujte na https://www.sklonovani-jmen.cz, ať máte svůj vlastní API klíč.
V Elementor formuláři přidejte pole pro křestní nebo příjmení a to, které se má skloňovat pojmenujte jeho ID „name“.
V mém případě jsem potřeboval křestní jméno v pátém pádě – pro tento účel použijte níže uvedený kód. Pro další varianty postupujte podle návodu na webu nebo se obraťte na ChatGPT, který vám rád pomůže 🙂
Kód snippetu
Přidej si následující kód do nového snippetu v pluginu Code Snippets. Nezapomeňte v kódu přepsat váš API klíč.
// Registrace shortcodu pro oslovení v pátém pádě bez oslovení "paní/pane"
function osloveni_paty_pad_shortcode() {
// Zkontrolujeme, zda je jméno k dispozici ve formuláři
if (!isset($_POST['form_fields']['name'])) {
return ''; // Pokud není jméno dostupné, vrátíme prázdný text
}
$jmeno = sanitize_text_field($_POST['form_fields']['name']);
$pad = "5"; // Používáme pátý pád pro oslovení
$klic_api = "XXXXXXXX"; // Váš API klíč
$jmeno_url = urlencode($jmeno); // Jméno escapujeme pro URL
// Voláme API s parametrem pro vypnutí oslovení podle dokumentace
$vracena_hodnota = file_get_contents("https://www.sklonovani-jmen.cz/api?klic=$klic_api&pad=$pad&jmeno=$jmeno_url&pouzit-osloveni=ne");
// Kontrola na chyby API: pokud vrátí číslo, použijeme univerzální oslovení
if (is_numeric($vracena_hodnota)) {
switch ($vracena_hodnota) {
case 1:
return "Neplatný API klíč";
case 3:
return "Vyčerpaný kredit pro API";
case 4:
return "Chybný parametr pádu";
case 5:
return "Chybějící hodnota parametru jmeno";
case 6:
return "Chybí povinný parametr";
case 7:
return "Neplatný řetězec v parametru jmeno";
case 8:
return "Vážení"; // výchozí oslovení pro právnické osoby
default:
return "Vážený uživateli"; // obecné oslovení pro neočekávané chyby
}
}
// Vrací správný tvar jména, pokud nebyla nalezena chyba
return htmlspecialchars($vracena_hodnota);
}
add_shortcode('osloveni_paty_pad', 'osloveni_paty_pad_shortcode');
Použití shortcodu v e-mailu
Nyní můžeš použít shortcode
[ osloveni_paty_pad ]
(bez mezer u závorek) v e-mailu a bude vracet pouze křestní jméno ve správném pádě, například:
Dobrý den, [ osloveni_paty_pad ],
děkujeme za vaši zprávu. Budeme vás kontaktovat co nejdříve.