KT Shortcode

Pro snadnější definici a práci s vlastními shortcody v rámci WP je ve frameworku připravena třída KT_Shortcode_Base. Ta v první řadě napomáhá registraci vlastního shortcodu do systému (WP) a také vynucuje definici zpracování (handler). A dále případně připravuje půdu i pro vlastní tlačítko v editoru (obsah – TinyMCE), což ale vyžaduje i další aktivitu – vlastní obrázek (ikonu) a JS skript pro obsluhu.

Definice

Vlastní shortcode je třída, která dědí od KT_Shortcode_Base a měla by být vložena do adresáře shortcodes, přičemž její soubor by měl končit na příponu „_shortcode.inc.php“, např. kt/yours/shortcodes/kt_xxx_car_shortcode.inc.php.

kt_xxx stanovuje předponu vlastního modulu v projektu kvůli autoloadu podle konvence rozložení projektu a nazývání adresářů a souborů.

Inicializace

Pokud máme shortcode definovaný, tak ho můžeme vložit do projektu a zaregistrovat. Za tímto účelem je nejvhodnější vytvořit nový nebo doplnit existující „definiční“ soubor, např. kt/yours/requires/definitions/kt_car_definitions.inc.php:

Vlastní tlačítko

Abych mohli definovat vlastní tlačítko, tak je třeba rozšířit konstruktor shortcodu o basové vložení klíče a skriptu pro tlačítko:

V inicializaci dále musíme vložit náš unikátní klíč tlačítka v rámci administračního WP editoru a skript, ve kterém je obsluha tlačítka:

Samozřejmě ještě bude potřeba definovat samotný skript tlačítka, který je řešen vždy individuálně, v našem případě např. kt/yours/js/kt-xxx-car-shortcode.js:

A v poslední řadě bychom neměli zapomenout ještě dodat ikonu tlačítka, v tom případě: kt/yours/images/car.png.



Odebírejte novinky z FW

Sledujte nás!

Tyto stránky využívají Cookies. Používáním těchto stránek vyjadřujete souhlas s používáním Cookies.Zjistit víceOK, rozumím