Kuigi ma arvan, et selle sarja pealkiri ja artiklid on mõlema jaoks piisavalt selged, on selle sarjaga teisi asju, mida ma selle sarjaga ette võtan, erinevalt teistest seni kirjutatud sarjadest.
Täpsemalt, kaks asja, mida ma üritan teha, on kaks:
- hoidke iga artikkel suhteliselt lühidalt (võrreldes sellega, kuidas varasemad artiklid on olnud),
- keskenduge ühele asjale korraga ja kirjeldage seda lühidalt.
Kuna see on liikmesisu, siis ma ei pahanda, et see oleks pisut pikem kui tavaliselt, kuid ma ei taha ka, et see oleks nii pikk, et seda oleks raske jälgida. Pigem oleks see lühike lugemine, milles on midagi praktilist, mida saate pärast iga postituse lugemist rakendada.
Ja üks asi, mis aitab parema WordPressi koodi kirjutamisel oluliselt kaasa, on helilooja.
Parem WordPressi kood koos heliloojaga
Kui olete seda ajaveebi kaua lugenud, siis teate, et ma olen Composeri fänn (samas pole ma kaugeltki ainus WordPressis töötav inimene).
Ja kuigi ma olen selle kohta materjali kirjutanud, pole ma kirjutanud midagi konkreetse eesmärgiga, et saaksite ühe lühikese artikli lugemise lõpuks sellega hakkama.
Selle hetkeni peame tegema mõningaid kompromisse: nimelt annan teile näidiskonfiguratsioonifaili koos viisiga, kuidas korraldada teie pistikprogrammi kataloog. Seejärel selgitan järgmises postituses mõnda helilooja funktsiooni.
Mis on helilooja?
Esiteks on oluline mõista, mis on helilooja. Ja saidil esitatud määratlust on lihtne ette lugeda, kas pole? See on PHP sõltuvushaldur.
Aga esiteks, mis on sõltuvus?
Mõne jaoks tekitab see siiski mõned küsimused:
- Mis on sõltuvus?
- Miks ma pean neid haldama?
Ja kui veidi süveneda, võite avastada, et see on paketihaldur ja see tõstatab lihtsalt samad küsimused, välja arvatud juhul, kui asendate sõna "sõltuvus" sõnaga "pakett" ja oletegi tagasi seal, kus alustasite.
Seega teen kõik endast oleneva, et see oleks võimalikult selge:
Sõltuvus või pakett, tarkvara, mida teie kood kasutab. See võib olla miski, mille funktsionaalsus töötab käitusajal, näiteks HTTP-päringute tegemise viis, või see võib olla teek massiivide teisendamiseks XML-i.
Composer muudab nende konkreetsete pakettide kaasamise teie teeki lihtsamaks, võimaldades teil:
- laadige alla ja lisage pakett oma pistikprogrammi,
- laadib teie pistikprogrammi käitamise ajal automaatselt,
- muutke pistikprogrammi jaoks vajaduse korral hõlpsaks pistikprogrammi loomine või sisse kutsumine.
See tähendab, et me ei pea oma koodibaasi katalooge risustama paljude käsitsi lisatud failidega ja see tähendab, et meil ei ole kõikjal kasutus- või nõuet .
Neil on oma koht, millest räägin järgmises postituses, kuid neid ei pea automaatselt installima. Selle asemel haldab neid helilooja. Seega on sõltuvushaldur osa selle eesmärgist.
Nüüd, kui olete selle installinud, on teil konteksti.
Helilooja kasutamine
Selle konkreetse jaotise kirjutamine on mõnevõrra keeruline, kuna meil kõigil on erinevad vajadused, eks? Kuid vähemalt saame kõik ära kasutada automaatlaadurit.
See on midagi, mida me kõik saame kasutada.
Nii et ma teen järgmist:
- Seadistan pistikprogrammide kataloogi,
- Looge pistikprogrammi juhtimiseks vajalikud failid,
- Seadistage lihtne helilooja fail,
- Teostage see
Ja siis ma lasen teil tulemusi näha. Tulevases postituses (või tulevastes seeriates) võime pääseda kolmandate osapoolte teekidesse või muudesse funktsioonidesse.
Aga kui mitte midagi muud, siis see näitab teile, kuidas kasutada Composerit automaatlaaduri määratlemiseks, et saaksite keskenduda koodi kirjutamisele, mitte aga sellele, kas klassid on kaasatud.
Pluginate kataloog
Üldiselt struktureerin oma pistikprogrammid järgmiselt:
- seal on alglaadimisfail, mille loeb WordPress,
- seal on src kataloog, kus hoitakse kõiki katalooge ja PHP-faile,
- seal on tipptasemel varade kataloog, kus hoitakse pilte, JavaScripti faile ja Sassi faile,
- ja seal on müüja kaust, mille on loonud Composer, mis sisaldab sõltuvusi ja automaatlaadurit.
Aeg-ajalt võib olla mõni muu veider kaust, näiteks kaust inc või lib, kuid see on praegu minu töötüübi puhul väga ebaregulaarne. Ja seetõttu ei hakka ma selle postituse pärast muretsema.
Selle asemel näeb minu kataloog välja umbes selline.
Tarnija kataloog puudub, kuna ma pole veel loonud helilooja faili, mida kasutatakse käivitamiseks. Aga seda näeme enne postituse lõppu.
Näidisfailid
Seadistame pistikprogrammis näidisfaili. Ja kui ma ütlen näidist, siis pean silmas ka lihtsat.
Sellel failil on üks eesmärk: printige WordPressi sisselogimisel armatuurlauale sõnum.
Pidage siiski meeles, et selle eesmärk ei ole näidata, kuidas kirjutada hästi üles ehitatud pistikprogrammi. Selle asemel näidatakse, kuidas luua automaatlaadurit, et pistikprogrammi failid genereeritakse automaatselt.
Seega näeb pistikprogrammi alglaadimine välja selline :
Ja konkreetselt sõnumi kuvamise eest vastutav fail näeb välja selline :
Ja kui teid huvitab HTML-fail, on see ka lihtne :
Ma ütlesin, et see on lihtne.
Helilooja konfiguratsioonifail
See konkreetne fail võib olla nii lihtne või keeruline, kui vaja. Selle postituse puhul jätame selle lihtsaks. Selle postituse eesmärk on lihtsalt anda sellele nimi, kirjeldus, litsents, autorid ja seejärel automaatlaaduri seadistamine.
Heitke pilk siia ja siis ma selgitan, mida näete selle all:
{
"name": "tommcfarlin/sample-plugin",
"description": "A sample plugin used for a blog post.",
"type": "wordpress-plugin",
"license": "GPL-3.0-or-later",
"authors": [
{
"name": "Tom McFarlin",
"email": "tom@tommcfarlin.com",
"homepage": "https://tommcfarlin.com"
}
],
"autoload": {
"psr-4": {
"SamplePlugin": "src/"
}
}
}Esiteks peaks nimi, kirjeldus, tüüp ja litsents olema piisavalt kergesti jälgitavad. Ka autoripiirkond on otsekohene.
Autoload on valdkond, mille pärast oleme praegu mures. See peaks olema üsna selge.
Lühidalt, meil on PSR4 jaoks direktiiv, mille kohta saate rohkem lugeda ja kus siis nimeruum asub. Nii et ülaltoodud näites asub kõik nimeruumis SamplePlugin kaustas src.
See annab automaatlaadurile teada, kust teatud faile otsida. Ja meie puhul otsib see lihtsalt Messengeri klassi.
Jooksev helilooja
Nüüd, kui oleme käsitlenud Composeri konfiguratsioonifaili põhitõdesid, on aeg see tegelikult käivitada. Pidage meeles, et teie pistikprogrammide kataloog peaks välja nägema umbes selline:
Sisestage terminalis järgmine käsk :
Ja sa peaksid nägema midagi sellist:
Eeldusel, et kõik on hästi läinud, peaksite saama WordPressi sisse logida ja pistikprogrammi aktiveerida.
Nähes seda kõike koos
Kui pistikprogramm on aktiveeritud, saate navigeerida oma saidi armatuurlauale. Seal peaksite nägema loobutavat teadet, mis näeb välja täpselt selline, nagu nägime postituse alguses:
Kui olete nii kaugele jõudnud, siis on kõik korras! Vastasel juhul kontrollige oma süntaksit, et veenduda, et kõik on korras. Kui midagi on valesti, poleks te tõenäoliselt nii kaugele jõudnud ja eeldades, et teil on põhilised silumiskonstandid määratud, näete tõenäoliselt, kus probleem on.
See pole veel kõik
Composeris on palju muudki ja soovitan tungivalt lugeda selle dokumentatsiooni. Mõnda neist käsitlen, kui vaatan tööriistu, mida kavatsen selles sarjas hiljem käsitleda, kuid praegu soovitan tutvuda mõne tavaga.
Oh! Ja ma ei soovita hankija kataloogi oma hoidlasse kontrollida. Sellest võib hiljem saada tohutu kataloog ja see võib kahjustada kogu Composeri eesmärki.
Järgmises postituses räägin, miks. Mõned inimesed teevad seda ja see on okei, ja ma olen seda varem teinud, kuid on oluline, et oleksite seda tehes mõistlik.
Viga, et ei tee seda. Ja miks ma selgitan järgmises postituses.