WordPress lyhytnumeroita käytetään 1) vähentää koodin sinun täytyy kirjoittaa; 2) yksinkertaistaa käyttöä WordPress plugins, teemoja ja muita toimintoja. Ne käyttäytyvät kuin makrot, kun lisäät lyhytnumeroon, se korvataan pätkä koodia. Se voi olla mitä vain.

WordPress sisältää joitakin ennalta määriteltyjä lyhytnumeroita, kuten ja , ja niihin sisältyy myös monia suosittuja lisäosia ja teemoja. Voit myös luoda omia mukautettuja lyhytnumeroita tehdä asioita, kuten luoda sarakkeita WordPress verkkosivuilla.

tässä viestissä, otamme sinut askel-askeleelta läpi prosessin luoda ja käyttää omia mukautettuja lyhytnumeroita. Me opastamme sinut läpi koko prosessin luoda uuden lyhytnumeroon ja näyttää, miten muuttaa ja hallita lyhytnumeroon attribuutteja ja toimintoja.

huomaa, että tämä on kehittyneempi viesti, joka menee yksityiskohtiin siitä, miten luoda lyhytnumeroita. Jos työskentely koodi on pidemmälle teknistä asiantuntemusta, ja haluat vain helpoin tapa päästä alkuun luoda ja käyttämällä lyhytnumeroita haluat ehkä aloittaa lyhytnumeroon plugin.

kun luot omia lyhytnumeroita, sinun täytyy tehdä kaksi asiaa:

1. luo lyhytnumeron käsittelijätoiminto. Lyhytnumerofunktio on toiminto, joka vie valinnaiset parametrit (attribuutit) ja palauttaa tuloksen.
2. rekisteröi lyhytnumeron käsittelijäfunktio. Käytä sisäänrakennettua WordPress add_shortcut funktio rekisteröidä mukautettuja lyhytnumeroita.

valmistelee WordPress mukautetun lyhytnumeroita

vaikka se ei ole tarpeen, se on hyvä idea pitää mukautettuja lyhytnumeroita omassa tiedostossaan. Vaihtoehtoisesti niitä voi lisätä teeman functions.php tiedostoon.

luo ensin uusi tiedosto, jonka nimi on custom-shortcodes.php, ja tallenna se saman kansion sisään kuin teemasi functions.php tiedosto.

lisää sitten uuden tiedoston sisään seuraava koodilohko:

<?php ?>

seuraavaksi avaa functions.php tiedosto ja lisää seuraava koodirivi:

include('custom-shortcodes.php');

olet nyt valmis aloittamaan omien lyhytnumeroidesi lisäämisen.

perus lyhytnumeroita

tässä ensimmäisessä esimerkissä, aiomme luoda perus WordPress lyhytnumeroon, joka lisää päivän Indie avatar kuvan alla.

Lyhytnumeron luominen

ensimmäinen vaihe on lyhytnumerofunktion luominen. custom-shortcodes.php – tiedoston sisälle lisätään seuraava koodilohko:

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" />';}

yllä olevassa koodiesimerkissä dotiavatar_function funktio palauttaa ennalta määritetyn kuvan nimeltä avatar-simple.png.

seuraava askel on rekisteröidä lyhytnumeron WordPress käyttäen sisäänrakennettua toimintoa add_shortcode. Vielä sisällä custom-shortcodes.php, lisätään seuraava koodirivi:

add_shortcode('dotiavatar', 'dotiavatar_function');

Kun rekisteröit lyhytnumeron käyttämällä add_shortcode funktio, ohitat lyhytnumerotunnisteen ($tag) ja vastaavan funktion ($func) / koukun, joka suorittaa aina kun oikotietä käytetään.

tällöin pikanäppäin on dotiavatar ja koukku on dotiavatar_function.

huomautus: kun nimeät tageja, käytä vain pieniä kirjaimia, äläkä käytä väliviivaa; alaviivat ovat hyväksyttäviä.

käyttämällä lyhytnumeroa

nyt kun olet luonut ja rekisteröinyt lyhytnumeron, on aika kokeilla sitä! Aina kun haluat Dotin avatarin ilmestyvän postisisällön sisälle, voit käyttää sen sijaan lyhytnumeroa:

lyhytnumerot parametreineen (attribuutit)

