WordPress shortcodes használják 1) mennyiségének csökkentése kódot kell írni; 2) egyszerűsítése a használata WordPress plugins, témák, és egyéb funkciók. Úgy viselkednek, mint a makrók,amikor beszúr egy rövid kódot, akkor helyébe egy kódrészletet. Bármi lehet.

a WordPress tartalmaz néhány előre definiált rövidkódot, mint például a és a , valamint számos népszerű plugin és téma is szerepel benne. Saját egyéni rövid kódokat is létrehozhat, például oszlopok létrehozása a WordPress webhelyén.

ebben a bejegyzésben lépésről lépésre végigvezetjük Önt a saját egyéni rövid kódok létrehozásának folyamatán. Végigvezetjük Önt az új rövid kód létrehozásának teljes folyamatán, és megmutatjuk, hogyan módosíthatja és vezérelheti a rövid kód attribútumokat és funkciókat.

Felhívjuk figyelmét, hogy ez egy fejlettebb üzenet, amely részletekbe kerül a rövid kódok létrehozásáról. Ha dolgozik kód túl a technikai szakértelem, és csak azt szeretné, hogy a legegyszerűbb módja annak, hogy az induláshoz létrehozása és használata shortcodes érdemes kezdeni egy shortcode plugin.

saját rövid kódok létrehozásakor két dolgot kell tennie:

1. hozza létre a shortcode handler funkciót. A shortcode függvény olyan függvény, amely opcionális paramétereket (attribútumokat) vesz fel, és eredményt ad vissza.
2. regisztrálja a shortcode handler funkciót. Használja a beépített WordPress add_shortcut funkciót az egyéni rövid kódok regisztrálásához.

WordPress előkészítése egyéni rövid kódokhoz

bár ez nem szükséges, jó ötlet, hogy az egyéni rövid kódokat saját fájljukban tartsa. Alternatív megoldásként hozzáadhatja őket a téma functions.php fájljához.

először hozzon létre egy új custom-shortcodes.php nevű fájlt, majd mentse el ugyanabban a mappában, mint a téma functions.php fájlja.

ezután az újonnan létrehozott fájl belsejében adja hozzá a következő kódblokkot:

<?php ?>

ezután nyissa meg a functions.php fájlt, majd adja hozzá a következő kódsort:

include('custom-shortcodes.php');

most már készen áll az egyéni rövid kódok hozzáadására.

Basic Shortcodes

ebben az első példában létrehozunk egy alapvető WordPress shortcode-ot,amely beilleszti az Indie avatar képének napját.

a rövid kód létrehozása

az első lépés a rövid kód funkció létrehozása. A custom-shortcodes.php fájl belsejében adja hozzá a következő kódblokkot:

function dotiavatar_function() { return '<img src="http://dayoftheindie.com/wp-content/uploads/avatar-simple.png" alt="doti-avatar" width="96" height="96" class="left-align" />';}

a fenti kódpéldában a dotiavatar_function függvény egy avatar-simple.pngnevű előre meghatározott képet ad vissza.

a következő lépés a rövid kód regisztrálása a WordPress segítségével a beépített funkció segítségével add_shortcode. Még mindig belül custom-shortcodes.php, adja hozzá a következő kódsort:

add_shortcode('dotiavatar', 'dotiavatar_function');

ha rövidkódot regisztrál a add_shortcode funkció használatával, akkor a rövidkódcímkében () és a megfelelő funkcióban ()/horog, amely hajtsa végre, amikor a parancsikont használja.

ebben az esetben a parancsikon címke dotiavatar, a horog pedig dotiavatar_function.

Megjegyzés: címkék elnevezésekor csak kisbetűket használjon, kötőjeleket ne használjon; aláhúzások elfogadhatók.

A Rövid kód használata

most, hogy létrehoztad és regisztráltad a rövidkódot, itt az ideje kipróbálni! Ha azt akarod, hogy a DOTI avatár jelenik meg benne a tartalom, akkor használja a hiány helyett:

Shortcodes Paraméterekkel (Attribútumok)

az előző példában, nem volt sok hely, hogy változtassunk a dolgokon. Tegyük fel, hogy egyetlen kép megnyomása helyett szeretnénk beállítani, hogy melyik képet használjuk egy paraméter használatával. Ezt néhány attribútum hozzáadásával teheti meg ($atts).

ismét, belül custom-shortcodes.php, adjon hozzá egy másik funkciót, mint így:

