Pár článků zpět jsem psal o tom, jak využívat tkzv. shortcody v samotném wordpressu. Jsou to velmi užitečné zkratky. Tyto zkratky mají své uplatnění v případě, že něco častokrát někam vkládáte a je to neustále jeden a ten samý prvek. Ten prvek se může maličko měnit, jak si ukážeme v dnešním článku. A o čem že tedy dnešní článek bude, o tom jak si svůj vlastní shortcode vytvořit a využívat jeho potenciál.

Úvod

Nejdříve si řekneme něco o rozdělení samotných kódů, jsou dva druhy. Jeden je párový a druhý nepárový. Zápisy shortcodů se vkládají na konec souboru functions.php šablony, kterou zrovna používáte.

Párové: 

[nazev] OBSAH [/nazev]

Párové se využívají, když potřebujeme zapsat nějaký delší text a nechceme to vše zapisovat do parametrů. Jejich název je odvozen z toho, že se vždy využívají v páru, úvodní a závěrečný. Závěrečný má navíc na začátku „/“.

Nepárové:

[nazev parametr=“udaj“]

U nepárových stačí zapsat jen úvodní shortcode, jelikož žádný závěrečný nemají. V nepárovém shortcodu se využívají jenom parametry, kterých může být nekonečně mnoho.

Tvorba

Pro začátek si vytvoříme nepárový shortcode, který je o něco jednodušší, než jeho bratříček párový.

// Vytvorit shortcode
function nazev_funkce( $atts ) {
// Attributes
extract( shortcode_atts(
array(
'parametr' => 'zakl_nastav',
), $atts )
);
// Kod
return 'Do parametru bylo zadáno: '.$parametr.' další text, který následuje';
}
add_shortcode( 'nazev', 'nazev_funkce' );

Teď si pojďme říci co jsme to vlastně vytvořili. Vytvořili jsme jednoduchý shortcode, který nám po zadání
[nazev parametr="neco"] zobrazí v příspěvku text „Do parametru bylo zadáno: neco další text, který následuje“ . Pojďme si ovšem ukázat detailněji co jsme provedli.  Napřed jsme vytvořili funkci, která nám posbírá námi zadané parametry a pokud zadané nejsou, tak je doplní hlavními hodnotami. Tyto zadané parametry pak vypíše podle námi zadaných instrukcí. A na závěr vytvoříme shortcode, který tuto funkci využívá a pomocí, kterého hodnoty předáváme. Doufám, že je to z ukázky přímo jasné.

Teď, když víme jak se vytvoří nepárový shortcode, tak již jen malinkou úpravou docílíme toho, aby jsme z něj udělali párový.

// Vytvorit shortcode
function nazev_funkce( $atts , $obsah = null ) {
// Attributes
extract( shortcode_atts(
array(
'parametr' => 'zakl_nastav',
), $atts )
);
// Kod
return 'Do parametru bylo zadáno: '.$parametr.' do obsahu byl přidán text: '.$obsah.' další text, který následuje';
}
add_shortcode( 'nazev', 'nazev_funkce' );

Párový shortcode využívá jen ještě jednu hodnotu navíc a to obsah mezi samotným počátečním a závěrečným tagem. Proto, pokud zapíšeme do příspěvku shortcode [nazev parametr="neco"] Nějaký dlouhý text [/nazev].
Zobrazí se nám potom v příspěvku „Do parametru bylo zadáno: neco do obsahu byl přidán text: Nějaký dlouhý text další text, který následuje“ . Jinak jsou shortcody úplně identické. Pokud máte ještě nějaký dotaz, nebo vám v článku něco chybí nebojte se napsat dolů do komentářů :).