Pilk WordPressi Gutenbergi uutesse plokimustritesse arendaja silmis. Uurime, mis need on, milleks neid saab kasutada, ja uurime põhjalikumalt, kuidas neile koodi kirjutada.
Plokimustrid ja nende kasutamine
Plokimustrid võeti kasutusele WordPressi versioonis 5.5 (11. august 2020). Need on ploki sisestaja uus funktsioon, mis hõlbustab mitme ploki eelmääratletud konfiguratsiooni sisestamist. Teema või pistikprogrammi arendajad saavad määrata plokkide rühma, nende pesastamise, sisu ja atribuudid ning lõppkasutajad saavad selle sisestada lihtsa ühe klõpsuga. Idee seisneb selles, et lõppkasutajad ei pea enam käsitsi keerukaid paigutusi ja kõiki kohandatud sätteid koostama ning neid sageli kasutatavate plokkide jaoks sobivatesse konteineritesse pesastama.
Kui plokimuster on redaktorisse lisatud, ei tea plokid, et need lisati plokimustri kaudu. Need lisatakse tavaliste plokkidena, mis võimaldavad kasutajatel oma sisu ja sätteid muuta. Põhimõtteliselt on see otsetee mitme ploki konfiguratsiooni lisamiseks.
Idee on hea! Kõigil lõppkasutajatel ei ole mugav koostada redaktoris suurt pesastatud plokkide struktuuri, et see täiuslik välja näeks. Kuid siiani on see funktsioon peamiselt arendajatele kasulik, kuna lõppkasutajad ei saa oma mustreid luua. Kasutajate enda kohandatud plokkide puhul peavad nad kasutama korduvkasutatavaid plokke. Kuid eriti teemaarendajate jaoks võimaldavad plokkide mustrid näidata lõppkasutajatele tõeliselt parimat plokkide konfiguratsiooni, mis teemas hästi toimib.
WordPress on lisanud plokimustrite jaoks uue teematoe: 'core-block-patterns'. Core käivitab alates versioonist 5.5.0 automaatselt a add_theme_support('core-block-patterns'), nii et te ei pea seda oma teemas tegema.
Kuna kõik plokkmustri funktsioonid on olemas ainult väga uues WordPressi versioonis, on hea mõte esmalt selle olemasolu kontrollida, et mitte rikkuda saite vanemate WordPressi versioonidega. Kõigis allpool toodud koodinäidetes olen just seda teinud.
WordPress 5.5 tarnitakse 9 eelmääratletud plokimustriga (vt allolevat loendit). Plokimustrid kuvatakse mustrite kategooriates (tuum lisab 5 kategooriat). Blokeerimismustri kategooriad töötavad nagu postituste kategooriad; saate paigutada ploki mustri mitmesse kategooriasse. Teemade ja pistikprogrammide arendajad saavad registreerida oma plokimustrid ja plokimustrite kategooriad, samuti tühistada nende registreerimise. Nii et vaatame lähemalt, kuidas!
WordPressi 5.5-s sisalduvad plokimustrid ja plokkide mustrite kategooriad
WordPress 5.5-s tarnitud plokkide mustrid on järgmised (iga mustri nimeruum ja nälkja ID kuvatakse sulgudes):
- Kaks nuppu (‘
core/two-buttons‘) - Kolm nuppu (‘
core/three-buttons‘) - Kaks veergu teksti (‘
core/text-two-columns‘) - Kaks veergu teksti piltidega (‘
core/text-two-columns-with-images‘) - Kolm tekstiveergu nuppudega (‘
core/text-three-columns-buttons‘) - Kaks pilti kõrvuti (‘
core/two-images‘) - Suur päis koos pealkirjaga (‘
core/large-header‘) - Suur päis koos päise ja nupuga (‘
core/large-header-button‘) - Tsitaat (‘
core/quote‘)
WordPress 5.5-s lisatud kategooriad on järgmised (nende nälkjate ID-d kuvatakse sulgudes):
- Nupud (‘
buttons‘) - Veerud (‘
columns‘) - Galerii (‘
gallery‘) - Päised ("
header" – märkus, et lõppu ei ole "s") - Tekst (‘
text‘)
Plokimustrite registreerimise tühistamine
Blokeerimismustrite registreerimise saate tühistada, kasutades funktsiooni [unregister_block_pattern](https://developer.wordpress.org/block-editor/developers/block-api/block-patterns/#unregister_block_pattern)(). Sisestage parameetrina eemaldamiseks lihtsalt plokimustriga string. Tuumaploki mustrite kohta vaadake ülaltoodud ülevaadet. Käivitage see funktsioon toiminguga ühendatud funktsiooni sees init.
Näide põhiploki mustrite "Kaks nuppu" ja "Kolm nuppu" registreerimise tühistamisest:
add_action('init', function() {
if (!function_exists('unregister_block_pattern')) {
return;
}
unregister_block_pattern('core/two-buttons');
unregister_block_pattern('core/three-buttons');
});Plokkide mustrite registreerimine
Uue plokimustri registreerimine toimub funktsiooniga [register_block_pattern](https://developer.wordpress.org/block-editor/developers/block-api/block-patterns/#register_block_pattern)(). See aktsepteerib kahte parameetrit; esimene on teie mustri unikaalse nime string, sealhulgas nimeruum. Teine on teie plokimustri seadete hulk.
Näpunäide. Plokimustri määratlemiseks peate oma ploki konfiguratsiooni jaoks esitama toores HTML-sisu. Ma ei soovita seda käsitsi välja kirjutada, kuna see põhjustab kergesti kehtetuid plokkide konflikte. Selle asemel minge redaktorisse ja seadistage plokid nii, nagu soovite, et need mustris oleksid. Seejärel klõpsake vanemploki tööriistaribal "punktimenüüd" ja klõpsake nuppu "Kopeeri". Pärast seda saate minna tagasi oma koodiredaktorisse ja kleepida (Ctrl+V). See annab teile kopeeritud konfiguratsiooni töötlemata HTML-i. Kasutage koodiredaktori funktsioone, et asendada kõik reavahetused nja veenduda, et jutumärgid on õiged.
Teie plokimustri omadused on järgmised (teine argumentide massiiv):
title(nõutav): teie plokimustri kuvatav nimi**content**(nõutav): ploki konfiguratsiooni RAW HTMLdescription: ploki mustri kirjeldus. Visuaalselt peidetudcategories: kategooriate massiiv, millesse see plokimuster lisada. Kui te seda atribuuti ei anna, paigutatakse plokk plokimustri kategooriasse "Kategooreeta".keywords: hulk märksõnu, mis aitavad kasutajatel teie mustrit otsimise ajal leidaviewportWidth: sisestage sisestajas ploki mustri laiuse täisarv. Mõjutab ainult sisestusprogrammi eelvaadet.
Siin on näide plokimustri registreerimisest, mis koosneb täislaiusest kaaneplokist, millel on taustavärv, mis sisaldab konkreetse tekstivärviga keskele joondatud pealkirjaplokki ja kindla tekstivärviga keskele joondatud lõiku:
Plokimustri kategooriate registreerimine
Arendajad saavad registreerida ka kohandatud plokimustri kategooriaid. Seda tehakse funktsiooniga [register_block_pattern_category](https://developer.wordpress.org/block-editor/developers/block-api/block-patterns/#register_block_pattern_category)(). See aktsepteerib kahte parameetrit; esiteks kategooria slug string ja teiseks omaduste massiiv. Praeguse seisuga toetatakse teises argumendis ainult ühte omadust; labelkategooria loetava nime jaoks.
Allpool on näide kohandatud plokimustri kategooria registreerimisest:
Selle abil saate lisada ‘awp-mustrid’ categoriesargumendile ‘ ‘ register_block_pattern(). Pidage meeles, et kui kategooriale pole registreeritud plokimustreid, ei kuvata kategooriat ploki sisestajas. Selle kuvamiseks peate sellesse kategooriasse lisama vähemalt ühe plokimustri.
Plokimustrite kategooriate registreerimise tühistamine
Lõpuks on olemas funktsioon [unregister_block_pattern_category](https://developer.wordpress.org/block-editor/developers/block-api/block-patterns/#unregister_block_pattern_category)()plokimustri kategooria registreerimise tühistamiseks. Esitage parameetrina kategooria nälkjas. Põhikategooriate ja nende nälkjate kohta vaadake ülaltoodud plokimustri kategooriate ülevaadet.
Ärge unustage, et plokimustri kategooriad, millel pole neile määratud plokimustreid, ei ole ploki sisestajas nähtavad. Seega, kui tühistate kõik kategooriale määratud plokimustrid, ei ole kategooria ise enam nähtav ja te ei pea tingimata kategooriat tühistama. Kõik plokkide mustrid, mis on määratud ainult eemaldatavale kategooriale, teisaldatakse kategooriasse „Kategeerimata".
Siin on näide põhiploki mustri kategooria "nupud" registreerimise tühistamisest:
add_action('init', function() {
if (!function_exists('unregister_block_pattern_category')) {
return;
}
unregister_block_pattern_category('buttons');
});Järeldus
WordPress Gutenbergi uus plokimustri funktsioon on kindlasti samm lähemale sellele, et plokiredaktor töötaks rohkem lehe koostajana. Minu arvates on negatiivne külg see, et lõppkasutajad ei saa oma mustreid luua. Kuid see on hea funktsioon teemaarendajatele, kuna see võimaldab lõppkasutajatel hõlpsasti seadistada ploki konfiguratsioone ja paigutusi, mis teemas hästi töötavad. See on täiesti uus funktsioon ja tõenäoliselt areneb ja täiustatakse seda lähitulevikus! Mina näiteks ei jõua ära oodata!