Vodnik za začetnike za WordPress Plugin razvoj

WordPress CMS je spremenil podobo našega interneta in omogočil razcvet novih idej in njegovo odprto gibanje je močno prisotno v programski opremi in razvoju spletnih strani. WordPress je platforma za bloganje, ki ima zmožnost zagona v številne druge skripte, kot so spletni forumi, oglasne deske in celo klasični spletni sistem za upravljanje vsebin..

Preučili bomo nekaj načinov za začetek razvoja vtičnikov za WordPress. Koraki so dokaj preprosti in ne zahtevajo velike predanosti za študij. Temeljno poznavanje PHP-ja bi bilo koristno tudi z osnovnim razumevanjem strukture datotek WordPress in upravne plošče.

V tem kratkem vodiču bomo pregledali osnovne korake, potrebne za ustvarjanje preprostega WordPress plug-ina. Funkcionalnost bo uporabljena za ustvarjanje dinamičnih odlomkov, ki temeljijo na številu, ki je prešla v naš klic funkcije. Datoteko vtičnika morate naložiti in aktivirati iz skrbniške plošče, nato pa sledite tako, da pokličete našo funkcijo s katerekoli strani, ki jo želimo prikazati. Povezave do izvirne kode za dokončane vtičnike so že dodane pozneje v tem članku :)

Zakaj razviti za WordPress?

Vtičniki so odličen način za izboljšanje funkcionalnosti spletnega dnevnika z dodajanjem dodatnih funkcij. Te je mogoče namestiti kjerkoli znotraj vaše predloge s kljukicami funkcij. Sčasoma je razširljivost WordPressovega plug-in sistema omogočila izjemno rast in na stotine programske opreme, ki so jo predložili razvijalci.

WordPress posebej ponuja takšne napredne funkcije v svojem CMS-u, da so edinstveni vtičniki le malo in daleč med njimi. Kot razvijalec imate popoln nadzor nad posebnostmi vašega spletnega dnevnika. Najem PHP razvijalca za ustvarjanje sistemskega vtičnika bi stalo veliko več, kot si lahko predstavljate, in API je dokaj preprost za delo in učenje.

Kot sekundarni argument je razvijanje v WordPressu odlična praksa za uglaševanje na druga področja. Zgradba manjših vtičnikov in pripomočkov v stranski vrstici v WordPressu vam bo pomagala razviti razumevanje o tem, kako sistem v ozadju deluje. To ni omejeno samo na WordPress, saj boste pridobili globlje razumevanje velike večine sistemov vsebin.

1. Struktura mape WP

Uvod v strukturo map WordPress bo prikazal osnovne imenike aplikacij. Znotraj wp-vsebine boste našli a plugins imenik. Tukaj boste našli vse vaše posamezne vtičnike, bodisi posamezne datoteke ali pravilno imenovane podmenike.

Za manjše vtičnike, ki zahtevajo samo eno datoteko .php, lahko to postavite neposredno v vtičnike / imenik. Toda ko začnete razvijati bolj zapletene aplikacije, je veliko bolj koristno, da ustvarite podimenik po imenu vašega vtičnika. V notranjosti lahko skupaj s svojimi funkcijami PHP vključite JavaScript, CSS in HTML.

A readme.txt Datoteka je lahko uporabna tudi, če nameravate ponuditi svoj plugin za prenos. Ta datoteka mora vključevati vaše ime in vsebino vtičnika. Kot avtor lahko razmislite tudi o vključitvi podrobnosti o vsaki reviziji in o tem, katere posodobitve so bile objavljene.

2. Zagon PHP datoteke

Pri ustvarjanju novega vtičnika boste morali začeti s preprosto datoteko PHP. To je mogoče poimenovati karkoli, vendar mora na splošno odražati uradno ime vašega vtičnika. Tako sem na primer ustvaril našo osnovno kodo in imenoval svojo datoteko hongkiat-excerpt.phps.

Prve vrstice vašega vtičnika mora je informacija za komentar za razčlenjevalni motor. To je zelo pomembno, ker WordPress ne bo mogel obdelati vaše datoteke brez. Spodaj je na primer odrezek kode, ki ga lahko kopirate in oblikujete v svoje.

Ime Plugin je tisto, kar se bo prikazalo v podoknu Admin backend, ko boste aktivirani. Enako je z URI-jem, ki bo postavljen v podokno s podrobnostmi znotraj plošče z vtičniki. Čeprav ni treba vključiti različice ali opisa, bo vaš vtičnik postal bolj profesionalen.

3. Dogovori o imenovanju WordPress in najboljše prakse

Obstaja nekaj načinov za dejansko strukturiranje vtičnika. Mnogo krat razvijalci PHP bodo ustvarili celoten sistem razredov, da bi se izognili trčenju funkcij in imen spremenljivk. Če ne poznate napredne funkcionalnosti OOP-ja v PHP-ju, je najbolje, da kodo napišete v vzorčnih funkcijah.

