Pradedančiųjų vadovas WordPress papildinio kūrimui

„WordPress CMS“ pakeitė mūsų interneto veidą ir leido klestėti naujoms idėjoms ir jos atviro kodo judėjimas turi tvirtą dalyvavimą programinės įrangos ir interneto kūrimo srityje. „WordPress“ yra dienoraščių platforma, galinti pradėti daugelį kitų scenarijų, pvz., Interneto forumus, darbo lentas ir netgi klasikinį tinklalapio turinio valdymo sistemą..

Mes pereisime keliais būdais, kad galėtume pradėti diegti „WordPress“ papildinius. Veiksmai yra gana paprasti ir nereikalauja daug dėmesio mokytis. Svarbiausios PHP žinios būtų naudingos netgi suprantant WordPress failų struktūrą ir administravimo skydelį.

Šioje trumpoje pamokoje mes eisime per pagrindinius veiksmus, kurių reikia norint sukurti paprastą „WordPress“ papildinį. Funkcija bus naudojama kuriant dinaminius fragmentus, kurie priklauso nuo mūsų funkcijų skambučio. Turėsite įkelti įskiepio failą ir aktyvuoti iš administratoriaus skydelio, tada sekti paskambinę mūsų funkcijai iš bet kokių puslapių, kuriuos norime, kad ištrauka būtų rodoma. Nuorodos į baigtą „plug-in“ kodą jau įtrauktos vėliau šiame straipsnyje :)

Kodėl sukurti „WordPress“?

Įskiepiai yra puikus būdas pagerinti savo dienoraščio funkcionalumą, pridedant papildomų funkcijų. Jie gali būti patalpinti bet kurioje šablono vietoje, naudojant kabliukus. Laikui bėgant „WordPress“ įskiepių sistemos išplėtimas leido didžiulį augimą ir šimtus programinės įrangos kūrėjų pateiktų programinės įrangos dalių.

WordPress konkrečiai siūlo tokias pažangias funkcijas savo TVS, kad unikalūs papildiniai yra nedaug ir toli. Kaip kūrėjas, jūs visiškai valdote savo žiniatinklio dienoraščio specifiką. PHP kūrėjo samdymas, kad būtų sukurtas sistemos įskiepis, kainuotų daug daugiau, nei galite įsivaizduoti ir API yra gana paprasta, kad galėtumėte dirbti ir išmokti save.

Kaip antrinis argumentas, besivystantis per „WordPress“, yra puiki praktika, kad galėtumėte suderinti save su kitomis sritimis. Mažesnių įskiepių ir šoninės juostos valdiklių kūrimas „WordPress“ padės jums suprasti, kaip „backend“ sistema tikrai veikia. Tai neapsiriboja tik „WordPress“, nes gausite gilesnį supratimą apie daugumą turinio sistemų.

1. WP aplanko struktūra

Įvadas į „WordPress“ aplankų struktūrą parodys pagrindinius programų katalogus. „WP“ turinyje rasite: a įskiepiai katalogą. Čia yra vieta, kur bus laikomi visi jūsų individualūs papildiniai, arba vienas failas, arba tinkamai pavadinti sub-katalogai.

Mažesniems papildiniams, kuriems reikalingas tik vienas „.php“ failas, turite galimybę ją tiesiogiai įtraukti į papildinius / katalogą. Tačiau, kai pradėsite kurti sudėtingesnes programas, daug naudingiau yra sukurti pagalbinį katalogą, pavadintą „plug-in“. Viduje galite talpinti „JavaScript“, „CSS“ ir „HTML“ kartu su „PHP“ funkcijomis.

A readme.txt failas taip pat gali būti naudingas, jei planuojate pasiūlyti savo papildinį atsisiųsti. Į šį failą turėtų būti įtrauktas jūsų vardas ir papildinys. Kaip autorius taip pat galite apsvarstyti galimybę įtraukti išsamią informaciją apie kiekvieną peržiūrą ir apie tai, kokie atnaujinimai atsirado.

2. PHP failo paleidimas

