Aloittelijan opas WordPress-laajennuksen kehittämiseen

WordPress CMS on muuttanut Internetin kasvot ja mahdollistanut uusien ideoiden nousun ja sen avoimen lähdekoodin liikkuvuudella on vahva läsnäolo, joka perustuu ohjelmistoon ja web-kehitykseen. WordPress on bloggaamisfoorumi, jolla on kyky käynnistää monia muita skriptejä, kuten webfoorumeita, työtauluja ja jopa klassista verkkosivun sisällönhallintajärjestelmää.

Käymme muutamia tapoja aloittaa WordPressin laajennusten kehittämisessä. Vaiheet ovat melko yksinkertaisia ​​eivätkä vaadi suurta omistautumista opiskeluun. PHP: n raskaampi tietämys olisi hyödyllistä, vaikka WordPress-tiedostorakenteesta ja hallintapaneelista saataisiin perustiedot.

Tässä lyhyessä opetuksessa käymme läpi yksinkertaiset WordPress-laajennuksen luomiseen tarvittavat perusvaiheet. Toimintoa käytetään luomaan dynaamisia otteita, jotka perustuvat funktiopuheluun siirtyneeseen numeroon. Sinun täytyy ladata laajennustiedosto ja aktivoida se Admin-paneelista, ja seurata sitä kutsumalla toimintoamme mistä tahansa sivusta, jota haluamme otteen näkyviin. Linkit valmiiksi saatettuun lähdekoodiin on jo lisätty myöhemmin tässä artikkelissa :)

Miksi kehittää WordPressille?

Lisäosat ovat loistava tapa parantaa blogisi toimivuutta lisäämällä lisäominaisuuksia. Ne voidaan sijoittaa mihin tahansa mallin sisällä toimintojen koukkuilla. Ajan myötä WordPress-laajennusjärjestelmän laajennettavuus on mahdollistanut valtavan kasvun ja satoja kehittäjän toimittamia ohjelmistoja.

WordPress tarjoaa CMS: ssä sellaisia ​​kehittyneitä ominaisuuksia, että ainutlaatuiset laajennukset ovat vain vähän ja kaukana toisistaan. Kehittäjänä voit hallita weblogisi taustajärjestelyjä. PHP-kehittäjän palkkaaminen järjestelmän laajennuksen luomiseksi maksaisi paljon enemmän kuin saatat kuvitella, ja API on melko helppo työskennellä ja oppia itse.

Toissijaisena argumenttina WordPressin kehittäminen on hyvä käytäntö, jonka avulla voit virittää itsesi muille alueille. Pienempien pluginien ja sivupalkkien widgettien rakentaminen WordPressiin auttaa sinua ymmärtämään, miten taustajärjestelmä todella toimii. Tämä ei rajoitu pelkästään WordPressiin, koska saat enemmän syvempää ymmärrystä valtaosasta Content Systemsistä.

1. WP-kansiorakenne

Johdatus WordPress-kansiorakenteeseen näyttää sovelluksen perusluettelot. Wp-sisällön sisällä on a liitännäiset hakemistoon. Tässä on kaikki yksittäiset laajennukset, joko yksittäiset tiedostot tai asianmukaisesti nimetyt alihakemistot.

Pienemmillä laajennuksilla, jotka tarvitsevat vain yhden .php-tiedoston, voit valita tämän suoraan laajennuksiin / hakemistoon. Mutta kun aloitat monimutkaisempien sovellusten kehittämisen, on paljon hyödyllistä luoda alikansion, joka on nimetty laajennuksen mukaan. Sisällä voit tallentaa JavaScriptin, CSS: n ja HTML: n mukana PHP-toiminnot.

readme.txt tiedosto voi olla hyödyllinen myös, jos suunnittelet laajennuksen lataamista. Tässä tiedostossa on oltava nimi ja plugin. Kirjoittajana voit myös harkita, miten jokainen tarkistus on saatavilla ja mitkä päivitykset ovat tulleet esiin.

