✅ WEB- ja WordPress -uutiset, -teemat, -laajennukset. Täällä jaamme vinkkejä ja parhaita verkkosivustoratkaisuja.

Mukautettujen edistyneiden kenttien koodaus: Johdanto

18

Advanced Custom Fields (ACF) on WordPress-laajennus, joka on loistava työkalu mukautetun post metan määrittämiseen. Sen avulla voit helposti rakentaa ja konfiguroida monimutkaisia ​​ja käyttäjäystävällisiä metalaatikoita, joissa on kaikenlaisia ​​kenttiä ja asetuksia viestityypeille, taksonomialle, käyttäjänäytöille ja asetussivuille. Ja se on erittäin kehittäjäystävällinen.

Nyt voit määrittää omat metalaatikot tai asetukset manuaalisesti, mutta monimutkaisempia asetuksia varten sinun on koodattava melko vähän, mukaan lukien tyyli, Javascript, validointi ja tallennuksen käsittely. Kuvittele esimerkiksi kirjoittavan manuaalisesti toistimen asetusryhmällä, usean viestien valinnalla tietyllä kyselyllä. Tai sellaisten asetusten näyttäminen, jotka riippuvat tietyistä muuttujista, kuten määritetystä termistä tai sivumallista (mikä vaatii Javascriptin). Advanced Custom Fields käsittelee kaiken tämän, ja se tekee sen kauniisti.

Muista, että Advanced Custom Fields ei itse asiassa tulosta mitään mukautettua metatietoa malleissasi. Kehittäjän tehtävänä on tuottaa tai tehdä jotain ACF:llä määritettyjen kenttien ja asetusten perusteella. Mutta tämä on helppo tehdä käyttämällä mitä tahansa ACF:n menetelmiä. On myös mukava tietää, että ACF hyödyntää WordPress-ytimen (viesti, termi, käyttäjä) metatoimintoja. Tämä tarkoittaa, että se itse asiassa tallentaa esim. viestien asetukset post-meta-muodossa – johon voit saada käsiinsä käyttämällä ydintoimintoja, kuten get_post_meta().

Advanced Custom Fields -kentistä on saatavana ilmainen versio ja Pro-maksullinen versio. Ilmainen versio on enemmän kuin tarpeeksi useimpiin tapauksiin, mutta Pro-versiossa saat lisäominaisuuksia, kuten toistinkentän, galleriakentän, Gutenberg-lohkot (katso myöhemmin) ja mahdollisuuden käyttää ACF:ää oman mukautetun järjestelmänvalvojan määrittämiseen. vaihtoehtosivut. ACF on myös niin suosittu, että voit helposti löytää korkealaatuisia laajennuksia kaikkeen, mitä ydin-ACF ei peitä.

Advanced Custom Fields: Järjestelmänvalvojan osa

Kun asennat Advanced Custom Fields -laajennuksen, saat uuden järjestelmänvalvojavalikon "Muokatut kentät" varten. Tässä voit määrittää ja määrittää "metalaatikot" tai asetusryhmät.

Ryhmän sisällä voit määrittää niin monta kenttää kuin haluat erityyppisiä. Yleisimmät ovat tekstinsyöttö, tekstialue, richtext-editori, tiedosto, kuva, tosi/epätosi (vaihtokytkin), valintaruudut, valintanapit ja valintaruutu. Muita yleisiä tapoja valita postaukset, taksonomian, käyttäjien valitseminen, päivämäärävalitsin, värinvalitsin, Google Maps ja monet, monet muut. Valitsemastasi kenttätyypistä riippuen saat useita lisävaihtoehtoja kentän mukauttamiseen. Voit myös lisätä ehdollista logiikkaa mihin tahansa kenttään. Ehdollinen logiikka on tarkoitettu kenttien piilottamiseen tai näyttämiseen ryhmän muista vaihtoehdoista riippuen.

Jokaiselle asetusryhmälle voit määrittää, missä tapauksissa näiden asetusten tulee näkyä. Esimerkkejä ovat viestien muokkaaminen, taksonomiatermi tai käyttäjän muokkaaminen. Voit muokata asetustesi näkyvyyttä lisää esimerkiksi viestityypin mukaan. Tai jos julkaisulle on määritetty tietty termi tai sivumalli, jos viesti on tietyltä kirjoittajalta, jos käyttäjärooli on sellainen, nykyisen kirjautuneen käyttäjän rooli tai jos sivu on yläsivu tai ei. Voit myös muokata sitä, missä metaruudun pitäisi näkyä. Tämä toiminto on kuitenkin hieman heikentynyt nyt uuden Gutenberg-editorin myötä.

Mukautettujen edistyneiden kenttien koodaus: Johdanto

Ryhmän perustaminen

Mukautettujen edistyneiden kenttien koodaus: Johdanto