Kuriant naują įskiepį jums reikės pradėti paprastą PHP failą. Tai galima pavadinti nieko, bet paprastai turėtų atspindėti oficialų „plug-in“ pavadinimą. Taigi, pavyzdžiui, sukūriau bazinį kodą ir pavadinome savo failą hongkiat-excerpt.phps.

Pirmieji papildiniai turi komentuoti informaciją apie analizuojamąjį variklį. Tai labai svarbu, nes „WordPress“ negalės apdoroti jūsų failo be. Žemiau pateikiamas pavyzdinis kodo fragmentas, kurį galite kopijuoti ir formuoti savo.

„Plugin“ pavadinimas yra tai, kas bus rodoma „Admin“ backend skydelyje, kai būsite aktyvuoti. Tą patį su URI, kuris bus patalpintas į papildomos informacijos skydelį įskiepių skydelyje. Nors neprivaloma įtraukti versijos ar aprašymo, jūsų įskiepis atrodo labiau profesionalus.

3. WordPress pavadinimų konvencijos ir geriausia praktika

Yra keletas būdų, kaip faktiškai sujungti savo papildinį. Daug kartų PHP kūrėjai sukurs visą klasės sistemą, kad išvengtų susidūrimų su funkcijomis ir kintamųjų pavadinimais. Jei nesate susipažinę su pažangia „OOP“ funkcionalumu PHP, tai geriausia tiesiog užsirašyti kodą mėginių funkcijose.

Taigi, mūsų pavyzdinio kodo atveju mes įrašysime vieną funkciją, kurioje bus patalpinti mūsų duomenys. Taip pat turime apibrėžti keletą kintamųjų, kurie yra svarbiausi įgyvendinant mūsų šablonų failus. Žemiau pateikiamas kodo pavyzdys, paimtas iš mūsų papildinio failo su pagrindine logika.

Rašydami pavyzdinį kodą geriausia laikytis „WordPress“ nustatytų taisyklių ir vadovų. Kadangi jau yra daugybė jau nustatytų vidinių funkcijų, galite išvengti pasikartojimų, prieš tai pridedant etiketę prie visų kintamųjų ir funkcijų pavadinimų.

Pirmiau pateiktuose pavyzdžiuose mes sujungėme visus mūsų nustatymų pavadinimus hongkiat. Tai gali būti pakeista bet kuriuo pasirinktu raktiniu žodžiu, paprastai susijusiu su jūsų papildinio pavadinimu. Šis kodas yra teisingas mėginio nustatymai ir neturėtų būti susiję su mūsų galutiniu papildiniu. Tai yra tik tam, kad suteiktų jums šiek tiek informacijos apie tai, kaip turėtų būti parašyti kintamųjų pavadinimai ir funkcijos.

4. Nardymas į filtrus ir veiksmus

Dar viena idėja paminėtina, prieš pradėdami pereiti į mūsų žaliavinį kodą. Veiksmai ir filtrai yra dvi visiškai skirtingos sąvokos, kurios glaudžiai susijusios su būdais, kaip jie manipuliuoja įskiepių duomenimis.

Šie du kodai yra standartiniai „WordPress API“. Filtrai ir veiksmai leidžia „plug-in“ programuotojams atnaujinti kodo bitus visame „WordPress“ administratoriaus skydelyje, susijusiame su jūsų nauju papildiniu. Tai reiškia, kad šoninėje juostoje galite pridėti naują skirtuką arba papildomų nustatymų nuorodas, skirtas „Plug-in“ parinktims.

Suprasti „add_filter“ ()

A filtras naudojamas ant teksto ar duomenų, perduodamų WordPress. Su filtrais, kuriuos galite tiesiog pažinti filtro turinys per savo pasirinktines rašytines funkcijas, kad pakeistumėte duomenis.

Pvz., Galite sukurti filtrą pakeisti $ the_content kuris yra „WordPress“ nustatytas kintamasis, apimantis visą „WordPress“ straipsnio turinį. Dėl mūsų „plug-in“ mes imsimės $ the_content ir ženklų ilgio sutrumpinimas į ištrauką.