Torej bomo za našo primerno kodo napisali eno samo funkcijo za shranjevanje naših podatkov. Opredeliti moramo tudi nekaj spremenljivk, ki so ključne za izvedbo znotraj naših predlog. Spodaj je prikazan primer kode kode, ki je vzeta iz naše datoteke z vtičniki in je odstranjena osnovna logika.

Pri pisanju vzorčne kode je najbolje slediti predpisom in navodilom, ki jih je pripravila WordPress. Ker je že tako veliko notranjih funkcij, se lahko izognete podvajanjem, tako da oznako označite za vse vaše spremenljivke in imena funkcij.

V zgornjih primerih smo predpono označili z vsemi našimi nastavitvenimi imeni hongkiat. To je mogoče zamenjati s katero koli ključno besedo, ki jo izberete in je običajno povezana z imenom vtičnika. Zgornja koda je prav vzorčne nastavitve in se ne sme nanašati na naš končni vtičnik. To je samo zato, da bi vam dali nekaj vpogleda v to, kako naj bodo zapisana imena spremenljivk in funkcijski klici.

4. Potapljanje v filtre in dejanja

Obstaja še en koncept, ki ga je vredno omeniti, preden skočimo v našo surovo kodo. Ukrepi in filtri sta dva povsem različna koncepta, ki se močno nanašata na načine, kako manipulirajo s podatki vtičnikov.

Ta dva bita kode sta standardna v WordPress API-ju. Filtri in dejanja omogočajo razvijalcem vtičnikov, da posodobijo bitove kode v celotnem WordPress admin panelu, ki se nanaša na vaš novi vtičnik. To pomeni, da lahko dodate dodaten zavihek v stranski vrstici ali dodatne nastavitvene povezave za možnosti vtičnika.

Razumevanje add_filter ()

A filter se uporablja za del besedila ali podatkov, ki se prenašajo v WordPress. S filtri, ki jih dobesedno lahko vsebino filtra s pisnimi funkcijami po meri za spreminjanje podatkov na kakršen koli način.

Ustvarite lahko na primer filter, ki ga želite spremeniti $ the_content ki je spremenljivka, ki jo določi WordPress in vsebuje celotno vsebino članka v WordPressu. Za naš plug-in bomo sprejeli $ the_content in skrajšanje dolžine znakov v odlomek.

Filtri vam bodo v pomoč, ko boste pisali vtičnike za prilagoditev videza in občutka spletnega dnevnika. Te so še posebej priljubljene pri pisanju pripomočkov v stranski vrstici ali manjših funkcij, s katerimi spremenite način prikaza objave. Spodaj je vzorec vrstice kode, ki prikazuje, kako uporabiti filter.

add_filter ('wp_title', 'hongkiat_func');

V naslov WordPress dodamo filter. Upoštevajte, da se ta koda ne nanaša na naš uradni vtičnik in se tukaj uporablja samo kot primer.

The add_filter Funkcija je izvirna za WordPress in se uporablja za dodajanje novega filtra spremenljivki znotraj vsebine strani. V zgornji vrstici ciljamo $ wp_title ki vsebuje naslov naše trenutne strani. Nato spremenimo to spremenljivko v ponarejeno funkcijo z naslovom hongkiat_func () ki lahko nato manipulira in vrne novo oznako naslova za kakršne koli namene.

Razumevanje add_action ()

Dejanja so podobna filtrom, saj ne delujejo na bitih podatkov, temveč se osredotočajo na vnaprej določena območja v vaših predlogah in skrbniški plošči. Kot primer lahko uporabite dejanje vsakič, ko posodobite ali uredite vsebino strani. WordPress ponuja celovit seznam ukrepov v dokumentaciji API. Spodaj je naveden majhen seznam primernih akcij, s katerimi se boste seznanili z nekaterimi vnaprej določenimi ciljnimi področji.

• publishing_post - ko je objavljena objava ali ko je status spremenjen v “objavljeno”
• save_post - klicano, ko je objava / stran ustvarjena od začetka ali posodobljena
• wp_head - kliče, ko je predloga naložena in zažene wp_head () funkcijo
• loop_end - takoj po obdelavi zadnje objave prek zanke WordPress
• trackback_post - kličejo vedno, ko je nova objava dodana v objavo

Spet lahko vidimo, kako preprosta je ta bit kode. Če boste razumeli razliko med dejanji in filtri, boste toliko bližje oblikovanju celovitih, delujočih vtičnikov za WordPress. Spodaj je druga vrstica kode, ki inicializira akcijsko funkcijo na save_post kavelj. Da bi ponovno razjasnili, se to ne nanaša na naš trenutni razvojni vtičnik in se uporablja le kot del kode kode za razumevanje add_action () funkcijo.