Yhden kentän asetukset

Advanced Custom Fields: Koodiosa

Katsotaanpa mielenkiintoisempaa osaa: kuinka voit hyödyntää Advanced Custom Fields -kenttiä koodin mukaan. Kuten aiemmin mainittiin, ACF on erittäin kehittäjäystävällinen ja tarjoaa laajan valikoiman mukautettavuutta.

Arvojen saaminen ja niiden tulostaminen malleihin onnistuu helposti ACF:n menetelmillä. Esimerkiksi the_field('your_meta_key')sen suoraan kaikumiseen tai get_field('your_meta_key')sen tallentamiseen PHP-muuttujaan. Anna viestitunnus toiseksi argumentiksi, jos haluat hakea tietoja silmukan ulkopuolelta. Helppo nakki. Voit käyttää get_post_meta(), mutta on suositeltavaa käyttää ACF:n menetelmiä, koska ACF voi muuttaa arvon joksikin merkityksellisemmäksi ennen kuin palauttaa sen sinulle.

Toinen asia, joka sinun tulee olla tietoinen, on ACF:n vientityökalu. Voit viedä luodut ryhmät kahteen muotoon; joko ladattava JSON-tiedosto tai puhdas PHP-koodi. JSON-tiedosto on hyödyllinen, jos haluat viedä asetukset testi- ja live-palvelimien tai muun WordPressin välillä. Vienti puhtaalla PHP:llä antaa sinulle mahdollisuuden liittää se suoraan teema- tai lisäosa PHP-tiedostoosi.

Kuten tästä voi päätellä; Voit lisätä ryhmiäsi ja kenttiäsi PHP-koodin avulla joko kirjoittamalla sen manuaalisesti tai viemällä sen sen jälkeen, kun olet asettanut ne adminissa. Tämä mahdollistaa enemmän hallintaa ja tapoja luoda mukautettuja valintoja.

Mutta odota, siellä on enemmän! ACF tarjoaa myös laajan valikoiman toimintoja ja suodattimia kenttien tai niiden arvojen mukauttamiseen edelleen. Siellä on koukkuja kentän tallentamiseen tai renderöimiseen sekä koukkuja ryhmien rekisteröintiin koodin mukaan (mainittu yllä) ja suodattimia kentän arvojen, asetusten tai valintojen mukauttamiseen ennen tallennusta tai ennen renderöimistä. Voit lisäksi määrittää, vaikuttaako suodatin kaikkiin kenttiin, tietyn tyypin kenttiin vai tietyn metaavaimen kenttiin. Kaikkien koukkujen ja suodattimien etuliitteenä on acf/.

Katso ACF:n dokumentaatiosivu ; Napsauta "Toiminnot", "Toiminnot" tai "Suodattimet" saadaksesi yleiskatsauksen. Tältä sivustolta löydät myös upeita opetusohjelmia ja oppaita.

Huomautus Advanced Custom Fields -kentistä ja Gutenbergistä

Mukautettujen Gutenberg-lohkojen luominen on tällä hetkellä melko pelottavaa. Dokumentaatio ei ole aivan paikallaan, siihen tulee usein muutoksia ja sen koodaaminen vaatii melkoisesti Javascript-osaamista. Tarvitset mielellään tietoa Reactista ja JSX/ES6-kääntäjän asentamisesta webpackilla ja Babelilla.

Kuitenkin versiossa 5.8 ACF Pro esitteli ominaisuuden kenttäryhmän määrittämiseksi Gutenberg-lohkoksi – jolloin voit lisätä mukautettuja lohkoja puhtaasti ACF- ja PHP-koodilla. Javascriptin tuntemusta ei tarvita!

Sinun tarvitsee vain määrittää ryhmät adminissa tai koodilla tavalliseen tapaan. Mutta sitten määritellään niiden sijainti Gutenbergin kortteliksi. Jäljelle jää vain PHP-koodin lisääminen niiden rekisteröimiseksi mukautetuksi Gutenberg-lohkoksi acf_register_block(). Tälle funktiolle määrität takaisinkutsun PHP-funktiolle tai mallitiedostolle, joka vastaa lohkotulosteen renderöimisestä. Kirjoitat tämän funktion tai malliosan kokonaan PHP:llä ja käytät tuttuja menetelmiä, kuten get_field()asetusarvojen hankkimiseen.

Mukautettujen edistyneiden kenttien koodaus: Johdanto

Miltä ACF-lohko näyttää Gutenberg-editorissa

Pysy kuulolla Advanced Custom Fields -kategoriassa saadaksesi opetusohjelmia tämän laajennuksen käytöstä!

Tämä verkkosivusto käyttää evästeitä parantaakseen käyttökokemustasi. Oletamme, että olet kunnossa, mutta voit halutessasi kieltäytyä. Hyväksyä Lisätietoja