Iesācēja ceļvedis WordPress spraudņa izstrādei

WordPress CMS ir mainījusi mūsu interneta seju un ļāva uzplaukt jaunām idejām, un tās atvērtā koda kustība ieņem spēcīgu klātbūtni, kas sakņojas programmatūras un tīmekļa izstrādē. WordPress ir emuāru platforma, kas spēj sākt daudzus citus skriptus, piemēram, tīmekļa forumus, darba diskusijas un pat klasisku tīmekļa lapas satura pārvaldības sistēmu..

Mēs pārvarēsim dažus veidus, kā sākt darbu ar WordPress spraudņiem. Pasākumi ir diezgan vienkārši un neprasa lielu centību mācīties. Svarīgākās zināšanas par PHP būtu noderīgas pat ar pamata izpratni par WordPress faila struktūru un administrācijas paneli.

Šajā īsajā apmācībā mēs pārvarēsim galvenos soļus, kas nepieciešami, lai izveidotu vienkāršu WordPress spraudni. Funkcija tiks izmantota, lai izveidotu dinamiskus fragmentus, pamatojoties uz numuru, kas nodots mūsu funkciju zvanam. Jums būs nepieciešams augšupielādēt spraudņa failu un aktivizēt no administratora paneļa, pēc tam sekot līdzi, zvanot mūsu funkcijai no jebkurām lapām, kuras mēs vēlamies, lai parādītu fragmentu. Saites uz pabeigtu spraudņa pirmkodu jau ir pievienotas vēlāk šajā rakstā :)

Kāpēc izstrādāt WordPress?

Spraudņi ir lielisks veids, kā uzlabot jūsu emuāra funkcionalitāti, pievienojot papildu funkcijas. Tos var izvietot jebkurā jūsu veidnes iekšpusē ar funkciju āķiem. Laika gaitā WordPress plug-in sistēmas paplašināšanās ir nodrošinājusi milzīgu izaugsmi un simtiem izstrādātāju iesniegto programmatūru..

WordPress īpaši piedāvā šādas uzlabotas funkcijas savā CMS, ka unikālie spraudņi ir maz un tālu starp tiem. Kā attīstītājs jums ir pilnīga kontrole pār jūsu tīmekļa dienasgrāmatas specifiku. PHP izstrādātāja izīrēšana, lai izveidotu sistēmas spraudni, izmaksātu daudz vairāk, nekā jūs varētu iedomāties, un API ir diezgan viegli, lai strādātu ar sevi un mācītos sevi.

Kā sekundārs arguments, attīstoties pāri WordPress, ir lieliska prakse, lai pielāgotu sevi citām jomām. Mazāku spraudņu un sānjoslas logrīku veidošana programmā WordPress palīdzēs jums izprast, kā backend sistēma tiešām darbojas. Tas neaprobežojas tikai ar WordPress, jo jūs iegūsiet dziļāku izpratni par lielāko daļu satura sistēmu.

1. WP mapju struktūra

Ievads mapes WordPress struktūrā parādīs pamata lietotņu katalogus. Wp saturā jūs atradīsiet a spraudņi direktoriju. Šeit ir vieta, kur tiks izvietoti visi jūsu individuālie spraudņi, vai nu atsevišķi faili, vai pareizi nosaukti apakšgrupas katalogi.

Mazākiem spraudņiem, kuriem nepieciešams tikai viens .php fails, ir iespēja to ievietot tieši spraudnēs / direktorijā. Tomēr, kad sākat izstrādāt sarežģītākas lietojumprogrammas, ir daudz noderīgāk izveidot apakšprogrammu, kas nosaukta pēc jūsu spraudņa. Iekšpusē varat izvietot JavaScript, CSS un HTML kopā ar PHP funkcijām.

A readme.txt fails var būt noderīgs arī tad, ja plānojat piedāvāt savu spraudni lejupielādei. Šajā failā jāiekļauj jūsu vārds un spraudnis. Kā autors jūs varat arī apsvērt iespēju iekļaut sīkāku informāciju par katru pārskatīšanu un to, kuri atjauninājumi ir iznākuši.