function dotirating_function( $atts = array() ) { // set up default parameters extract(shortcode_atts(array( 'rating' => '5' ), $atts)); return "<img src=\"http://dayoftheindie.com/wp-content/uploads/$rating-star.png\" alt=\"doti-rating\" width=\"130\" height=\"188\" class=\"left-align\" />";}

a fenti funkció egyetlen paramétert fogad el: rating. Ha a ratingérték nem kerül átadásra, akkor a 5 alapértelmezett karakterlánc értékét használja. Ezt úgy teszi, hogy a beépített shortcode_atts függvény segítségével kicsomagolja az attribútumok tömbjét, majd az alapértelmezett értékeket kombinálja a függvénybe átvitt értékekkel.

Ne felejtsen el regisztrálni a shortcode:

add_shortcode('dotirating', 'dotirating_function');

a shortcode funkciót hozott létre, majd a horog ki, a hiány, most már készen áll, hogy belül használható a post tartalma:

a másik lehetőség, hogy kihagyja a rating, csak az alapértelmezett érték:

ennyi! Most már tudja, hogyan hozhat létre önzáró WordPress rövid kódokat. De van egy másik fajta, amit létrehozhat.

rövid kódokat csatolva

eddig önzáró rövid kódokkal dolgoztunk. De van egy másik típusú rövid kód: a rövid kódok bezárása.

a rövid kódok beillesztése lehetővé teszi a BBCode stílusú formátum használatát. Vagyis egy olyan stílus, amely így néz ki:

content

a rövid kódok beillesztése akkor hasznos, ha a mellékelt tartalmat manipulálni kell. Tegyük fel például, hogy van egy adott gombstílusa, amelyet a webhelyén használ; a HTML-kód segítségével generálhatja ezt a gombot / stílust minden alkalommal, amikor használni kell, vagy beállíthat egy egyéni csatoló rövidkódot.

egy zárt rövid kód használatával a tartalomra összpontosíthat, nem pedig a kódra.

A

rövid kód létrehozása ismét a custom-shortcodes.php fájl belsejében adja hozzá a következő kódblokkot:

function dotifollow_function( $atts, $content = null ) { return '<a href="https://twitter.com/DayOfTheIndie" target="blank" class="doti-follow">' . $content . '</a>';}

a fenti kódblokkban a $content = null azonosítja ezt a funkciót mellékelő rövid kódként. Ezen a függvényen belül pedig a HTML-kódba csomagolja a tartalmát ($content).

OK, itt az ideje regisztrálni a rövidkódot:

add_shortcode('dotifollow', 'dotifollow_function');

és ennyi! A rövid kód készen áll a használatra.

A Rövid kód használata

egy zárt rövid kód használata nem sokban különbözik az önzáró kód használatától. Mint a HTML, csak meg kell győződnie arról, hogy van egy nyitó és záró nyilatkozat:

Follow us on Twitter!

természetesen ez csak egy alapvető példa. Azt is hozzá paramétereket egy körülzáró shortcode, mint te egy önzáró shortcode.

Belső custom-shortcodes.php, adjunk hozzá még egy funkció:

function dotibutton_function( $atts = array(), $content = null ) { // set up default parameters extract(shortcode_atts(array( 'link' => '#' ), $atts)); return '<a href="'. $link .'" target="blank" class="doti-button">' . $content . '</a>';}

majd regisztrálni a shortcode:

add_shortcode('dotibutton', 'dotibutton_function');

Ez az új funkció hadd beállított egy linket a gombot, használja a következő szintaxist:

Shop Now!

A befoglaló shortcodes, sokat, nagyon kevés kódot.

Egy Szót Kütyü

alapértelmezés szerint shortcodes vagy csak a támogatott álláshely, oldalak, vagy egyéni utáni típusok; ők nem támogatott az oldalsáv kütyü. A widgetek támogatásának hozzáadásához a következő kódot kell hozzáadnia a functions.php fájlhoz:

add_filter( 'widget_text', 'shortcode_unautop' );add_filter( 'widget_text', 'do_shortcode' );

Ha ezt megteszi, használhat rövid kódokat a widgetekben – ugyanúgy, mint a hozzászólásokban/oldalakban.

A dolgok csomagolása

a saját rövid kódok hozzáadása nem sok erőfeszítést igényel-különösen, ha megérti, hogyan hajtják végre őket. Ha többet szeretne megtudni, nézze meg a WordPress codexet.