Filtrai yra naudingi, kai rašote papildinius, kad tinkintumėte savo dienoraščio išvaizdą. Tai ypač populiarūs rašant šoninės juostos valdiklius arba mažesnes funkcijas, kad pakeistumėte, kaip turėtų būti rodomas pranešimas. Toliau pateikiamas kodo pavyzdys, rodantis, kaip taikyti filtrą.

add_filter ('wp_title', 'hongkiat_func');

Čia į „WordPress“ puslapio pavadinimą įtraukiame filtrą. Atminkite, kad šis kodas nesusijęs su mūsų oficialiu papildiniu ir yra naudojamas tik kaip pavyzdys.

The add_filter funkcija yra gimtoji „WordPress“ ir naudojama naujam filtrui pridėti prie puslapio turinio. Pirmiau esančioje eilutėje nukreipiame $ wp_title kuriame yra dabartinio puslapio pavadinimas. Tada mes perduodame šį kintamąjį į netikrą funkciją, pavadintą „ hongkiat_func () tai galėtų manipuliuoti ir grąžinti naują pavadinimo žymą bet kokiais tikslais.

Suprasti pridėti papildymą ()

Veiksmai yra panašūs į filtrus, nes jie neveikia duomenų bitais, o vietoj to nukreipia iš anksto nustatytas šablonų ir administratoriaus grupės sritis. Pavyzdžiui, galite taikyti veiksmą, kai atnaujinate ar redaguojate puslapio turinį. „WordPress“ siūlo išsamų veiksmų sąrašą savo API dokumentuose. Žemiau pateikiamas nedidelis pavyzdžių veiksmų sąrašas, skirtas susipažinti su kai kuriomis iš anksto nustatytų tikslinių sričių.

• public_post - skambinama, kai skelbiamas pranešimas arba kai statusas pakeičiamas į “paskelbtas”
• save_post - skambinama, kai skelbimas / puslapis sukuriamas nuo pradžios ar atnaujinimo
• wp_head - skambinama, kai šablonas yra įkeltas ir veikia wp_head () funkcija
• loop_end - skambinama iš karto po to, kai galutinė žinutė buvo apdorota per „WordPress“ kilpą
• trackback_post - skambinama, kai į naują įrašą įtraukiamas naujas takelis

Vėlgi galime matyti, kaip paprasta šis kodo bitų skaičius nukrenta. Jei galėsite suprasti skirtumą tarp veiksmų ir filtrų, jums bus daug arčiau pastato visapusiškus „WordPress“ įskiepius. Žemiau yra kita kodo eilutė, inicijuojanti veiksmo funkciją save_post kablys. Dar kartą paaiškinkite, kad tai nėra susiję su mūsų dabartiniu besivystančiu įskiepiu ir yra naudojamas tik kaip pavyzdinis kodas, skirtas suprasti pridėti paaiškinimą () funkcija.

add_action („save_post“, „pranešti“);

Taigi, čia matome panašų sąrankos būdą add_filter (). Mums reikia 2 kintamųjų, pirmasis - tai kablys, į kurį nukreipiame. Tokiu atveju save_post tai reiškia, kad išsaugant naują įrašą, mes vadiname savo funkciją, apibrėžtą antroje pozicijoje (pranešti ()). Akivaizdu, kad galite pranešti apie tai, kad norite būti bet kokiu funkcijų pavadinimu, kurį norite paleisti, tačiau tai nereikalinga mūsų dabartiniam pavyzdžio papildymui.

Užbaikite mūsų įskiepio logiką

Baigdami savo kelią, mūsų galutinę funkciją pridėsime prie mūsų papildinio failo. API dokumentacija yra labai specifinė ir suteikia puikų šaltinį kūrėjams, kurie gali turėti papildomų klausimų. Medžiaga gali atrodyti sudėtinga, jei nesate susipažinę su PHP, bet laiko laiką su sąvokomis ir viskas prasidės natūraliai!