2. PHP-tiedoston käynnistäminen

Kun luot uuden laajennuksen, sinun on aloitettava yksinkertainen PHP-tiedosto. Tämä voidaan nimetä mihinkään, mutta sen pitäisi yleensä kuvastaa laajennuksen virallista nimeä. Joten olen esimerkiksi luonut peruskoodin ja nimennyt tiedoston hongkiat-excerpt.phps.

Plug-inin ensimmäiset rivit on pakko kommentoi tietoa jäsentelymoottorista. Tämä on erittäin tärkeää, koska WordPress ei pysty käsittelemään tiedostoa ilman. Alla on esimerkkikoodinpätkä, jonka voit kopioida ja muovata omaan suuntaan.

Plugin-nimi on, mitä Admin-taustapaneelissa näkyy, kun siirryt aktivoimaan. Sama kuin URI, joka sijoitetaan laajennuspaneelin sisällä olevaan yksityiskohdaan. Vaikka sen ei tarvitse sisältää versiota tai kuvausta, se tekee laajennuksesi paljon ammattimaisemmaksi.

3. WordPressin nimeämissopimukset ja parhaat käytännöt

On olemassa muutamia tapoja, joilla voit todella rakentaa laajennuksesi. Monta kertaa PHP-kehittäjät luovat koko luokan järjestelmän välttääkseen törmäykset toimintojen ja muuttujien nimien kanssa. Jos et tunne PHP: n kehittynyttä OOP-toiminnallisuutta, on parasta vain kirjoittaa koodisi näytteen toimintoihin.

Esimerkiksi esimerkkikoodissamme kirjoitamme yhden toiminnon, jonka avulla voit tallentaa tietoja. Meidän on myös määriteltävä muutama muuttuja, jotka ovat avaintekijöitä mallipohjaisten tiedostojen sisällä. Alla on esimerkki plugin-tiedostosta otetusta koodista, jossa ydinlogiikka on poistettu.

Kun kirjoitat näytekoodia, on parasta noudattaa WordPressin asettamia ohjeita ja ohjeita. Koska jo määriteltyjä sisäisiä toimintoja on niin paljon, voit välttää kaksoiskappaleet etukäteen etiketin kaikkiin muuttujiin ja funktioiden nimiin.

Yllä olevissa esimerkeissä olemme liittäneet kaikki asetusten nimet hongkiat. Tämä voidaan korvata valitsemallasi avainsanalla, joka yleensä liittyy laajennuksenimeesi. Yllä oleva koodi on oikea näytteen asetukset ei pitäisi koskea meidän lopullista laajennusta. Tämä on vain antaa sinulle tietoa siitä, miten muuttujien nimet ja toimintopuhelut pitäisi kirjoittaa.

4. Sukellus suodattimiin ja toimintoihin

On olemassa toinenkin huomionarvoinen käsite, ennen kuin siirrymme raakakoodiin. Toimet ja suodattimet ovat kaksi täysin eri käsitettä, jotka liittyvät syvästi tapoihin, joilla ne manipuloivat laajennustietoja.

Nämä kaksi koodia tulevat standardiksi WordPress API: ssa. Suodattimet ja toimet mahdollistavat plug-in-kehittäjien päivittämään koodin koko WordPress-järjestelmänvalvojapaneeliin, joka liittyy uuteen laajennukseen. Tämä tarkoittaa, että voit lisätä uuden välilehden sivupalkkiin tai lisäasetuksia linkkejä laajennusvaihtoehtoihin.

Ymmärtäminen add_filter ()

suodattaa käytetään hieman tekstiä tai tietoja siirretään WordPress. Suodattimien avulla olet aivan kirjaimellisesti suodattaa sisältöä Voit muokata tietoja millään tavalla omien räätälöityjen toimintojen avulla.

Voit esimerkiksi luoda suodattimen muutettavaksi $ the_content joka on WordPressin asettama muuttuja, joka sisältää WordPress-artikkelin koko sisällön. Meidän plug-in otamme $ the_content ja merkkien pituuden lyhentäminen otteeksi.