2. PHP faila sākšana

Veidojot jaunu spraudni, jums jāsāk ar vienkāršu PHP failu. To var nosaukt par kaut ko, bet tai parasti jāatbilst jūsu spraudņa oficiālajam nosaukumam. Tā, piemēram, esmu izveidojis mūsu bāzes kodu un esmu nosaukis savu failu hongkiat-excerpt.phps.

Spraudņa pirmās rindas jābūt būt komentāru informācijai parsēšanas motoram. Tas ir ārkārtīgi svarīgi, jo WordPress nevarēs apstrādāt jūsu failu bez. Zemāk ir koda fragmenta piemērs, kuru varat kopēt un veidot uz savu.

Spraudņa nosaukums ir tas, kas parādīsies jūsu Admin backend panelī, kad dodaties aktivizēt. Tas pats ar URI, kas tiks ievietots detalizētajā rūtī spraudņu panelī. Lai gan nav nepieciešams iekļaut versiju vai aprakstu, tas padara jūsu spraudni daudz profesionālāku.

3. WordPress nosaukumu konvencijas un paraugprakse

Ir daži veidi, kā izveidot savu spraudni. Daudzas reizes PHP izstrādātāji izveidos visu klases sistēmu, lai izvairītos no sadursmēm ar funkcijām un mainīgajiem nosaukumiem. Ja neesat iepazinies ar uzlaboto PHP OOP funkcionalitāti, tad vislabāk ir vienkārši ierakstīt kodu parauga funkcijās.

Tātad mūsu piemēru kodam mēs uzrakstīsim vienu funkciju, lai izvietotu mūsu datus. Mums ir arī jānosaka daži mainīgie, kas ir būtiski, lai īstenotu mūsu veidnes failus. Tālāk ir parādīts koda paraugs, kas ņemts no mūsu spraudņa faila ar galveno loģiku.

Rakstot savu parauga kodu, vislabāk ir ievērot WordPress izveidotos noteikumus un norādījumus. Tā kā jau ir tik daudz iekšējo funkciju, kas jau ir definētas, jūs varat izvairīties no dublikātiem, pirms etiķetes pievienojot visus mainīgos un funkciju nosaukumus.

Iepriekšminētajos piemēros mēs ar visiem iestatījumu nosaukumiem esam pievienojuši hongkiat. To var aizstāt ar jebkuru izvēlēto atslēgvārdu, kas parasti ir saistīts ar jūsu spraudņa nosaukumu. Iepriekš minētais kods ir taisnīgs izlases iestatījumi un nevajadzētu attiekties uz mūsu galīgo spraudni. Tas ir tikai, lai sniegtu jums ieskatu par to, kā jāraksta jūsu mainīgie vārdi un funkciju zvani.

4. Niršana filtros un darbībās

Ir vēl viena jēdziena pieminēšanas jēdziena pieminēšana, pirms mēs nonākam mūsu izejvielu kodā. Darbības un filtri ir divi pilnīgi atšķirīgi jēdzieni, kas ir dziļi saistīti ar to, kā tie manipulē ar spraudņa datiem.

Šie divi bitu kodi nāk standartā WordPress API. Filtri un darbības ļauj plug-in izstrādātājiem atjaunināt koda bitus visā WordPress administratora panelī, kas attiecas uz jūsu jauno spraudni. Tas nozīmē, ka jūs varētu pievienot jaunu cilni sānjoslā vai papildu iestatījumu saites savām spraudņu opcijām.

Izpratne add_filter ()

A filtru tiek izmantots mazliet teksta vai datu, kas tiek nodoti WordPress. Ar filtriem jūs varat burtiski filtra saturu izmantojot savu pielāgoto rakstisko funkciju, lai mainītu datus jebkādā veidā.

Piemēram, varat izveidot filtru, lai to mainītu $ the_content kas ir WordPress iestatīts mainīgais, kas satur visu WordPress raksta saturu. Mūsu plug-in mēs ņemsim $ the_content un rakstzīmju garuma saīsināšanu.