add_action ('save_post', 'notify');

Tukaj vidimo podobno nastavitev kot prej add_filter (). Potrebujemo 2 spremenljivki, prva vsebuje ime našega kavlja, ki ga ciljamo. V tem primeru save_post kar pomeni, da bomo vsakič, ko bo shranjena nova objava, poklicali našo funkcijo, določeno v drugem položaju (obvestiti()). Očitno lahko posodobite obvestilo, da bo ime funkcije, ki jo želite zagnati, vendar to ni potrebno za naš trenutni primerek vtičnika.

Dokončanje naše Plugin Logic

Ko končamo na naši poti, bomo dodali našo končno funkcijo v našo datoteko vtičnika. Dokumentacija API je zelo specifična in ponuja odličen vir za razvijalce, ki imajo lahko napredna vprašanja. Gradivo se morda zdi težko, če niste seznanjeni s programom PHP, vendar si vzemite čas s koncepti in stvari se bodo začele teči naravno!

Funkcijo spodaj je treba dodati neposredno po komentarju glave vtičnika. Druga možnost je, da se to postavi tudi znotraj vaše teme functions.php mapa. Koda se uporablja za ustvarjanje dinamične vsebine objav, ki temelji na omejenem številu znakov.

Tako lahko za naš primer omejujemo odlomke iz zgodb samo s 55 znaki hk_trim_content () funkcijo. To bitno kodo lahko preprosto prikličete iz gradnika v stranski vrstici ali ene od datotek teme, ki jih želite zamenjati $ the_content.

= $ limit) array_pop ($ content); $ content = implode ("", $ content). "...";  else $ content = implode ("", $ content);  $ content = preg_replace ('/ \ _). \ t $ content = apply_filters (' the_content ', $ content), vrne $ content;?> \ t 

Ne bi smeli pričakovati, da boste v celoti razumeli vse notranje spremenljivke ali funkcije, ki jih uporabljate tukaj. Samo pridobivanje splošnega razumevanja, kako naj bodo vaše funkcije napisane in kakšen bi bil primer, je zelo dober začetek.

Prav tako lahko opazite, da uporabljamo klic apply_filters ki je še ena specifična za WordPress. To je še en vidik, ki ga ne potrebujete, da bi popolnoma razumeli, vendar pomaga pri prihodnjem programiranju preko WP. Oglejte si stran reference_filters za več podrobnosti in pogosta vprašanja o tej temi.

Zgornja funkcija je poimenovana hk_trim_content (). To zahteva samo en imenovan parameter $ limit. To bi se lahko tudi skrajšalo na $ lim ki bi morala shraniti celo število, ki določa, koliko znakov lahko omejite na odlomek. Vsebina se uporablja na polnih straneh objav in tudi na statičnih straneh (o nas, stiku).

Zato, da bi klicali to funkcijo, bi morali dodati parameter v naše datoteke s predlogami. To bi se uvrstilo nekje v vaši index.php ali loop.php Datoteka (e) bo zahtevala, da najprej namestite vtičnik. Primer spodaj:

Namestitev in zagon vtičnika

Ustvaril sem vzorčno datoteko za vtičnik, če želite preskočiti trdo kodiranje. To datoteko preprosto prenesite (preimenujte jo v .php) ali jo kopirajte / prilepite v nov dokument PHP in jo prenesite v svoj / wp-content / plugins imenik.

Ko končate, boste želeli dostopiti do upravne plošče WordPress in brskati po trenutnem nizu vtičnikov za demo, ki ste ga pravkar namestili. Ko boste aktivirali nič novega, se ne bo zgodilo, dokler ne bomo ročno dodali klic funkcije. Če želite to narediti, preprosto navigirajte Videz -> Urejevalnik in poiščite single.php.

Ta datoteka vsebuje vse predloge HTML / CSS za vašo osnovno stran objave članka. Pomaknite se navzdol, dokler ne najdete vsebina() in nadomestite z zgornjo kodo primera. To bo omejilo vse vaše članske strani na 55 znakov, ne glede na to, kateri pogled se uporablja. V to funkcijo lahko dodate tudi podobne strani v imeniku predlog, kot je search.php ali archive.php.

Zaključek

To so nekatere osnove za začetek dela v razvoju WordPressa. Sistem vtičnikov je ogromen in vsebuje veliko notranjih funkcij. Če že imate idejo za vtičnik, ga preizkusite na lokalni namestitvi WordPressa, da boste lahko vadili te teme.

Če vas še vedno zmede veliko informacij, si lahko ogledate dokumentacijo programa WordPress in tam poiščete svoj odgovor. Razvojna skupnost je polna koristnih uporabnikov, forumi pa imajo arhive z vprašanji iz preteklih let.