A WordPress hat évvel ezelőtt mutatta be a shortcode API-t a WordPress 2.5 megjelenésével. A rövid kódokat számos WordPress plugin használja, hogy a felhasználók tartalmat adhassanak hozzá hozzászólásaikhoz és oldalaikhoz.
a shortcode API lehetővé teszi, hogy saját rövid kódokat hozzon létre funkciók hozzáadásával a témafunkciókhoz.php template (ez található www.yourwebsite.com/wp-content/themes/yourtheme/).
amellett, hogy létre a saját shortcodes, WordPress is magában foglalja az öt alapértelmezett shortcodes a WordPress core:
- audio – lehetővé teszi, hogy beágyazza audio fájlokat.
- caption-lehetővé teszi, hogy lezárja feliratok körül tartalmat. Gyakran használják képekkel.
- embed-lehetővé teszi, hogy beágyazni egy széles körű tartalom, mint a videó, audio, tweets.
- galéria – lehetővé teszi a képgalériák beillesztését.
- video – lehetővé teszi a videofájlok beágyazását.
bár az alapértelmezett WordPress shortcodes általánosan használt, nagyon kevés WordPress felhasználó használja ki a shortcode API-t és tervezzen egyedi shortcodes-t a webhelyére. Ebben a bemutatóban szeretném megmutatni, hogy milyen egyenesen előre van, hogy javítsa webhelyét egyedi rövid kódokkal.
mielőtt elkezdené, győződjön meg róla, hogy biztonsági másolatot készít a funkciókról.php, valamint bármely más fájlokat szerkeszteni, mielőtt a változások az élő honlapján.
rövid kód létrehozása-alapvető példa
annak érdekében, hogy jól megértsük, hogyan működik a WordPress Shortcode API, kezdjük egy alapvető shortcode funkcióval.
kérjük, ne feledje, hogy a gyakran használt tartalmakhoz és funkciókhoz rövid kódokat kell létrehozni. A shortcodes használatának lényege, hogy időt takarítson meg valakinek. Ha csak egyszer fog használni valamit,nincs sok értelme létrehozni egy rövid kódot.
hetente körülbelül egy tucat cikket írok. Az egyik dolog, amit gyakran csinálok, arra ösztönzi azokat, akik élvezték a cikkeimet, hogy feliratkozzanak a blogomra (vagy a blogra, amelyre írok). Én jelenleg írni ezt ki minden alkalommal, azonban tudtam menteni magam egy csomó időt létrehozásával shortcode a szöveg.
ehhez hozzá tudtam adni egy ilyen funkciót a téma funkcióihoz.php sablon:
azok, akiknek nincs kódolási tapasztalata, kissé ijesztőnek találhatják a fenti kódot, azonban könnyű megérteni, ha a kódot soronként lebontja.
az első dolog, amit teszünk, egy megjegyzés hozzáadása a funkciónk felett. Ez segít nekünk gyorsan látni, hogy mi a funkciónk, amikor a kódot egy későbbi időpontban tekintjük meg.
// Function to add subscribe text to posts and pages
ezután meghatározzuk a függvényünket. Szeretek olyan neveket használni, amelyek magától értetődőek, ezért a funkciómat “subscribe_link_shortcode” – nak hívtam.
function subscribe_link_shortcode() {
ezután definiáljuk üzenetünket. A visszatérési nyilatkozat megjeleníti az üzenetünket, amikor hívják. Tárolja az üzeneteket is (szemben az echo-val, amely kinyomtatja, de nem tárolja).
a függvény ezután bezáródik.
}
ezután meghatározzuk a rövidkódot az add_shortcode funkció segítségével. Az első megadott változó határozza meg a használni kívánt rövidkódot, a második változó pedig a függvényünket (azaz a fent definiáltat).
add_shortcode('subscribe', 'subscribe_link_shortcode');
a funkciók mentése után.php sablon, most hívhatjuk üzenetünket, amikor csak akarjuk a rövid kód feliratkozását.
a feliratkozási rövid kód használatával egy üzenetben vagy oldalon a következő üzenet jelenik meg:
Ha élvezte ezt a cikket, azt javaslom, hogy iratkozzon fel az elegáns témák blogra RSS-en keresztül.
egy egyszerű üzenetet használtam a példámban, de ezt módosíthatod sok más dolog megjelenítéséhez. Például létrehozhat egy rövidkódot az adsense hirdetések vagy a hírlevél előfizetési űrlapjának megjelenítéséhez; majd helyezze be őket a cikkekbe bárhol, ahol csak akarja.
Létrehozása Hiány A Tulajdonságok
az Attribútumok lehet bővíteni a funkcionalitást shortcodes, lehetővé téve, hogy adja át az adatokat a shortcodes.
az alábbi példában megmutatom, hogyan lehet attribútumokat használni a korábban létrehozott funkció kibővítéséhez. Mint látható, sok a kód ugyanaz marad.
$atts az attribútum tömb neve. Ezután a kivonat funkciót használjuk változók importálására a tömbből (a shortcode_atts WordPress funkción keresztül).
ezután két attribútum kerül meghatározásra: altípus és altípus. Ezek az előfizetés típusát és az előfizetés URL-jét jelölik. Ezeket az attribútumokat ezután az üzenetünkben hívjuk meg.
alapértelmezett előfizetési típusunk RSS, alapértelmezett előfizetési URL-címünk pedig http://feeds.feedburner.com/ElegantThemes. Ez az információ akkor jelenik meg, ha nincsenek attribútumok definiálva.
Ezért, ha hozzáadjuk a következő poszt:
Mi lesz a következő kimenet:
biztos, hogy feliratkozás a jövőbeli Elegant Themes frissítések által RSS.
ha attribútumokat definiálunk, az eredmény más. A következő kód:
lenne kimenet:
ügyeljen arra, hogy iratkozzon fel a jövőben elegáns témák frissítések RSS.
feltétlenül iratkozzon fel a Twitter jövőbeli elegáns témáinak frissítéseire.
ügyeljen arra, hogy iratkozzon fel a jövő elegáns témák frissítések Facebook.
ügyeljen arra, hogy iratkozzon fel a jövőben elegáns témák frissítéseket a Google.
bár ez egy alapvető példa az attribútumok működésére, könnyű látni, hogy a plugin fejlesztők hogyan használhatják a shortcode API-t a bonyolult funkciók felhasználóbarátabbá tételéhez a felhasználók számára.
áttekintés
ha követi az oktatóanyagban leírt lépéseket, akkor most alapvető megértéssel kell rendelkeznie arról, hogyan hozhat létre saját egyéni rövid kódokat a webhelyéhez. Shortcodes egy nagyszerű módja annak, hogy bonyolult feladatok egyszerűbb, ezért javasoljuk, hogy tartsa a WordPress shortcode API szem előtt a jövőben.
ne aggódjon, ha ez a bemutató kissé nehéz volt az Ön számára. Minden elegáns témák tervez jön csomagolva shortcodes, hogy közzétételi szép tartalom egyszerű. A shortcodes lehet használni, hogy diavetítések, oszlopok, táblázatok. Azt is lehetővé teszi, hogy jelszóval védje a tartalmat.
remélem, hogy élvezte ezt a bemutatót a WordPress webhelyének egyedi rövid kódjának létrehozásáról. Ha igen, azt javasoljuk, hogy iratkozzon fel elegáns témák, mint mi van néhány nagy tartalom a csővezeték 🙂
is, ismét emlékeztetem, hogy készítsen biztonsági másolatot a fájlokat, mielőtt szerkeszteni őket.