Í útgáfu 2.5 hefur WordPress kynnt skammstafana og allir okkar hafa sennilega notað þau á einum tíma eða öðrum. Þeir koma venjulega saman við viðbætur eða jafnvel þemu og það sem þeir gera er að horfa á þegar þú setur inn eitthvað í fermetra sviga, skiptu því með öðru innihaldi; það gæti verið einfalt mál eða það gæti verið gríðarlegt PHP virka, það veltur allt á því sem þú gafst upp á WordPress að gera.
Samsettar skammstafanir eru frábærar og flýta því betur en það væri ekki frábært að vita hvernig á að búa til skammstafanir þínar eigin?
Í þessari grein mun ég taka þig í gegnum að búa til nokkur einföld WordPress skammstafana til að hjálpa þér að búa til hvaða virkni þú vilt.
Shortcode API virkar mjög einfaldlega: Í fyrsta lagi þarftu að búa til aðgerð sem kallar á afturköllun sem mun keyra hvenær sem styttingin er notuð; þá þarftu að binda þessa aðgerð við tiltekinn skammstafan sem gerir það tilbúið til notkunar. Kóðinn er oft settur í function.php skrána, en ef þú ætlar að hafa mikið af smákóðum, þá er skynsamlegt að búa til sérstaka skrá og innihalda þá skrá í aðgerðaskránni.
Í fyrsta fordæmi okkar viljum við búa til stutta letur sem mun skapa nokkur lorem ipsum í hvert skipti sem við skrifar [lorem] inn í ritstjóra. Fyrst þurfum við að búa til afturköllunaraðgerðina sem mun skila lorem ipsum (með stuttum skammta sem við mælum ekki með neitt, allt er skilað):
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.';}
Næstum við þurfum að bæta þessu strikamerki við WordPress með því að nota add_shortcode virka í annaðhvort virka.php skrá okkar eða skrá sem er innifalinn í henni. Þessi aðgerð bætir strikamerkinu og tengir það einnig við þá aðgerð sem við höfum búið til. add_shortcode tekur aðeins tvo röksemdir, fyrsti er nafnið sem við viljum að þetta strikamerki hafi (það sem við munum slá á milli torgsins) og annarinn er sá hlutur sem við viljum tengja við þessi stutta númer:
add_shortcode('lorem', 'lorem_function');
Það er allt sem þarf til að búa til einfaldan skammstafan í WordPress.
Halda áfram með þessa hugmyndafræðideild, þar sem við þurfum oft myndir í efni okkar þegar við undirbúum mockups okkar og þessar myndir þurfa að vera mismunandi stærðir, svo nú munum við búa til stutta letur til að setja inn mynd af þessu tagi:
[picture width="500" height="500"]
Þegar WordPress kynni þetta viljum við aðgerð sem mun setja inn mynd. Það þarf að lesa breidd og hæð eiginleika, en bara ef við munum einnig veita sjálfgefin gildi svo að hægt sé að nota það án eiginleika. Vegna þess að við megum ekki hafa mynd í boði, ætlum við að nota lorempixel.com þjónusta til að veita okkur handahófi mynd.
Fyrst þurfum við að búa til virkni:
function random_picture($atts) {extract(shortcode_atts(array('width' => 400,'height' => 200,), $atts));return '';}
Við nefnum þessa aðgerð random_picture og þar sem þetta shortcode mun geta tekið rök sem við gafum það $ atts breytu. Til að nota eiginleika eigum við tvær aðgerðir: shortcode_atts sem er WordPress aðgerð sem sameinar eiginleika okkar með þekktum eiginleikum og fyllir í vanskil þegar þörf krefur; og útdrætti PHP virka sem, eins og nafnið gefur til kynna, dregur út þá eiginleika sem við stilljum fyrir shortcode okkar. Að lokum skilar virknin það gildi sem við viljum, í þessu tilfelli HTML kóða fyrir myndina okkar ásamt breidd og hæð breytur.
Það eina sem eftir er að gera er að skrá þennan skammstafann:
add_shortcode('picture', 'random_picture');
Skammstafinn okkar er lokið, þegar við tökum [mynd] mun það gefa okkur handahófi mynd 400 með 200, og ef við notum eiginleikana getum við búið til mynd af hvaða stærð sem við þóknast.
Að búa til smá skammstafanir fyrir hluti sem við notum oft hjálpar okkur örugglega við að skrifa bloggfærslur vegna þess að þú getur gert allt sem þú þóknast með stutta letur, það getur verið eins einfalt og að skila setningu eða eins flókið og bæta við eyðublað eða nýjustu færslur raðað eftir mánuði.
Hefur þú búið til gagnlegar skammstafanir fyrir WordPress? Hvaða skammstafanir viltu vera til? Láttu okkur vita í athugasemdunum.