Към съдържанието

Ресурси

Blockstudio предоставя конвейер за ресурси без конфигурация за блоковете ви. Поставете файлове CSS, SCSS или JavaScript до блока си и те ще бъдат компилирани, минимизирани и автоматично добавени в опашката.

Проверка на ресурсите на блок

bs_block_assets('theme/card') връща откритите ресурси за фронтенда и платното на редактора на регистриран блок Blockstudio. Извикайте го след регистрацията на блока, на init или по-нова версия. За непознати блокове, блокове, които не са Blockstudio, и блокове без ресурси се връща []. Помощната функция не визуализира блока, не добавя нищо към опашката и не задейства компилация.

PHP
$assets = bs_block_assets('theme/card');

// Each entry has this shape:
[
  'type' => 'style',
  'handle' => 'blockstudio-theme-card-style-css',
  'url' => '/wp-content/blockstudio/cache/.../style-123.css?ver=123',
  'inline' => false,
  'scope' => ['frontend', 'editor'],
  'html' => '<link ...>',
];
  • type е style за CSS и module за JavaScript. Файловите ресурси на Blockstudio, базирани на JavaScript, използват ES модули, включително за вградени скриптове.
  • handle е стабилният идентификатор на ресурс, използван от визуализатора на Blockstudio и филтъра blockstudio/assets/disable. Не е необходимо да се добавя към опашката в WordPress.
  • url е разрешеният URL на съществуващия компилиран ресурс, включително версията му, или изходният URL, когато няма компилиран файл. За вградени ресурси е null.
  • inline различава вградения изход <style>/<script> от външните файлове.
  • scope изброява контекстите, в които се прилага ресурсът: frontend и editor за споделени файлове, а само един за файловете за изглед/редактор.
  • html съдържа готовия за употреба таг от обичайния визуализатор на ресурси. Вграденото съдържание, обхванатият CSS, стиловите слоеве UI и филтрите за изключване при визуализиране се обработват по същия начин като обичайния изход на блок.

Липсващи, празни, деактивирани и некомпилирани файлове SCSS се пропускат. Изключват се административните ресурси и ресурсите на родителския документ в редактора на блокове, добавени в опашката от WordPress. Списъкът е ограничен до собствените открити файлове на блока. Той не включва всички зависимости: вложените блокове, стойностите на полетата за код, манипулаторите, добавени в опашката от WordPress, импортираните модули CSS, Tailwind и споделените среди за изпълнение UI/Interactivity може да зависят от визуализираното съдържание. Използвайте предварителен преглед, който е напълно самостоятеленRender::document(). Използвайте bs_block_fields(), за да проверите регистрираните дефиниции на полетата.