Введение
Blockstudio позволяет создавать пользовательские блоки WordPress, используя только PHP и формат WordPress block.json. Это значительно упрощает разработку: регистрацию блоков, отложенную загрузку ресурсов и пользовательские поля.
Философия
Ориентация на ядро
В основе нет никаких секретов. Blockstudio построен на стандартных возможностях WordPress и компонентах Gutenberg. Это легкий абстрактный слой, который помогает быстро приступить к созданию пользовательских блоков.
Сначала серверная часть
WordPress позволяет регистрировать простые блоки, используя только PHP: начиная с версии WordPress 7.0,
register_block_type() с поддержкой autoRegister
отображает блок через его render_callback и создает основные элементы управления инспектора для строковых, целочисленных, логических атрибутов и атрибутов-перечислений. Этого достаточно именно для таких случаев, и в документации ядра прямо указано, что такой подход не предназначен для замены клиентской модели: здесь нет вложенных блоков, форматированного текста, полей медиафайлов и интерактивности. Поэтому для чего-либо сложнее нескольких простых элементов управления по-прежнему нужно писать JavaScript, запускать сборку и дублировать логику между PHP и JS.
Blockstudio развивает ту же идею и применяет ее повсюду. Используйте PHP
для шаблонов блоков и добавляйте интерактивность, например <RichText />
или <InnerBlocks />, с помощью тегов в стиле JSX. В редакторе эти теги
заменяются соответствующими элементами React. На внешнем интерфейсе теги
заменяются содержимым HTML.
Так вы получаете лучшее из обоих подходов: блок с серверной отрисовкой и отличной интерактивностью в редакторе.
На основе файловой системы
Хотя WordPress поддерживает файловый подход с использованием строкового типа
WPDefinedPath,
ресурсы или шаблоны можно подключать и из других источников. Blockstudio делает файловую систему единственным основным способом регистрации блоков. Это решение принято не для того, чтобы ограничить возможности, а чтобы задать структуру блока, которую нельзя оспорить. Например, если файл style.css или script.js находится в той же папке, что и block.json,
можно быть уверенным, что он относится только к этому конкретному блоку.
Без настройки
Blockstudio просто работает. Он упрощает создание пользовательских блоков и не мешает работе. Хотите использовать Twig в шаблоне? Просто измените расширение файла. Нужно добавить CSS? Создайте файл style.css. Blockstudio автоматически добавит его в очередь, когда блок используется на странице, в том числе вне post_content через функцию отрисовки.
Есть пожелания или вопросы? Напишите нам.