Advanced Custom Fields (ACF) on WordPressi pistikprogramm, mis on suurepärane tööriist kohandatud postituse meta seadistamiseks. See võimaldab teil hõlpsasti luua ja konfigureerida keerulisi ja kasutajasõbralikke metakaste, mis sisaldavad kõikvõimalikke väljade ja sätteid postituste tüüpide, taksonoomia, kasutajaekraanide ja valikute lehtede jaoks. Ja see on ülimalt arendajasõbralik.
Nüüd saate oma metakastid või sätted käsitsi seadistada, kuid keerukamate seadete jaoks on vaja üsna palju kodeerida, sealhulgas stiili, Javascripti, valideerimist ja salvestamist. Kujutage näiteks ette, et kirjutate käsitsi korduse seadete rühmaga, teatud päringu järgi mitu postitust. Või seadete kuvamine, mis sõltuvad teatud muutujatest, näiteks sellest, milline termin või lehemall on määratud (see nõuab Javascripti). Advanced Custom Fields tegeleb selle kõigega ja teeb seda kaunilt.
Pidage meeles, et täpsemad kohandatud väljad ei väljasta teie mallidesse teie kohandatud metat. ACF-iga seadistatud väljade ja sätete põhjal millegi väljastamine või tegemine on teie kui arendaja enda teha. Kuid seda on lihtne teha, kasutades mis tahes ACF-i meetodeid. Samuti on tore teada, et ACF kasutab WordPressi tuuma (postitus, termin, kasutaja) metafunktsioone. See tähendab, et see salvestab nt postituste sätted postituse meta-vormingus, mida saate kasutada põhifunktsioonide, näiteks, abil get_post_meta().
Täpsemad kohandatud väljad on saadaval tasuta versioonis ja tasulises Pro versioonis. Tasuta versioonist on enamikul juhtudel enam kui piisav, kuid Pro versioonis saate mõned lisafunktsioonid, nagu repiiteri väli, galerii väli, Gutenbergi plokid (vt hiljem) ja võimalus kasutada ACF-i oma kohandatud administraatori seadistamiseks. valikute leheküljed. ACF on ka nii populaarne, et leiate hõlpsalt kvaliteetseid laiendusi kõigele, mida põhi-ACF ei kata.
Täpsemad kohandatud väljad: administraatori osa
Kui installite Advanced Custom Fields plugina, saate uue administraatori menüü "Kohandatud väljade" jaoks. Siin saate seadistada ja konfigureerida oma "metabokse" või seadete rühmi.
Grupi sees saate seadistada nii palju eri tüüpi välju, kui soovite. Levinumad on tekstisisestus, tekstiala, rikastekstiredaktor, fail, pilt, tõene/väär (lüliti), märkeruudud, raadionupud ja valikukast. Teised levinumad on mitmel viisil postituste valimine, taksonoomia, kasutajate valimine, kuupäevavalija, värvivalija, Google Maps ja palju muud. Sõltuvalt valitud väljatüübist saate välja kohandamiseks täiendavaid valikuid. Samuti saate mis tahes väljale lisada tingimusliku loogika. Tingimuslik loogika on mõeldud väljade peitmiseks või kuvamiseks sõltuvalt rühma muudest valikutest.
Iga seadete rühma jaoks saate määrata, millistel juhtudel need seaded ilmuvad. Näiteks postituste, taksonoomiatermini või kasutaja muutmine. Saate oma seadete nähtavust veelgi kohandada, näiteks postituse tüübi järgi. Või kui postitusele on määratud teatud termin või lehemall, kui postitus on teatud autorilt, kui kasutaja roll on nii või nii, siis praeguse sisselogitud kasutaja roll või kui leht on emaleht või mitte. Samuti saate kohandada seda, kus metakast peaks ilmuma. Kuid see funktsioon on nüüd uue Gutenbergi redaktoriga mõnevõrra vähenenud.
Grupi loomine
Ühe välja sätted
Täpsemad kohandatud väljad: koodiosa
Vaatame huvitavamat osa: kuidas saate täpsemaid kohandatud välju koodi järgi kasutada. Nagu varem mainitud, on ACF ülimalt arendajasõbralik ja pakub laias valikus kohandatavust.
Väärtuste leidmine ja nende mallidesse sisestamine on lihtne ACF-i meetodeid kasutades. Näiteks the_field('your_meta_key')selle otseseks kajamiseks või get_field('your_meta_key')PHP muutujasse salvestamiseks. Kui teil on vaja andmeid hankida väljaspool ahelat, esitage teise argumendina postituse ID. Lihtne. Võite kasutada get_post_meta(), kuid soovitatav on kasutada ACF-i meetodeid, kuna ACF võib enne selle teile tagastamist muuta väärtuse millekski tähendusrikkamaks.
Teine asi, mida peaksite teadma, on ACF-i eksporditööriist. Loodud rühmi saate eksportida kahte vormingusse; kas allalaaditav JSON-fail või puhas PHP-kood. JSON-fail on kasulik, kui peate eksportima seadeid test- ja reaalajas serverite või mõne muu WordPressi vahel. Eksportimine puhtas PHP-s annab teile võimaluse kleepida see otse oma teema või plugina PHP-failidesse.
Nagu võite sellest järeldada; PHP-koodi saate kasutada oma rühmade ja väljade lisamiseks kas käsitsi kirjutades või pärast nende administraatoris seadistamist eksportides. See võimaldab rohkem kontrolli ja võimalusi kohandatud valikute loomiseks.
Aga oota, seal on veel! ACF pakub ka laia valikut toiminguid ja filtreid väljade või nende väärtuste edasiseks kohandamiseks. Seal on konksud välja salvestamiseks või renderdamiseks, samuti konksud rühmade koodi järgi registreerimiseks (mainitud ülal) ja filtrid välja väärtuste, sätete või valikute kohandamiseks enne salvestamist või enne renderdamist. Lisaks saate määrata, kas filter peaks mõjutama kõiki välju, teatud tüüpi välju või teatud metavõtmega välju. Kõikide konksude ja filtrite ees on acf/.
Vaadake ACF-i dokumentatsioonilehte ; ülevaate saamiseks klõpsake "Funktsioonid", "Toimingud" või "Filtrid". Sellelt saidilt leiate ka suurepäraseid õpetusi ja juhendeid.
Märkus täpsemate kohandatud väljade ja Gutenbergi kohta
Kohandatud Gutenbergi plokkide loomine on praegu üsna hirmutav. Dokumentatsioon ei ole päris paigas, muudatusi tuleb selles sageli ette ja selle kodeerimiseks on vaja üsna palju Javascripti teadmisi. Eelistatavalt vajate teadmisi Reactist ja JSX/ES6 kompilaatori seadistamisest veebipaketi ja Babeliga.
Kuid versioonis 5.8 tutvustas ACF Pro funktsiooni väljarühma seadistamiseks Gutenbergi plokina, mis võimaldab teil lisada kohandatud plokke puhtalt ACF-i ja PHP-koodiga. Javascripti teadmisi pole vaja!
Kõik, mida pead tegema, on seadistada rühmad administraatoris või koodi järgi nagu tavaliselt. Kuid siis määratledes nende asukoha Gutenbergi kvartalina. Jääb üle vaid lisada PHP-kood, et registreerida need kohandatud Gutenbergi plokina rakendusega acf_register_block(). Sellele funktsioonile määrate tagasihelistamise PHP-funktsioonile või mallifailile, mis vastutab ploki väljundi renderdamise eest. Kirjutate selle funktsiooni või malli osa täielikult PHP-s ja kasutate tuttavaid meetodeid, näiteks get_field()seadistusväärtuste hankimiseks.
Kuidas ACF-plokk Gutenbergi redaktoris välja näeb
Selle pistikprogrammi kasutamise õpetuste saamiseks hoidke end kursis kategoorias Täpsemad kohandatud väljad !