WordPress představil zkrácený API před šesti lety s vydáním WordPress 2.5. Krátké kódy nyní používá velké množství pluginů WordPress, které uživatelům umožňují přidávat obsah do svých příspěvků a stránek.
zkrácený API vám umožní vytvořit si vlastní shortcodes přidáním funkcí do funkcí motivu.php šablony (to se nachází na www.yourwebsite.com/wp-content/themes/yourtheme/).
kromě vytvoření své vlastní shortcodes, WordPress také obsahuje pět default shortcodes s WordPress core:
- audio-umožňuje vložit zvukové soubory.
- titulek-umožňuje zabalit titulky kolem obsahu. Běžně se používá s obrázky.
- embed-umožňuje vložit širokou škálu obsahu, jako je video, audio a Tweety.
- galerie-umožňuje vkládat galerie obrázků.
- video-umožňuje vkládat video soubory.
ačkoli výchozí WordPress shortcodes jsou běžně používány, jen velmi málo uživatelů WordPress využít zkrácený API a navrhnout jedinečné shortcodes pro své webové stránky. V tomto tutoriálu bych vám chtěl ukázat, jak přímočaré je vylepšit váš web pomocí vlastních krátkých kódů.
než začnete, ujistěte se, že provedete zálohu funkcí.php a další soubory, které upravíte před provedením změn na vašem živém webu.
Vytváření Zkrácený – Základní Příklad
, Aby vám dobré pochopení toho, jak WordPress Shortcode API funguje, pojďme začít s základní krátký kód funkce.
nezapomeňte, že krátké kódy by měly být vytvořeny pro obsah a funkce, které často používáte. Smyslem použití shortcodes je ušetřit někomu čas. Pokud budete něco používat pouze jednou, nemá smysl pro to vytvořit krátký kód.
píšu asi tucet článků týdně. Jedna věc, kterou často dělám, je povzbudit ty, kteří si užili mé články, aby se přihlásili k odběru mého blogu (nebo blogu, pro který píšu). V současné době to píšu pokaždé, nicméně jsem si mohl ušetřit spoustu času vytvořením krátkého kódu pro text.
Chcete-li to provést, mohl bych přidat funkci, jako je tato, do funkcí mého motivu.php šablony:
ti z vás, kteří nemají žádné zkušenosti s kódováním, mohou najít výše uvedený kód trochu skličující, ale je snadné pochopit, jakmile kód rozdělíte řádek po řádku.
první věc, kterou uděláme, je Přidat komentář nad naši funkci. To nám pomůže rychle zjistit, k čemu slouží naše funkce, když si kód zobrazíme později.
// Function to add subscribe text to posts and pages
pak definujeme naši funkci. Rád používám Názvy, které jsou samozřejmé, takže jsem nazval svou funkci „subscribe_link_shortcode“.
function subscribe_link_shortcode() {
dále definujeme naši zprávu. Návratový příkaz zobrazí naši zprávu, když je vyvolána. Ukládá také zprávy (na rozdíl od echo, která je vytiskne, ale neukládá).
funkce se poté zavře.
}
samotný zkrácený kód pak definujeme pomocí funkce add_shortcode. První zadaná proměnná definuje zkrácený kód, který má být použit, a druhá proměnná volá naši funkci (tj.
add_shortcode('subscribe', 'subscribe_link_shortcode');
po uložení funkcí.php šablony, můžeme nyní volat naši zprávu, kdykoli chceme pomocí shortcode přihlásit.
přihlásit Pomocí shortcode v poštou nebo stránku, bude produkovat následující zpráva:
Pokud se vám to líbilo tento článek, doporučuji vám přihlásit se k odběru Elegantní Témata blogu přes RSS.
použil jsem jednoduchý vzkaz v mém příkladu, však můžete změnit toto zobrazení mnoho dalších věcí. Můžete například vytvořit zkrácený kód pro zobrazování reklam adsense nebo formulář předplatného pro váš zpravodaj; a poté je vložte kamkoli chcete do svých článků.
Vytváření Shortcode S Atributy
Atributy mohou rozšířit funkčnost shortcodes tím, že umožňuje předat data přes váš shortcodes.
v níže uvedeném příkladu vám ukážu, jak lze atributy použít k rozšíření funkce, kterou jsme vytvořili dříve. Jak vidíte, většina kódu zůstává stejná.
$atts je název našeho pole atributů. Poté pomocí funkce extract importujeme proměnné z našeho pole (pomocí funkce shortcode_atts WordPress).
pak jsou definovány dva atributy: podtyp a a subtypeurl. Ty představují typ předplatného a URL předplatného. Tyto atributy jsou pak volány v naší zprávě.
náš výchozí typ předplatného je RSS a naše výchozí adresa URL předplatného je http://feeds.feedburner.com/ElegantThemes. Tyto informace se zobrazí, pokud nejsou definovány žádné atributy.
Proto, když přidáte následující příspěvek:
dostaneme následující výstup:
ujistěte se, že přihlásit se k budoucnosti Elegantní Témata aktualizace prostřednictvím RSS.
pokud definujeme atributy, výsledek je jiný. Následující Kód:
by výstup:
nezapomeňte se přihlásit k odběru budoucích aktualizací Elegant Themes pomocí RSS.
Nezapomeňte se přihlásit k odběru budoucích aktualizací elegantních témat pomocí Twitteru.
Nezapomeňte se přihlásit k odběru budoucích aktualizací elegantních témat Facebook.
Nezapomeňte se přihlásit k odběru budoucích aktualizací elegantních témat společností Google.
i když se jednalo o základní příklad, jak atributy práce, je snadné vidět, jak pluginu, mohou vývojáři použít shortcode API, aby složité funkce více uživatelsky přívětivé pro uživatele.
přehled
Pokud budete postupovat podle kroků uvedených v tomto tutoriálu, měli byste nyní mít základní znalosti o tom, jak si můžete vytvořit vlastní krátké kódy pro své webové stránky. Shortcodes jsou skvělý způsob, jak dělat složité úkoly jednodušší, takže doporučuji, abyste mít WordPress zkrácený API na paměti v budoucnu.
nebojte se, pokud tento tutoriál byl pro vás trochu obtížný. Všechny elegantní motivy jsou dodávány s krátkými kódy, díky nimž je publikování krásného obsahu Snadné. Krátké kódy lze použít k vytváření prezentací, sloupců a tabulek. Dokonce vám umožňuje chránit váš obsah heslem.
doufám, že se vám tento tutoriál líbil o vytvoření jedinečného krátkého kódu pro váš web WordPress. Pokud ano, doporučuji vám přihlásit se k odběru elegantních témat, protože máme v potrubí nějaký skvělý obsah 🙂
také vám znovu připomínám, abyste před úpravou zálohovali všechny soubory.