allowed_block_types<\/code>. Ten filtr podaje dwa parametry; tablica wszystkich blok\u00f3w i obiekt post. Wszystko, co musimy zrobi\u0107, to zarz\u0105dza\u0107 tablic\u0105 przed jej zwr\u00f3ceniem. A poniewa\u017c w filtrze otrzymujemy r\u00f3wnie\u017c obiekt postu, mo\u017cemy r\u00f3wnie\u017c dodawa\u0107 regu\u0142y wed\u0142ug typu posta lub innych informacji meta postu.<\/p>\nTablica blok\u00f3w sk\u0142ada si\u0119 z ci\u0105g\u00f3w nazw blok\u00f3w w przestrzeni nazw. Wszystkie bloki w WordPress wymagaj\u0105 przestrzeni nazw z przedrostkiem przed nazw\u0105 bloku. W przypadku podstawowych blok\u00f3w WordPress przestrze\u0144 nazw to \u201e core\/<\/code>", a w przypadku osadzonych blok\u00f3w WordPress przestrze\u0144 nazw to \u201e core-embed\/<\/code>„. Na przyk\u0142ad blok nag\u0142\u00f3wka ma core\/heading<\/code>w tej tablicy nazw\u0119 \u201e „. Stworzy\u0142em pe\u0142ny przegl\u0105d nazw wszystkich typ\u00f3w blok\u00f3w w moim po\u015bcie na temat Jak aby uzyska\u0107 dost\u0119p i przeanalizowa\u0107 bloki posta<\/a>.<\/p>\nOto kr\u00f3tki przyk\u0142ad u\u017cycia filtra do usuni\u0119cia wszystkich blok\u00f3w z wyj\u0105tkiem akapitu. Dotyczy to wszystkich typ\u00f3w post\u00f3w.<\/p>\n
add_filter('allowed_block_types', function($block_types, $post) {\n return ['core\/paragraph'];\n}, 10, 2);<\/code><\/pre>\nJe\u015bli dodasz ten kod do functions.php<\/code>pliku motywu lub wtyczki, rezultatem b\u0119dzie ca\u0142kowite zabronienie Gutenbergowi jakichkolwiek innych blok\u00f3w ni\u017c akapit. Nie b\u0119dziesz nawet w stanie zobaczy\u0107 \u017cadnych innych blok\u00f3w, nie mo\u017cesz te\u017c spr\u00f3bowa\u0107 ich zwabi\u0107, wpisuj\u0105c \u201e \/<\/code>” w po\u015bcie (skr\u00f3t bloku) lub je wyszukuj\u0105c.<\/p>\n<\/p>\nMo\u017cemy zdefiniowa\u0107 bloki, kt\u00f3re chcemy zachowa\u0107 lub usun\u0105\u0107 wed\u0142ug typu posta. Po prostu sprawdzamy w\u0142a\u015bciwo\u015b\u0107 post_type<\/code>obiektu pocztowego. W poni\u017cszym przyk\u0142adzie kodu definiujemy now\u0105 tablic\u0119 blok\u00f3w, na kt\u00f3re chcemy zezwoli\u0107 i dodajemy t\u0119 regu\u0142\u0119 tylko dla niestandardowego typu postu \u201e book<\/code>„.<\/p>\nadd_filter('allowed_block_types', function($block_types, $post) {\n $allowed = [\n 'core\/paragraph',\n 'core\/heading',\n 'core\/image'\n ];\n if ($post->post_type == 'book') {\n return $allowed;\n }\n return $block_types;\n}, 10, 2);<\/code><\/pre>\nZa pomoc\u0105 powy\u017cszego kodu otrzymujesz wszystkie bloki podczas edycji post\u00f3w i stron, ale podczas edycji niestandardowego postu typu \u201e book<\/code>„, mo\u017cesz dodawa\u0107 tylko akapity, nag\u0142\u00f3wki i pojedyncze obrazy.<\/p>\nU\u017cyj swojej wyobra\u017ani, aby doda\u0107 w\u0142asne zasady. Poniewa\u017c mamy obiekt post, mo\u017cemy uzyska\u0107 dost\u0119p do wi\u0119kszo\u015bci potrzebnych informacji. By\u0107 mo\u017ce musisz ograniczy\u0107 wyb\u00f3r blok\u00f3w za pomoc\u0105 warto\u015bci meta postu? Na przyk\u0142ad przez wybrany szablon strony, wybran\u0105 kategori\u0119 post\u00f3w lub co\u015b innego.<\/p>\n
Bia\u0142a lista<\/h3>\n
O ile widz\u0119, mo\u017cesz tylko umie\u015bci\u0107 na bia\u0142ej li\u015bcie (zdecydowa\u0107, kt\u00f3re z nich usun\u0105\u0107, w przeciwie\u0144stwie do tego, kt\u00f3ry zachowa\u0107) bloki, wyrejestrowuj\u0105c je w pewnym momencie. I musisz to zrobi\u0107 za pomoc\u0105 JavaScript, a nie PHP.<\/p>\n
Nie b\u0119d\u0119 wchodzi\u0107 w szczeg\u00f3\u0142y, ale b\u0119dziesz musia\u0142 umie\u015bci\u0107 w kolejce plik JavaScript za\u0142adowany init<\/code>lub enqueue_block_editor_assets<\/code>przechwycony, z zale\u017cno\u015bci\u0105 wp-dom-ready<\/code>i jako. wp-blocks<\/code>Wewn\u0105trz skryptu mo\u017cesz ustawi\u0107 zmienn\u0105 dla tych, kt\u00f3re chcesz usun\u0105\u0107, przestrzegaj\u0105c tych samych zasad dla przestrzeni nazw i nazw blok\u00f3w powy\u017cej. I dla ka\u017cdej nazwy bloku wywo\u0142ujesz funkcj\u0119 unregisterBlockType()<\/code>z wp.blocks<\/code>pakietu. Zwykle trzeba to zrobi\u0107 wewn\u0105trz funkcji, wp.domReady()<\/code>aby upewni\u0107 si\u0119, \u017ce kolejno\u015b\u0107 \u0142adowania skryptu jest poprawna.<\/p>\nCo\u015b takiego:<\/p>\n
var removeBlocks = [\n 'core\/paragraph',\n 'core\/heading',\n 'core\/image'\n];\n\u00a0\nwp.domReady(function() {\n removeBlocks.forEach(function(blockName) {\n wp.blocks.unregisterBlockType(blockName);\n });\n});<\/code><\/pre>\nUsuwanie typ\u00f3w blok\u00f3w to jeden ze sposob\u00f3w kontrolowania blok\u00f3w w Gutenbergu. Sp\u00f3jrzmy na inny, by\u0107 mo\u017ce fajniejszy spos\u00f3b kontrolowania blok\u00f3w: szablony blok\u00f3w.<\/p>\n
Szablony blokowe<\/h2>\n
Innym sposobem kontrolowania blok\u00f3w Gutenberga w WordPressie jest u\u017cycie szablon\u00f3w blok\u00f3w. WordPress posiada funkcjonalno\u015b\u0107, kt\u00f3ra pozwala na zape\u0142nianie nowych post\u00f3w zestawem predefiniowanych blok\u00f3w. Mo\u017ce to by\u0107 przydatne, aby pom\u00f3c autorom, pokazuj\u0105c im sugesti\u0119 struktury bloku. Mo\u017cesz tak\u017ce zablokowa\u0107 te wst\u0119pnie wype\u0142nione bloki, nie pozwalaj\u0105c autorom na zmian\u0119 kolejno\u015bci lub dodawanie innych blok\u00f3w. Jest to przydatne, gdy chcesz, aby posty mia\u0142y okre\u015blon\u0105 struktur\u0119 i projekt \u2013 na przyk\u0142ad upewniaj\u0105c si\u0119, \u017ce wszystkie posty tego typu maj\u0105 informacje o takiej samej strukturze.<\/p>\n
Mo\u017cemy doda\u0107 szablony blok\u00f3w z nowym parametrem do [register_post_type](https:\/\/developer.wordpress.org\/reference\/functions\/register_post_type\/)()<\/code>funkcji s\u0142u\u017c\u0105cej do rejestrowania niestandardowych typ\u00f3w post\u00f3w (uwaga: nowy parametr nie zosta\u0142 jeszcze dodany do dokumentacji). Mo\u017cesz tak\u017ce doda\u0107 lub dostosowa\u0107 parametry istniej\u0105cych typ\u00f3w post\u00f3w, takich jak posty i strony \u2013 zobacz poni\u017cej, jak to zrobi\u0107.<\/p>\nNowy parametr register_post_type()<\/code>to \u201e template<\/code>„. Jako warto\u015b\u0107 \u201e template<\/code>” musisz poda\u0107 tablic\u0119 blok\u00f3w. Ka\u017cdy blok r\u00f3wnie\u017c musi by\u0107 tablic\u0105. Jako minimum musisz poda\u0107 pierwszy element tablicy; nazw\u0119 bloku (np core\/paragraph<\/code>. ). Mo\u017cesz opcjonalnie doda\u0107 drugi element tablicy dla atrybut\u00f3w i trzeci element tablicy dla zagnie\u017cd\u017conych blok\u00f3w (np. Bloki ok\u0142adki, kolumny). Gdy zobaczysz kod, stanie si\u0119 to bardziej zrozumia\u0142e.<\/p>\nZacznijmy od prostych. Za\u0142\u00f3\u017cmy, \u017ce mamy register_post_type()<\/code>wywo\u0142anie funkcji do zarejestrowania niestandardowego typu posta \u201e book<\/code>„. Chcemy wype\u0142ni\u0107 wszystkie nowe posty tego typu postem blokiem akapitu z symbolem zast\u0119pczym informuj\u0105cym autora, co powinien napisa\u0107.<\/p>\nadd_action('init', function() {\n register_post_type('book', [\n 'label' => __('Books', 'txtdomain'),\n 'public' => true,\n ...\n 'template' => [\n ['core\/paragraph', ['placeholder' => __('Write your intro here...', 'txtdomain')]],\n ],\n ]);\n});<\/code><\/pre>\nZwr\u00f3\u0107 uwag\u0119, \u017ce tablica atrybut\u00f3w (zawieraj\u0105ca symbol zast\u0119pczy) jest opcjonalna. Teraz, z tym parametrem \u201eszablon” za ka\u017cdym razem, gdy tworzymy nowe posty, zostanie on utworzony z blokiem akapitu, kt\u00f3ry zawiera symbol zast\u0119pczy \u201eTutaj napisz intro\u2026”.<\/p>\n
Sp\u00f3jrzmy na bardziej skomplikowany przyk\u0142ad: zagnie\u017cd\u017cone bloki. Powiedzmy, \u017ce chcemy doda\u0107 blok ok\u0142adki, kt\u00f3ry ma blok nag\u0142\u00f3wka, akapit i przycisk w \u015brodku, wyr\u00f3wnane do \u015brodka. Tytu\u0142 i akapit b\u0119d\u0105 mia\u0142y symbol zast\u0119pczy:<\/p>\n
'template' => [\n ['core\/cover', ['align' => 'full', 'overlayColor' => 'blue-profile'], [\n ['core\/heading', ['align' => 'center', 'placeholder' => __('Call to action title', 'txtdomain')]],\n ['core\/paragraph', ['align' => 'center', 'placeholder' => __('Your text here', 'txtdomain')]],\n ['core\/button', ['align' => 'center']]\n ]],\n],<\/code><\/pre>\nPoni\u017cszy obrazek pokazuje, co otrzymamy, tworz\u0105c nowe posty ksi\u0105\u017ckowe. Wygl\u0105da mniej onie\u015bmielaj\u0105co ni\u017c puste p\u0142\u00f3tno, prawda?<\/p>\n
![\"Jak](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152040-61e4d330dc012.png\")
<\/a><\/p>\nPami\u0119taj, \u017ce atrybuty s\u0105 r\u00f3\u017cne w ka\u017cdym typie bloku i mog\u0105 r\u00f3wnie\u017c r\u00f3\u017cni\u0107 si\u0119 w twojej konfiguracji. W powy\u017cszym przyk\u0142adzie kodu dodaj\u0119 dwa atrybuty do bloku Cover; wyr\u00f3wnanie bloku do \u201ePe\u0142nej szeroko\u015bci” i na\u0142o\u017cenie koloru na predefiniowany kolor z niestandardowej palety kolor\u00f3w.<\/p>\n
![\"Jak](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152040-61e4d33596f0b.gif\")
<\/a><\/p>\n