Toliau pateikta funkcija turėtų būti pridėta tiesiai po papildinio antraštės komentaro. Arba tai taip pat gali būti patalpinta jūsų temos viduje funkcijos.php failą. Šis kodas naudojamas kurti dinaminį įrašo turinį, pagrįstą ribotu simbolių diapazonu.

Taigi, mūsų pavyzdyje mes galime apriboti tik 55 simbolių ilgio istorijas hk_trim_content () funkcija. Šį kodą galite lengvai paskambinti iš šoninės juostos valdiklio arba vieno iš jūsų teminių failų, kuriuos norite pakeisti $ the_content.

= $ limit) array_pop ($ content); $ content = implode (", $ content)." ... ";  else $ content = implode (", $ content);  $ content = preg_replace ('/\t./\t/', ", $ content); $ content = apply_filters ('the_content', $ content); grąžinti $ content;?> 

Nereikėtų tikėtis, kad jūs visiškai suprasite visus čia naudojamus vidinius kintamuosius ar funkcijas. Labai gera pradžia - tiesiog gauti bendrą supratimą apie tai, kaip turėtų būti parašytos jūsų funkcijos ir kaip atrodytų pavyzdys.

Taip pat galite pastebėti, kad naudojame skambutį taikyti_filtrus kuri yra kita „WordPress“ specifinė funkcija. Tai dar vienas aspektas, kurio jums nereikia visapusiškai suvokti, tačiau tai padeda ateityje programuoti per WP. Išsamesnės informacijos ir DUK šiuo klausimu ieškokite „application_filters“ nuorodų puslapyje.

Minėta pagrindinė funkcija hk_trim_content (). Tam reikia tik vieno parametro $ limit. Tai taip pat galėtų būti sutrumpinta iki $ lim kuris turėtų saugoti sveiką skaičių, nurodant, kiek simbolių apriboti ištrauka. Turinys naudojamas visuose skelbimų puslapiuose ir statiniuose puslapiuose (apie mus, susisiekite).

Todėl, norint šią funkciją skambinti, mes turime įtraukti šį parametrą į mūsų šablonų failus. Tai būtų patalpinta kažkur galbūt jūsų index.php arba loop.php pirmiausia turite įdiegti papildinį. Toliau pateiktas pavyzdys:

Įskiepio diegimas ir veikimas

Jei norite praleisti kietąjį kodavimą, sukūriau demonstracinį failą, skirtą papildiniui. Tiesiog atsisiųskite šį failą (pervadinkite jį į .php) arba nukopijuokite / įklijuokite kodą į naują PHP dokumentą ir įkelkite jį į savo / wp-content / plugins katalogą.

Kai baigsite, norėsite pasiekti „WordPress“ administravimo skydelį ir naršyti dabartinį įdiegtų demo rinkinių rinkinį. Įjungę nieko naujo neįvyks, ne tol, kol mūsų funkcijų skambutį pridėsime rankiniu būdu. Norėdami tai padaryti, tiesiog naršykite Išvaizda -> Redaktorius ir ieškokite single.php.

Šiame faile yra visi pagrindinio straipsnio įrašo puslapio šablonai HTML / CSS. Slinkite žemyn, kol rasite turinys() ir pakeiskite aukščiau pateiktu pavyzdiniu kodu. Tai apribos visus jūsų straipsnio puslapius iki 55 simbolių, nesvarbu, koks vaizdas yra naudojamas. Į šią funkciją taip pat galite įtraukti panašius puslapius savo šablonų kataloge, pvz., search.php arba archive.php.

Išvada

Tai yra keletas pagrindinių dalykų, kaip pradėti dirbti WordPress programoje. Įskiepių sistema yra didelė ir joje yra daug vidinių funkcijų. Jei jau turite idėją įdiegti „plug-in“, išbandykite ją vietiniame „WordPress“ įrenginyje, kad galėtumėte naudotis šiomis temomis.

Jei vis dar painiojate daug informacijos, galite peržiūrėti „WordPress“ dokumentaciją ir ieškoti savo atsakymo. Plėtros bendruomenė turi daug naudingų naudotojų, o forumuose archyvuose yra klausimų nuo metų.