Suodattimet ovat käteviä, kun kirjoitat laajennuksia blogin ulkoasun ja tuntuman muokkaamiseen. Nämä ovat erityisen suosittuja, kun kirjoitat sivupalkin widgettejä tai pienempiä toimintoja, joilla muutetaan, miten viesti tulisi näyttää. Alla on esimerkkijono koodista, joka näyttää suodattimen käyttämisen.

add_filter ('wp_title', 'hongkiat_func');

Tässä lisätään suodatin WordPress-sivun otsikkoon. Huomaa, että tämä koodi ei liity viralliseen laajennukseen, ja sitä käytetään vain esimerkkinä tästä.

add_filter toiminto on WordPressin luontainen ja sitä käytetään lisäämään uusi suodatin sivun sisällöstä löytyvään muuttujaan. Yllä olevalla rivillä kohdistetaan $ wp_title joka sisältää nykyisen sivun otsikon. Sitten välitämme tämän muuttujan fake-funktioksi, jonka nimi on hongkiat_func () joka voisi sitten käsitellä ja palauttaa uuden nimilapun mihin tahansa tarkoitukseen.

Ymmärrä lisäosa ()

Toimet ovat samankaltaisia ​​kuin suodattimet, koska ne eivät toimi datan bitteissä, vaan kohdistavat ennalta määritellyt alueet malleihin ja admin-paneeliin. Esimerkkinä voit käyttää toimintoa aina, kun päivität tai muokkaat sivun sisältöä. WordPress tarjoaa kattavan toimintoluettelon API-dokumentaatioistaan. Alla on pieni luettelo esimerkkitoimista, joiden avulla voit tutustua joihinkin ennalta määrättyihin kohdealueisiin.

• publish_post - kutsutaan, kun viesti julkaistaan ​​tai kun tila muuttuu “julkaistu”
• Tallenna julkaisu - kutsutaan, kun viesti / sivu luodaan alusta tai päivitetään
• wp_head - kutsutaan, kun malli on ladattu ja toimii wp_head () toimia
• loop_end - kutsutaan välittömästi sen jälkeen, kun viimeinen viesti on käsitelty WordPress-silmukan kautta
• trackback_post - kutsutaan aina, kun uusi jälkipalvelin lisätään viestiin

Jälleen voimme nähdä, kuinka yksinkertainen tämä koodi koodista on. Jos ymmärrät eri toimintojen ja suodattimien välisen eron, olet niin paljon lähempänä kattavien, toimivien WordPress-laajennusten rakentamista. Alla on toinen koodirivi, joka aloittaa toimintotoiminnon Tallenna julkaisu koukku. Jälleen selventämiseksi tämä ei koske nykyistä kehittyvää laajennustamme, vaan sitä käytetään vain esimerkkikoodina ADD_ACTION () toimia.

add_action ('save_post', 'message');

Joten tässä näemme samanlaisen asennuksen ennen add_filter (). Tarvitsemme 2 muuttujaa, joista ensimmäisessä on kohdistamamme koukun nimi. Tässä tapauksessa Tallenna julkaisu mikä tarkoittaa, että kun uusi viesti tallennetaan, kutsumme funktiota, joka on määritelty toisessa asennossa (ilmoittaa()). Voit tietysti päivittää ilmoituksen olevan mitä tahansa funktion nimeä, jota haluat käyttää, mutta tätä ei tarvita nykyisessä esimerkki-laajennuksessamme.

Plugin-logiikan viimeistely

Viimeistelemme polkua lisäämällä lopullisen toiminnon suoraan plug-in-tiedostoomme. API-dokumentaatio on hyvin spesifinen ja tarjoaa erinomaisen resurssin kehittäjille, joilla voi olla kehittyneitä kysymyksiä. Materiaali saattaa tuntua vaikealta, jos et ole perehtynyt PHP: hen, mutta vie aikaa käsitteisiin ja asiat alkavat virrata luonnollisesti!