edellisessä esimerkissä ei ollut paljon tilaa muuttaa asioita. Sanotaan, että sen sijaan, että työntäisimme yhtä kuvaa, haluaisimme pystyä asettamaan, mitä kuvaa käytetään parametrin avulla. Voit tehdä sen lisäämällä joitakin attribuutteja ().

jälleen kerran, sisällä custom-shortcodes.php, lisää toinen funktio näin:

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\" />";}

yllä oleva funktio hyväksyy yhden parametrin: rating. Jos rating arvoa ei läpäise, se käyttää oletusjonon arvoa 5. Se tekee tämän purkamalla attribuuttien joukon käyttäen sisäänrakennettua shortcode_atts funktiota, ja yhdistämällä oletusarvot arvoihin, jotka on saatettu siirtää funktiolle.

älä unohda rekisteröidä lyhytnumeroa:

add_shortcode('dotirating', 'dotirating_function');

lyhytnumerotoiminnolla luotu ja koukku lisätty, lyhytnumero on nyt valmis käytettäväksi viestisi sisällön sisällä:

Vaihtoehtoisesti voit jättää rating, ja mene vain oletusarvolla:

ja se siitä! Nyt osaat luoda itsesulkeutuva WordPress lyhytnumeroita. Mutta on olemassa toinenkin laji, jonka voit luoda.

sulkemalla lyhytnumeroita

tähän asti olemme työskennelleet itsesulkeutuvien lyhytnumeroiden kanssa. Mutta on olemassa toisenlainen lyhytnumeroon: sulkee lyhytnumeroita.

sulkemalla lyhytnumerot voit käyttää BBCode-tyylistä muotoa. Toisin sanoen tyyli, joka näyttää tältä:

content

sulkemalla lyhytnumerot ovat hyödyllisiä silloin, kun täytyy manipuloida oheista sisältöä. Esimerkiksi, oletetaan, että sinulla on tietty tyyli painiketta käytät sivuston; voit käyttää HTML-koodia luoda, että painike / tyyli joka kerta, kun haluat käyttää sitä, tai voit perustaa mukautetun liittää lyhytnumeroon sijaan.

sulkemalla lyhytnumeron saa keskittymään sisällön sijaan koodiin.

Lyhytnumeron luominen

uudelleen, custom-shortcodes.php – tiedoston sisälle, lisätään seuraava koodilohko:

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

yllä olevaan koodilohkoon $content = null käytetään tämän funktion tunnistamiseen sulkevana lyhytnumerona. Ja, tämän funktion sisällä, käärit sisältösi ($content) HTML-koodin sisään.

OK, nyt on aika rekisteröidä lyhytnumero:

add_shortcode('dotifollow', 'dotifollow_function');

ja se siitä! Lyhytnumerosi on valmis käytettäväksi.

Lyhytnumeron käyttäminen

koteloivan lyhytnumeron käyttäminen ei ole paljon erilaista kuin itsesulkeutuvan lyhytnumeron käyttäminen. HTML: n tapaan pitää vain varmistaa, että on avaus-ja loppulauseke:

Follow us on Twitter!

tietenkin tämä on vain perusesimerkki. Voit myös lisätä parametreja koteloiva lyhytnumeroon, kuten teet itsesulkeutuva lyhytnumeroon.

Inside custom-shortcodes.php, add one more function:

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>';}

ja rekisteröi sitten lyhytnumero:

add_shortcode('dotibutton', 'dotibutton_function');

Tämä uusi funktio asetat linkin napille käyttäen seuraavaa syntaksia:

Shop Now!

sulkemalla lyhytnumeroita voi tehdä paljon hyvin pienellä koodilla.

sana widgeteistä

oletuksena lyhytnumeroita tuetaan vain viesteissä, sivuilla tai mukautetuissa postityypeissä; niitä ei tueta sivupalkin widgeteissä. Jos haluat lisätä tuen widgeteille, sinun täytyy lisätä seuraava koodi functions.php tiedosto:

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

kun teet sen, voit käyttää lyhytnumeroita widgeteissä – aivan kuten teet viesteissä/sivuilla.

asioiden paketointi

omien lyhytnumeroiden lisääminen ei vaadi paljon vaivaa – varsinkaan, kun ymmärtää, miten ne toteutetaan. Jos haluat lisätietoja, tutustu WordPress codex.