Jak vytvořit vlastní WordPress Shortcodes
Ve verzi 2.5 WordPress představil krátké kódy a všichni jsme je pravděpodobně používali najednou. Obvykle se dodávají s pluginy, nebo dokonce i témata, a to, co dělají, je sledovat, když vložíte něco uvnitř hranatých závorek, pak je nahraďte jiným obsahem; může to být jednoduchá věta nebo by to mohlo být masivní PHP funkce, to vše závisí na tom, co jste instruovali WordPress udělat.
Přiložené zkratky jsou skvělé a podstatně urychlují věci, ale nebylo by skvělé vědět, jak vytvořit vlastní zkratky?
V tomto článku vás provedu vytvořením jednoduchých krátkých kódů WordPress, které vám pomohou vytvořit libovolnou funkčnost, kterou se vám líbí.
Jednoduchý krátký kód
Klávesnice API pracuje velmi jednoduše: nejprve je potřeba vytvořit funkci zpětného volání, která bude spuštěna kdykoli se použije zkratka; pak musíte tuto funkci spojit s určitým zkráceným kódem, který je připraven k použití. Kód je často umístěn v souboru functions.php, ale pokud máte v plánu mít mnoho krátkých kódů, má smysl vytvořit samostatný soubor a zahrnout tento soubor do souboru functions.php.
V našem prvním příkladu chceme vytvořit krátký kód, který vytvoří nějaký lorem ipsum při každém psaní [lorem] do editoru. Nejprve musíme vytvořit funkci zpětného volání, která vrátí lorem ipsum (v krátkých kódech neredukujeme nic, vrátíme vše):
function lorem_function() {return 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec nec nulla vitae lacus mattis volutpat eu at sapien. Nunc interdum congue libero, quis laoreet elit sagittis ut. Pellentesque lacus erat, dictum condimentum pharetra vel, malesuada volutpat risus. Nunc sit amet risus dolor. Etiam posuere tellus nisl. Integer lorem ligula, tempor eu laoreet ac, eleifend quis diam. Proin cursus, nibh eu vehicula varius, lacus elit eleifend elit, eget commodo ante felis at neque. Integer sit amet justo sed elit porta convallis a at metus. Suspendisse molestie turpis pulvinar nisl tincidunt quis fringilla enim lobortis. Curabitur placerat quam ac sem venenatis blandit. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Nullam sed ligula nisl. Nam ullamcorper elit id magna hendrerit sit amet dignissim elit sodales. Aenean accumsan consectetur rutrum.';}Dále musíme tento krátký kód přidat do aplikace WordPress pomocí funkce add_shortcode v našem souboru functions.php nebo v souboru, který je do něj zahrnut. Tato funkce přidá krátký kód a také jej propojuje s funkcí, kterou jsme právě vytvořili. add_shortcode má pouze dva argumenty, první je jméno, které chceme mít tento zkrácený kód (co budeme psát mezi hranatými závorkami) a druhou funkcí, kterou chceme připojit k tomuto zkratce:
add_shortcode('lorem', 'lorem_function');To je vše, co potřebujete k vytvoření jednoduchého shortcode ve WordPressu.
Přidávání parametrů
Pokud budeme pokračovat s tímto myšlenkovým nápadem na obsah, často potřebujeme obrázky v našem obsahu při přípravě našich modelů a tyto obrázky musí mít různé velikosti, takže nyní vytvoříme krátký kód pro vkládání obrázku, jako je tato:
[picture width="500" height="500"]Když se WordPress setká s tímto, chceme funkci, která vloží obrázek. Je třeba si přečíst atributy šířky a výšky, ale pouze v případě, že budeme také poskytovat výchozí hodnoty, takže je možné je použít bez atributů. Protože možná nemáme k dispozici obraz, použijeme to lorempixel.com službě, která nám poskytne náhodný obrázek.
Nejprve musíme vytvořit funkci:
function random_picture($atts) {extract(shortcode_atts(array('width' => 400,'height' => 200,), $atts));return '
';}Tuto funkci jsme pojmenovali random_picture a protože tento krátký kód bude schopen vzít argumenty, dal nám parametr $ atts . Pro použití atributů potřebujeme dvě funkce: shortcode_atts, což je funkce WordPress, která kombinuje naše atributy se známými atributy a v případě potřeby vyplní výchozí hodnoty; a extrakt PHP funkce, která, jak název napovídá, extrahuje ty atributy, které jsme nastavili pro náš shortcode. Konečně funkce vrátí hodnotu, kterou chceme, v tomto případě HTML kód pro náš obrázek v kombinaci s proměnnými šířky a výšky.
Jediná věc, kterou musíte udělat, je zaregistrovat tento krátký kód:
add_shortcode('picture', 'random_picture');Náš krátký kód je úplný, když zadáme [picture] , dá nám náhodný obrázek 400 x 200 a pokud použijeme atributy, můžeme vytvořit obrázek libovolné velikosti.
Závěr
Vytváření malých zkrácených kódů pro věci, které často používáme, nám pomáhá při psaní příspěvků z blogu, protože můžete dělat cokoliv, co chcete s krátkými kódy, může to být stejně jednoduché jako vrácení věty, nebo tak složité jako přidání formuláře nebo nejnovější příspěvky seřazené podle měsíce.
Vytvořili jste užitečné krátké kódy pro WordPress? Jaké zkratky chcete mít? Dejte nám vědět v komentářích.
Doporučený snímek / náhled, obrázek kódu přes Marjan Krebelj.