Alla oleva toiminto on lisättävä suoraan pluginin otsikkokommentin jälkeen. Vaihtoehtoisesti tämä voitaisiin sijoittaa myös teemasi sisälle functions.php tiedosto. Koodia käytetään dynaamisen postisisällön luomiseen rajoitetun merkkivalikoiman perusteella.

Esimerkiksi esimerkillämme voidaan rajoittaa vain 55 merkin pitkiä tarinoita hk_trim_content () toimia. Voit helposti kutsua koodin bitin sivupalkin widgetistä tai toisesta teematiedostostasi $ 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); palauttaa $ content;?> 

Ei pidä odottaa, että ymmärrät täysin kaikki sisäiset muuttujat tai toiminnot, joita tässä käytetään. Vain yleinen käsitys siitä, miten toiminnot tulisi kirjoittaa ja mitä esimerkkisarja näyttää, on erittäin hyvä alku.

Saatat myös huomata, että käytämme puhelua apply_filters joka on toinen WordPress-ominaisuus. Tämä on toinen näkökohta, jota sinun ei tarvitse täysin ymmärtää, mutta se auttaa WP: n tulevaa ohjelmointia varten. Tarkempia tietoja ja usein kysyttyjä kysymyksiä on osoitteessa application_filters.

Yllä oleva ydintoiminto on nimetty hk_trim_content (). Tämä vaatii vain yhden parametrin nimeltä $ limit. Tämä voitaisiin myös lyhentää $ lim joka tallentaa kokonaisluvun, jossa ilmoitetaan, kuinka monta merkkiä rajoitetaan otteeseen. Sisältöä käytetään koko postisivulla ja myös staattisilla sivuilla (meistä, yhteystiedot).

Siksi, jotta tätä toimintoa kutsuttaisiin, meidän olisi lisättävä parametri mallipohjatiedostoihimme. Tämä sijoitettaisiin jonnekin mahdollisesti omaan index.php tai loop.php tiedosto (t) ja sinun on asennettava laajennus ensin. Alla oleva esimerkki:

Pluginin asentaminen ja käyttö

Olen luonut laajennuksen mallitiedoston demolle, jos haluat ohittaa kovan koodauksen. Lataa tämä tiedosto (nimeä se uudelleen .php) tai kopioi / liitä koodi uuteen PHP-asiakirjaan ja lataa se / Wp-content / plugins hakemisto.

Kun olet valmis, haluat käyttää WordPress-hallintapaneelia ja selata juuri asennetun demon nykyisiä laajennuksia. Kun olet aktivoinut mitään uutta, tapahtuu vasta, kun lisäät manuaalisesti toimintopuheluun. Voit tehdä tämän yksinkertaisesti selaamalla Ulkonäkö -> Editor ja etsi single.php.

Tämä tiedosto sisältää kaikki perusartikkelit-sivusi HTML / CSS-mallit. Selaa alaspäin, kunnes löydät sisältö() ja korvaa yllä oleva esimerkkikoodi. Tämä rajoittaa kaikki artikkelisivut 55 merkkiin riippumatta siitä, mitä näkymää käytetään. Voit myös lisätä tähän toimintoon vastaavia sivuja mallipohjan hakemistossa, kuten search.php tai archive.php.

johtopäätös

Nämä ovat joitakin perusasioita, joiden avulla voit aloittaa työskentelyn WordPress-kehityksessä. Plugin-järjestelmä on laaja ja sisältää paljon sisäistä toimivuutta. Jos sinulla on jo ajatus plug-inistä, kokeile sitä paikallisessa WordPress-asennuksessa harjoittaaksesi näitä aiheita.

Jos olet yhä hämmentynyt useista tiedoista, voit tarkastella WordPress-dokumentaatiota ja etsiä vastauksesi siellä. Kehitysyhteisö on täynnä avuliaita käyttäjiä, ja foorumit pitävät arkistoja vuosien varrella.