Filtri ir noderīgi, kad rakstāt spraudņus, lai pielāgotu jūsu emuāra izskatu un izskatu. Tie ir īpaši populāri, rakstot sānjoslas logrīkus vai mazākas funkcijas, lai mainītu, kā jāparāda ziņa. Zemāk ir koda parauga līnija, kas parāda, kā piemērot filtru.

add_filter ('wp_title', 'hongkiat_func');

Šeit mēs pievienojam filtru WordPress lapas nosaukumā. Ņemiet vērā, ka šis kods neattiecas uz mūsu oficiālo spraudni un tiek izmantots tikai kā piemērs.

The pievienojiet filtru funkcija ir dzimtā WordPress, un to izmanto, lai pievienotu jaunu filtru mainīgajam, kas atrodams lapas saturā. Augšējā rindā mēs esam orientēti $ wp_title kas satur mūsu pašreizējās lapas nosaukumu. Tad mēs šo mainīgo nododam viltotas funkcijas nosaukumam hongkiat_func () kas varētu manipulēt ar jaunu nosaukumu tagu jebkādiem mērķiem.

Izpratne pievienot papildinājumu ()

Darbības ir līdzīgas filtriem, jo ​​tās nedarbojas ar datu bitiem, bet gan mērķa apgabalos un admin paneļa mērķa apgabalos. Piemēram, jūs varat piemērot darbību, kad atjaunināt vai rediģēt lapas saturu. WordPress piedāvā visaptverošu darbību sarakstu savos API dokumentos. Zemāk ir neliels piemēru darbību saraksts, lai jūs varētu iepazīties ar dažām iepriekš definētām mērķa jomām.

• publicēt_post - tiek izsaukts, kad tiek publicēts ieraksts vai kad statuss tiek mainīts “publicēts”
• saglabāt_post - izsaukts, kad ziņa / lapa tiek izveidota no sākuma vai atjaunināta
• wp_head - izsauc, kad veidne ir ielādēta un darbojas wp_head () funkciju
• loop_end - uzreiz pēc tam, kad pēdējais ziņojums ir apstrādāts, izmantojot WordPress cilpu
• trackback_post - zvanīja ikreiz, kad postā tiek pievienota jauna izsekošana

Atkal mēs varam redzēt, cik vienkāršs šis koda bits ir uz leju. Ja jūs varat saprast atšķirību starp darbībām un filtriem, jums būs tik daudz tuvāk, lai veidotu visaptverošus, darbojošos WordPress spraudņus. Zemāk ir cita koda rinda, kas inicializē darbības funkciju saglabāt_post āķis. Lai to vēlreiz noskaidrotu, tas neattiecas uz mūsu pašreizējo jaunattīstības spraudni, un to izmanto tikai kā piemēru kodu, lai saprastu pievienotelut () funkciju.

add_action (“save_post”, “paziņot”);

Tātad šeit mēs redzam līdzīgu iestatījumu ar iepriekš add_filter (). Mums ir vajadzīgi 2 mainīgie, pirmais ir mūsu mērķa nosaukums. Šajā gadījumā saglabāt_post kas nozīmē, ka, saglabājot jaunu amatu, mēs izsauksim savu funkciju, kas definēta otrajā pozīcijā (paziņot()). Jūs, protams, varētu atjaunināt paziņojumu, lai tā būtu jebkura funkcija, kuru vēlaties rādīt, taču tas nav nepieciešams mūsu pašreizējam piemēriem.

Mūsu Plugin Logic pabeigšana

Pabeidzot mūsu ceļu, mēs pievienosim mūsu galīgo funkciju tieši mūsu spraudņa failam. API dokumentācija ir ļoti specifiska un nodrošina lielisku resursu izstrādātājiem, kuriem var būt papildu jautājumi. Materiāls var izrādīties sarežģīts, ja neesat iepazinies ar PHP, bet ņemiet laiku ar jēdzieniem un lietas sāk kustēties dabiski!

Tālāk norādītā funkcija ir jāpievieno tieši pēc spraudņa galvenes komentāra. Alternatīvi to var ievietot arī jūsu tēmas iekšpusē funkcijas.php failu. Kodu izmanto, lai izveidotu dinamisku ziņu saturu, pamatojoties uz ierobežotu rakstzīmju klāstu.

