Nakarating na ba kayo ng isang oras kung saan mo gustong magdagdag ng ilang espesyal na nilalaman sa iyong post ng WordPress o pahina, ngunit hindi sigurado kung paano? Siguro gusto mong i-embed ang Twitter widget o ilang nilalaman na tinatawag na pabalik mula sa ilang website o API. Paano mo madaling idagdag ang ganitong uri ng nilalaman sa iyong post sa WordPress? Sa kabutihang palad, nagbibigay ang WordPress ng isang bagay na tinatawag na isang shortcode upang gawing ganitong uri ng gawain ang napakadali. Dadalhin ka ng tutorial na ito sa pamamagitan ng proseso ng pagbuo, pag-install, at paggamit ng shortcode sa iyong pag-install ng WordPress. Magsimula tayo sa pamamagitan ng pagtingin sa kung ano ang isang shortcode.
Ano ang isang WordPress Shortcode?
Sa madaling sabi, isang shortcode ay isang espesyal na tag na maaari mong ipasok sa isang post na makakakuha ng pinalitan ng iba’t ibang nilalaman kapag aktwal na tinitingnan ang post sa website. Kung sakaling naka-embed ka ng isang WordPress gallery sa iyong blog, pagkatapos ay nakita mo na ang built sa maikling code.
Kapag nag-load ka ng pahina ng blog gamit ang
shortcode, pinapalitan ng WordPress ang
shortcode sa lahat ng code na aktwal na nagpapakita ng isang gallery ng iyong mga larawan.
Tulad ng makikita mo mula sa halimbawa sa itaas, ang isang shortcode ay mukhang katulad sa isang HTML tag, ngunit nakapaloob sa parisukat na mga braket sa halip ng mga bracket ng anggulo. Ang code na ito ay mapapalitan ng ilang ibang code kapag ang pahina ay aktwal na na-load sa isang web browser. Ang talagang cool na bagay ay ang WordPress na nagbibigay-daan sa iyo upang lumikha ng iyong sariling pasadyang mga shortcode upang ipakita ang medyo magkano ang anumang bagay! Maaari mo itong gamitin upang mag-output ng isang Youtube video, ipakita ang iyong pinakabagong mga tweet, o kahit ipasadya ito gayunpaman gusto mo.
Sa kaso na hindi makatwiran, tingnan natin ang isang halimbawa. Sabihin nating gusto kong magpalabas ng isang ad na AdSense sa loob ng aking post. Maaari akong pumunta sa HTML mode ng editor ng nilalaman ng WordPress at kopyahin at i-paste ang block ng code ng Adsense dito, ngunit ito ay magiging nakakapagod at potensyal na nakakagambala sa lahat ng dagdag na markup sa aking post. Bilang karagdagan, kung gusto kong baguhin ang block ng ad, kailangan kong bumalik sa bawat post upang baguhin ito sa bago. Ang isang mas madaling paraan at mas maaasahan na paraan upang maidagdag ang block ng Adsense saan ko man gustong gamitin ang isang shortcode ng adsense. Maaaring magmukhang ganito ang shortcode:
[adsense]
Kapag aktwal na tumitingin sa post sa iyong website, ang shortcode ay papalitan ng Adsense block ad. Kaya paano mo nilikha ang shortcode na ito? Malinaw, kailangan mong sabihin sa WordPress kung ano ang palitan ang shortcode sa anumang paraan. Tingnan natin ang susunod na iyon.
Paano ako lilikha ng isang shortcode?
Sa kabutihang palad, ginagawang simple ng WordPress na gawing simple ang iyong sariling mga shortcode, kaya’t ipagpatuloy talaga ang pagpapatupad ng shortcode [adsense]. Ang unang bagay na kailangan naming gawin ay tukuyin ang isang function na output ang aktwal na Adsense code. Ang lahat ng mga sumusunod na code ay pupunta sa functions.php sa iyong tema (maaari din itong pumunta sa isang standalone na file ng plugin). Nakuha ko? Ok, kaya tingnan natin ang function na iyon.
function get_adsense ($ atts) {
bumalik '
';
}
Ang pag-andar na ito ay medyo diretso – nagbabalik lamang ito sa aking Google Adsense code bilang isang string. Anuman ang pag-andar ng function na ito ay kung ano ang aking shortcode ay papalitan, kaya maaari kong maibalik ang html para sa isang Twitter widget, o isang listahan ng mga post sa bata ng isang ito, o anumang bagay.
Ngayon na mayroon kaming isang function na nagbabalik kung ano ang gusto namin, paano namin isabit na hanggang sa isang shortcode? Ngayon ito ay kung saan ang WordPress API ay dumating sa. Muli tingnan natin kung paano namin ito at pagkatapos ay ipaliwanag kung ano ang nangyayari. Narito ang tawag upang i-set up ang adsense shortcode.
add_shortcode ('adsense', 'get_adsense');
Ayan yun! Ang unang parameter na ipinasa sa ay ang pangalan ng shortcode, kaya sa aming kaso, ang ‘adsense’ ay nagsasabi sa WordPress na lumikha ng [adsense] shortcode. Ang ikalawang parameter ay tumutukoy sa pag-andar na tatawagan kapag ang bagong shortcode ay nakatagpo. Muli, sa aming kaso, ‘get_adsense’ ay nagsasabi sa WordPress na palitan ang [adsense] sa mga resulta ng aming get_adsense na paraan.
Hindi ba masama ito? Ngayon ito ay isang napaka-simpleng shortcode, pinapayagan ka ng WordPress na gawin ang higit pa sa iyong mga shortcode, kabilang ang pagdaragdag ng mga parameter (marahil gusto mong pumili sa pagitan ng mga bloke ng adsense?). Ang buong API ay makikita sa WordPress Codex.
Paano ko Gagamitin ang aking Shortcode?
Ang huling bahagi na ito ay simple, idagdag lamang ang [adsense] shortcode sa HTML o Visual na mga view ng post o editor ng nilalaman ng Pahina. Ayan yun! Nilikha mo ang iyong unang shortcode.