Tātad mūsu piemērā mēs varam ierobežot stāstu izvilkumus tikai ar 55 rakstzīmēm hk_trim_content () funkciju. Jūs varētu viegli izsaukt šo koda bitu no sānjoslas logrīka vai ar kādu no tēmas failiem, kas jāaizstāj $ the_content.

= $ limit) array_pop ($ content); $ content = implode ("", $ content). '...';  else $ content = implode ("", $ saturs);  $ content = preg_replace ('/\t./\t/', ", $ content); $ content = apply_filters ('the_content', $ content); atgriešanās $ content;?> 

Nevajadzētu sagaidīt, ka jūs pilnībā sapratīsiet visus iekšējos mainīgos vai funkcijas, kas tiek izmantotas šeit. Ļoti labs sākums ir vispārēja izpratne par to, kā būtu jāraksta jūsu funkcijas un kāds varētu būt piemērs.

Jūs varat arī pamanīt, ka mēs izmantojam zvanu pielietojiet filtrus kas ir vēl viena WordPress specifiska funkcija. Šis ir vēl viens aspekts, kas jums nav nepieciešams, lai pilnībā izprastu, bet tas palīdz nākotnē plānot WP. Lai iegūtu plašāku informāciju un FAQ par šo tēmu, skatiet lapu application_filters.

Augstāk minētā galvenā funkcija ir nosaukta hk_trim_content (). Tas prasa tikai 1 parametru $ limit. To varētu arī saīsināt līdz $ lim kurā jāglabā vesels skaitlis, norādot, cik rakstzīmju ierobežo izrakstu. Saturs tiek izmantots pilnās pasta lapās un arī statiskajās lapās (par mums, sazinieties ar).

Tāpēc, lai izsauktu šo funkciju, mums ir jāpievieno šis parametrs mūsu veidņu failos. Tas būtu izvietots kaut kur, iespējams, jūsu index.php vai loop.php vispirms būs jāinstalē spraudnis. Tālāk redzamais piemērs:

Spraudņa instalēšana un palaišana

Ja vēlaties izlaist cieto kodējumu, es esmu izveidojis demo demonstrācijas failu spraudnim. Vienkārši lejupielādējiet šo failu (pārdēvējiet to uz .php) vai kopējiet / ielīmējiet kodu jaunā PHP dokumentā un augšupielādējiet to savā / wp-content / plugins direktoriju.

Kad esat pabeidzis, jūs vēlaties piekļūt WordPress administrācijas panelim un pārlūkot pašreizējo instalēto spraudņu kopu, kas paredzēta tikai instalētajai demonstrācijai. Kad jūs aktivizēsiet neko jaunu, tas notiek, kamēr mēs manuāli pievienosim savu funkciju zvanu. Lai to izdarītu, vienkārši pārvietojieties Izskats -> Redaktors un meklēt single.php.

Šajā failā ir visas HTML / CSS veidnes, kas paredzētas jūsu raksta galvenajai ziņai. Ritiniet uz leju, līdz atrodat saturs() un aizstāt ar iepriekš minēto piemēru kodu. Tas ierobežos visus jūsu rakstu lapas līdz 55 rakstzīmēm neatkarīgi no skatījuma. Varat arī pievienot šo funkciju līdzīgām lapām jūsu veidņu direktorijā, piemēram, search.php vai archive.php.

Secinājums

Šie ir daži no pamatiem, lai sāktu darbu WordPress izstrādē. Spraudņu sistēma ir plaša un satur lielu iekšējo funkcionalitāti. Ja jums jau ir ideja par spraudni, izmēģiniet to vietējā WordPress instalācijā, lai izmantotu šīs tēmas.

Ja jūs joprojām sajaukt daudz informācijas, varat pārskatīt WordPress dokumentāciju un meklēt atbildi. Attīstības kopiena ir pilna ar noderīgiem lietotājiem, un forumos tiek glabāti arhīvi ar jautājumiem no gadiem.