Налаштування
Blockstudio має потужний механізм налаштувань API, який дає змогу задавати параметри через файл blockstudio.json у папці теми та/або за допомогою фільтрів. Крім того, користувачі з відповідними правами можуть змінювати налаштування через інтерфейс в адміністративній панелі.
Через JSON
Якщо файл blockstudio.json є у папці теми, його буде використано для налаштування параметрів сайту за замовчуванням. Доступна схема JSON, яка перевіряє файл і забезпечує автодоповнення в IDE.
Цей файл необов’язковий. Якщо його немає, Blockstudio використовує налаштування, збережені в адміністративній панелі, а також вбудовані значення за замовчуванням. Додавання, зміни чи видалення файлу визначаються автоматично, тож очищати кеш або перезавантажувати вручну не потрібно.
Доступні такі властивості:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"users": {
"ids": [],
"roles": []
},
"assets": {
"enqueue": true,
"reset": {
"enabled": false,
"fullWidth": []
},
"minify": {
"css": false,
"js": false
},
"process": {
"scss": false
}
},
"cache": {
"enabled": true,
"path": "blockstudio/cache"
},
"themeDefaults": {
"titleTag": false,
"suppressDirectoryUpdates": false
},
"performance": {
"profile": "compat",
"wordpress": {
"headNoise": false,
"embeds": false,
"xmlrpc": false,
"editor": false,
"frontendAssets": false,
"media": false,
"heartbeat": false
},
"preload": {
"links": "off"
},
"media": {
"lazy": false,
"skeleton": false,
"metadata": false,
"rootMargin": "300px"
},
"measurement": {
"enabled": false,
"queryMonitor": false,
"headers": false,
"timings": false
}
},
"content": {
"enabled": false,
"id": "default",
"path": "content",
"includePageSyncManaged": false,
"authors": "ignore",
"postTypes": [],
"meta": {
"include": [],
"exclude": ["_edit_lock", "_edit_last", "_wp_old_slug"],
"references": {}
},
"taxonomies": [],
"media": "manifest"
},
"editor": {
"formatOnSave": false,
"assets": [],
"markup": false
},
"tailwind": {
"enabled": false,
"config": "",
"output": "inline"
},
"blockTags": {
"enabled": false,
"allow": [],
"deny": [],
"prefixes": {}
},
"ui": {
"enabled": false
},
"blockEditor": {
"disableLoading": false,
"enhance": false,
"cssClasses": [],
"cssVariables": [],
"blocks": {
"allow": [],
"deny": [],
"directory": true,
"categories": {
"allow": [],
"deny": [],
"rename": {},
"order": []
},
"styles": {
"deny": {}
},
"legacyWidgets": {
"hide": []
}
},
"patterns": {
"core": true,
"remote": true,
"theme": true,
"blockstudio": true,
"categories": {
"allow": [],
"deny": [],
"rename": {},
"order": []
}
},
"media": {
"openverse": true,
"imageSizes": {
"allow": [],
"deny": []
}
}
},
"dev": {
"grab": {
"enabled": false
},
"perf": false,
"canvas": {
"enabled": false,
"adminBar": true
}
},
"githooks": {
"commit": false
},
"phpstan": {
"preset": "base",
"configuration": "",
"roots": ["."],
"excludePaths": [],
"maxFiles": 10000
},
"ai": {
"enableContextGeneration": false
}
}
Через фільтри
Також можна скористатися фільтром blockstudio/settings/${setting}, щоб задавати параметри через PHP і отримати більше гнучкості.
add_filter('blockstudio/settings/assets/enqueue', '__return_false');
add_filter('blockstudio/settings/editor/formatOnSave', '__return_true');
add_filter('blockstudio/settings/ui/enabled', '__return_true');
add_filter('blockstudio/settings/block_editor/patterns/remote', '__return_false');
Параметри, задані фільтром blockstudio/settings/${setting}, перевизначають параметри з файлу blockstudio.json. Можна використовувати обидва способи одночасно.
Фільтри значень під час виконання також відкривають blockstudio/performance/${setting}, а наприкінці — ще один фільтр blockstudio/performance/config. Останній має повертати коректний об’єкт конфігурації.
Як об’єднуються джерела
Кожне джерело завантажується й об’єднується; джерела з нижчим пріоритетом обробляються першими:
- Вбудовані значення за замовчуванням
- Налаштування, збережені через адміністративну панель UI (параметр
blockstudio_settings) blockstudio.jsonу темі- Фільтри
blockstudio/settings/*
blockstudio.json перевизначає лише оголошені в ньому ключі. Раніше він повністю замінював збережені налаштування, тож після появи файлу переставало застосовуватися будь-яке не пов’язане з ним значення, збережене в адміністративній панелі; тепер файл доповнює ці налаштування. Водночас старе значення, збережене через адміністративну панель UI, продовжує діяти, доки файл не оголосить цей ключ або збережене значення не буде видалено. Якщо параметр поводиться не так, як зазначено у файлі, перевірте збережений рівень за допомогою wp bs settings або Settings::get_raw(): вони повертають лише те, що було явно оголошено активним джерелом JSON або джерелом параметрів.
Читання налаштувань із PHP
Blockstudio\Settings завантажує активне джерело, повідомляє про некоректний JSON і автоматично перезавантажується, коли змінюється blockstudio.json:
use Blockstudio\Settings;
$enabled = Settings::get_bool('performance/media/lazy');
$margin = Settings::get_string('performance/media/rootMargin', '300px');
$roles = Settings::get_array('users/roles');
$ttl = Settings::get_int('performance/staticPrerender/ttl', 86400);
foreach (Settings::errors() as $error) {
error_log($error);
}
Використовуйте Settings::get_raw(), якщо інтеграції потрібні лише значення, явно оголошені активним джерелом JSON або параметрів. Settings::fingerprint() повертає детермінований ідентифікатор ефективних налаштувань. У довготривалих процесах можна явно викликати Settings::reload(), щоб негайно врахувати зміну файлу. Під час звичайного доступу файл перевіряється не частіше ніж раз на секунду в межах запиту або довготривалого процесу PHP, зокрема після змін розміру файлу. Зміна налаштованого шляху набирає чинності під час наступного читання. Якщо файл JSON неактивний, збережені в базі даних налаштування не затримуються через це вікно.
Розв’язаний профіль продуктивності доступний через Blockstudio\Runtime_Settings::current(). Підтримуються шляхи зі слешами або крапками:
use Blockstudio\Runtime_Settings;
$runtime = Runtime_Settings::current();
if ($runtime->enabled('measurement/queryMonitor')) {
$hash = $runtime->hash();
}
Доступні налаштування
users
| Параметр | Тип | За замовчуванням | Опис |
|---|---|---|---|
ids |
масив | [] |
ID користувачів із доступом до редактора |
roles |
масив | [] |
Ролі користувачів із доступом до редактора |
assets
| Параметр | Тип | За замовчуванням | Опис |
|---|---|---|---|
enqueue |
boolean | true |
Автоматично додавати ресурси блоків до черги |
reset.enabled |
boolean | false |
Видалити стилі основних блоків і застосувати скидання утиліт редактора |
reset.fullWidth |
array | [] |
Типи дописів із повноширинним макетом редактора |
minify.css |
boolean | false |
Мінімізувати вихідні дані CSS |
minify.js |
boolean | false |
Мінімізувати вихідні дані JS |
process.scss |
boolean | false |
Обробляти файли SCSS |
output |
string | source |
Шлях для запису скомпільованих ресурсів: source або cache |
inlineLimit |
integer | 0 |
Кількість байтів зовнішнього CSS блока, що виводяться вбудовано на сторінці |
output за замовчуванням дорівнює source, що створює каталог _dist поруч із кожним блоком. Задайте cache, щоб натомість зберігати скомпільовані ресурси в каталозі кешу Blockstudio і зберегти дерево вихідних файлів блоків чистим та придатним до розгортання з незмінного робочого дерева. Джерела Blockstudio, які не можуть записувати файли, завжди перенаправляють їх до кешу незалежно від цього параметра.
inlineLimit вимкнено на значенні 0, тому кожна зовнішня таблиця стилів зберігає свій тег <link>. Укажіть кількість байтів, щоб натомість вбудовувати найменші зовнішні таблиці стилів блоків на сторінці, якщо їхній загальний розмір не перевищує це число. 40000 — це ліміт, який ядро WordPress використовує для того самого правила. Див. Вбудовування малих таблиць стилів.
Коли активне reset.enabled, Blockstudio також копіює очищені значення фронтенду body_class у полотно редактора. Скористайтеся blockstudio/editor/canvas/body_class, щоб налаштувати список класів лише для редактора.
cache
| Параметр | Тип | За замовчуванням | Опис |
|---|---|---|---|
enabled |
логічне значення | true |
Увімкнути кеші Blockstudio на основі файлів |
path |
рядок | "blockstudio/cache" |
Шлях до кешу, відносний до WP_CONTENT_DIR або абсолютний |
namespaceGrace |
ціле число | 86400 |
Кількість секунд зберігання виведеного з ужитку простору імен кешу перед очищенням |
За замовчуванням файли кешу записуються в wp-content/blockstudio/cache, поза каталогом завантажень. Відносний шлях path визначається від WP_CONTENT_DIR; абсолютний шлях використовується без змін. Це дає змогу працювати на хостах, які надають окремий том кешу з правом запису.
Якщо ввімкнено, Blockstudio використовує цей єдиний кореневий каталог для даних збирання, попередньо зібраних даних реєстрації блоків, розв’язаних ресурсів редактора, Tailwind CSS, документів рендерингу, фрагментів островів, статичних попередніх рендерингів, індексів графів, черг і діагностики. Кожен об’єкт ізольовано за мережею, сайтом, повною ідентичністю середовища виконання та областю дії. Ідентичності середовища виконання охоплюють Blockstudio, налаштування, WordPress, PHP, активну тему, активні плагіни, логічні джерела пошуку, контекст хоста та явні хеші залежностей, надані операцією-власником.
Зміни вмісту, термінів, користувачів і метаданих роблять неактуальним кешований вибір полів, але не структурне виявлення блоків чи скомпільовані ресурси. Варіанти оновлюються окремо, із фіксованим блокуванням шляху збірки. Серія записів, наприклад синхронізація перекладів або імпорт, об’єднується: перший запис після періоду бездіяльності одразу запускає оновлення, а останній запис серії враховується, щойно мине тридцять секунд; цей інтервал можна змінити за допомогою blockstudio/cache/populate_debounce. Метадані, які WordPress записує для службових цілей, наприклад блокування редагування запису, не вважаються зміною; blockstudio/cache/populate_ignored_meta_keys доповнює цей список. Редактор завжди запитує актуальні параметри, тож це вікно впливає лише на кешовані варіанти, які зчитуються під час рендерингу. Зміни у вихідних файлах і налаштуваннях збірки, як і раніше, роблять структурний кеш неактуальним. Перезапис варіантів не призводить до повторного сканування каталогу кешу після кожної зміни вмісту; періодичне очищення все одно видаляє осиротілі тимчасові файли. Ідентифікатори середовища виконання для різних мов залишаються ізольованими; кілька каталогів просторів імен кешу на багатомовному сайті самі по собі не свідчать про промах кешу.
Журнальна активність SQLite у каталозі даних db блока не скидає кешовані метадані блока. Зміни в db.php, відстежуваних вихідних файлах або структурі вихідних файлів і підкаталогів каталогу даних усе одно роблять кеш неактуальним.
Під час паралельного перебудування середовища виконання обирається один виконавець. Інші запити чекають до п’яти секунд, а потім повторно використовують останні справні метадані блоків, якщо їхні вихідні файли та потрібні скомпільовані ресурси досі існують. Запит без кешу, для якого немає безпечних даних, повертає HTTP 503 із Retry-After замість запуску ще одного збирання. Фільтр blockstudio/cache/build_wait_budget задає час очікування в мілісекундах як для структурних перебудов, так і для оновлення варіантів. На хостах без консультативного блокування файлів варіанти оновлюються без блокування та все одно публікуються, тож наступний запит знаходить їх у кеші.
Файли .build.lock для окремих ключів, залишені попередніми версіями та неактивні, очищуються в усіх просторах імен кешу цього сайту за допомогою WP-Cron. Очищення починається через п’ять хвилин після оновлення та видаляє до 10,000 блокувань за хвилину в межах десятисекундного ліміту. wp bs cache status повідомляє про кількість файлів, що залишилися, а wp bs cache cleanup негайно очищує чергу; wp bs cache clear очищує кеш середовища виконання. Якщо запланований пакет прострочено більш ніж на десять хвилин, бо cron не спрацьовує, запити раз на годину очищують обмежену кількість блокувань, щоб процес не зупинився. Нещодавні блокування та ті, що ще утримуються, не чіпають; нові блокування з фіксованим шляхом ніколи не очищуються. Після очищення черги той самий пакет видаляє покинуті простори імен кешу, коли мине їхній namespaceGrace; це відбувається не частіше ніж раз на годину для кожного сайту, а щоденний запуск продовжує виконуватися. Пільговий період відраховується від першого сканування, під час якого простір імен визначено як застарілий, а не від часу створення його останнього файлу. Простір імен, актуальний принаймні для однієї з областей дії, ніколи не очищується.
Внутрішнє очищення кешу не запускає фільтри видалення вкладень WordPress. На хостах із вимкненим WP-Cron потрібно й далі запускати звичайний запланований обробник cron; не видаляйте всі активні файли блокувань без розбору, щоб очистити чергу.
Фільтр параметра blockstudio/settings/cache/path змінює налаштоване значення. Щоб розв’язати шлях залежно від середовища розгортання, фільтр blockstudio/cache/dir змінює визначений базовий каталог:
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
Хости, ідентифікатор клієнта яких відрізняється від ID мережі/блогу WordPress, можуть фільтрувати blockstudio/cache/site_key. Результат очищується й використовується лише як сегмент каталогу. Для серіалізованого варіанта середовища виконання, який має змінювати ідентичності об’єктів, слід використовувати blockstudio/cache/context.
themeDefaults
| Параметр | Тип | За замовчуванням | Опис |
|---|---|---|---|
titleTag |
логічне значення | false |
Увімкнути підтримку тегу заголовка темою WordPress |
suppressDirectoryUpdates |
логічне значення | false |
Вилучити активні дочірні та батьківські теми з результатів оновлення каталогу |
Шаблони й надалі використовують наявний Blockstudio\Patterns API; ці значення за замовчуванням не додають альтернативних фасадів сторінок чи шаблонів.
performance
Профіль compat не змінює загальну поведінку WordPress. speed і strict вмикають однакові додаткові параметри фронтенду; кожен дочірній параметр може перевизначити значення профілю.
Додаткові параметри є умовами реєстрації. Коли необов’язкову функцію false, Blockstudio не підключає пов’язані з нею фронтендні, адміністративні, редакторські, REST чи заплановані зворотні виклики. Якщо після використання Early Serve або запланованого прогрівання вимкнути цю функцію, належні їй дані очищуються один раз; наступні запити не виконують жодних дій.
| Параметр | Тип | Типове значення сумісності | Типове значення швидкості/суворого режиму | Опис |
|---|---|---|---|---|
profile |
рядок | "compat" |
Не застосовується | compat, speed або strict |
wordpress.headNoise |
логічне | false |
true |
Видалити загальне виявлення в head і виведення емодзі |
wordpress.embeds |
логічне | false |
true |
Видалити виявлення oEmbed і скрипти хоста |
wordpress.xmlrpc |
логічне | false |
true |
Вимкнути XML-RPC і pingback-запити |
wordpress.editor |
логічне | false |
true |
Вимкнути віддалені засоби виявлення редактора |
wordpress.frontendAssets |
логічне | false |
true |
Видалити загальні ресурси ядра для фронтенду |
wordpress.media |
логічне | false |
true |
Застосувати типові параметри виведення зображень |
wordpress.heartbeat |
логічне | false |
true |
Обмежити частоту Heartbeat поза редакторами |
preload.links |
рядок | "off" |
"intent" |
Попередньо завантажувати документи того самого джерела після дії користувача |
media.lazy |
логічне | false |
true |
Використовувати завантажувач зображень Blockstudio |
media.skeleton |
логічне | false |
true |
Показувати вбудований скелетон завантаження |
media.metadata |
логічне | false |
true |
Оголосити використання assets/media.json |
media.rootMargin |
рядок | "300px" |
"300px" |
Відступ перетину для відкладеного завантажувача |
measurement.enabled |
логічне | false |
false |
Увімкнути API вимірювання під час виконання |
measurement.queryMonitor |
логічне | false |
false |
Включати запити тривалістю щонайменше 50ms |
measurement.headers |
логічне | false |
false |
Надсилати заголовки хешу профілю та конфігурації |
measurement.timings |
логічне | false |
false |
Надсилати заголовок часу виконання |
staticPrerender.enabled |
логічне | false |
false |
Увімкнути кешування HTML, безпечне для анонімних користувачів |
staticPrerender.ttl |
ціле число | 86400 |
86400 |
Максимальний вік документа в кеші, у секундах |
staticPrerender.invalidate |
рядок | "signature" |
"signature" |
Використовувати ідентифікатор signature або інкрементний graph |
staticPrerender.earlyServe |
логічне | false |
false |
Віддавати безпечні збіги до запуску WordPress |
staticPrerender.serveLoggedIn |
логічне | false |
false |
Дозволити користувачам отримувати збіги з кешу, але не створювати їх |
staticPrerender.dynamicPaths |
масив | [] |
[] |
Префікси шляхів, які мають залишатися динамічними |
staticPrerender.replayHeaders |
масив | ["Link"] |
["Link"] |
Заголовки відповіді, що зберігаються та надсилаються під час збігів із кешем |
staticPrerender.warm.enabled |
логічне | false |
false |
Увімкнути надійну заплановану чергу прогрівання |
staticPrerender.warm.interval |
ціле число | 3600 |
3600 |
Інтервал прогрівання в секундах |
staticPrerender.warm.concurrency |
ціле число | 2 |
2 |
Максимальна кількість завдань, оброблюваних за один цикл прогрівання |
staticPrerender.warm.transport |
рядок | "http" |
"http" |
Використовувати http або наданий хостом засіб рендерингу internal |
Статичне попереднє рендерення залишається вимкненим, якщо його явно не ввімкнути. Якщо головний перемикач вимкнено, хуки запитів попереднього рендерення не реєструються, а вимкнені перемикачі earlyServe і warm.enabled не реєструють адміністративні хуки або хуки cron. У режимі підпису для звичайних запитів використовується недорогий активований ідентифікатор. Режим графа призначений для явних збірок: він записує залежності вихідних даних для кожної сторінки, тому зміна однієї сторінки не призводить до інвалідації не пов’язаних із нею документів. Докладніше про прогрівання, розгортання, раннє обслуговування та безпеку див. у розділі Статичне попереднє рендерення.
Вимірювання доступні програмно:
use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();
Якщо заголовки ввімкнено, Blockstudio надсилає
X-Blockstudio-Performance-Profile,
X-Blockstudio-Performance-Config і, за потреби,
X-Blockstudio-Performance-Time. Дія
blockstudio/performance/measurement_enabled отримує визначені параметри середовища виконання.
Параметри media керують bs_media_image(), маніфестом assets/media.json і відкладеним завантажувачем фронтенду. Докладніше про помічник, генератор маніфесту та поведінку завантажувача див. у розділі Медіа.
content
| Параметр | Тип | Значення за замовчуванням | Опис |
|---|---|---|---|
enabled |
boolean | false |
Увімкнути конфігурацію синхронізації вмісту |
id |
string | "default" |
Простір імен набору вмісту, що зберігається в синхронізованих сутностях |
path |
string | "content" |
Каталог файлів вмісту відносно теми |
includePageSyncManaged |
boolean | false |
Включати записи, керовані Page Sync, не отримуючи права власності на їхній вміст |
authors |
string | "ignore" |
Обробка авторів (ignore або login наявного користувача) |
postTypes |
array | [] |
Дозволені типи записів |
meta.include |
array | [] |
Шаблони Glob для метаключів, які потрібно синхронізувати |
meta.exclude |
array | ["_edit_lock", "_edit_last", "_wp_old_slug"] |
Шаблони Glob для метаключів, які потрібно виключити |
meta.references |
object | {} |
Оголошені посилання на метадані, що переписуються між ID та UID |
taxonomies |
array | [] |
Дозволені зареєстровані таксономії для термінів і зв’язків |
media |
string | "manifest" |
Поведінка посилань на вкладення (manifest або none) |
Синхронізація вмісту керується через wp bs content і експортує дозволені записи, postmeta та оголошені посилання у переносні файли. Докладніше про робочий процес і формат файлів див. у розділі Синхронізація вмісту.
editor
| Параметр | Тип | Значення за замовчуванням | Опис |
|---|---|---|---|
formatOnSave |
boolean | false |
Форматувати block.json під час збереження |
assets |
array | [] |
Додаткові ресурси для завантаження в редакторі |
markup |
boolean | false |
Увімкнути редагування розмітки |
tailwind
| Параметр | Тип | Значення за замовчуванням | Опис |
|---|---|---|---|
enabled |
boolean | false |
Увімкнути компіляцію Tailwind CSS |
config |
string | "" |
Конфігурація Tailwind v4, орієнтована на CSS |
Про поведінку компіляції та формат конфігурації, орієнтованої на CSS, див. у розділі Tailwind CSS.
blockTags
| Параметр | Тип | Значення за замовчуванням | Опис |
|---|---|---|---|
enabled |
boolean | false |
Увімкнути рендеринг тегів bs: на рівні сторінки у вмісті записів і областях віджетів |
allow |
array | [] |
Список дозволених шаблонів назв блоків; підтримує підстановні символи fnmatch() |
deny |
array | [] |
Список заборонених шаблонів назв блоків; має пріоритет над allow |
prefixes |
object | {} |
Префікс для простих імен у просторі імен; кожне значення є простором імен або впорядкованим масивом |
Рендеринг тегів на рівні шаблону завжди активний; ці параметри керують заміною на рівні сторінки. Синтаксис тегів і правила визначення див. у розділі Рендеринг.
ui
| Параметр | Тип | Значення за замовчуванням | Опис |
|---|---|---|---|
enabled |
boolean | false |
Зареєструвати вбудовані компоненти bsui/* UI і демонстраційні програми app/* |
blockEditor
| Параметр | Тип | Значення за замовчуванням | Опис |
|---|---|---|---|
disableLoading |
boolean | false |
Вимкнути завантаження блоків у редакторі |
enhance |
boolean | false |
Увімкнути засоби наведення курсора та вибору в редакторі Blockstudio |
cssClasses |
array | [] |
URL таблиць стилів, з яких отримувати класи CSS для автодоповнення в полі класів |
cssVariables |
array | [] |
URL таблиць стилів, з яких отримувати змінні CSS для автодоповнення в полі коду |
blockEditor.blocks
Використовуйте blockEditor.blocks для визначення політики вставлення блоків у всьому проєкті. allow і deny приймають назви блоків і шаблони з підстановними символами, як-от core/*.
{
"blockEditor": {
"blocks": {
"allow": ["core/*", "my-theme/*"],
"deny": ["core/embed", "core/freeform"],
"directory": false,
"categories": {
"rename": {
"text": "Writing",
"design": "Layout"
},
"order": ["my-theme", "text", "media"]
},
"legacyWidgets": {
"hide": ["archives", "calendar"]
}
}
}
}
blocks.styles.deny скасовує реєстрацію стилів, зареєстрованих через реєстр стилів блоків WordPress’
PHP:
{
"blockEditor": {
"blocks": {
"styles": {
"deny": {
"my-theme/card": ["outline"],
"my-theme/media": ["framed"]
}
}
}
}
}
blockEditor.patterns
Використовуйте blockEditor.patterns, щоб вимкнути глобальні джерела шаблонів і фільтрувати категорії шаблонів.
{
"blockEditor": {
"patterns": {
"core": false,
"remote": false,
"theme": true,
"blockstudio": true,
"categories": {
"deny": ["gallery"],
"rename": {
"featured": "Featured Layouts"
},
"order": ["featured", "buttons"]
}
}
}
}
blockEditor.media
Використовуйте blockEditor.media для визначення глобальної політики вставлення медіа.
{
"blockEditor": {
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"],
"deny": ["medium_large"]
}
}
}
}
dev
| Параметр | Тип | Значення за замовчуванням | Опис |
|---|---|---|---|
grab.enabled |
boolean | false |
Увімкнути засіб вибору елементів на фронтенді |
perf |
boolean | false |
Увімкнути профайлер продуктивності під час кожного завантаження сторінки |
canvas.enabled |
boolean | false |
Увімкнути полотно |
canvas.adminBar |
boolean | true |
Показувати панель адміністратора WordPress під час перегляду полотна |
githooks
| Параметр | Тип | Значення за замовчуванням | Опис |
|---|---|---|---|
commit |
boolean | false |
Створити хук pre-commit лише для аналізу під час запуску blockstudio-githooks sync |
Докладніше про те, що запускає створений хук і як він підтримує синхронність, див. у розділі керований хук коміту.
phpstan
| Параметр | Тип | Значення за замовчуванням | Опис |
|---|---|---|---|
preset |
string | "base" |
Попередньо встановлений режим аналізу, якщо його не вибрано в командному рядку: base, theme, extreme-theme або wordpress-render |
configuration |
string | "" |
Конфігурація проєкту PHPStan, що включається разом із попередньо встановленим режимом і визначається за blockstudio.json |
roots |
array | ["."] |
Кореневі каталоги тем, які аналізує канонічна команда |
excludePaths |
array | [] |
Додаткові виключення сканера відносно кожного налаштованого кореневого каталогу |
maxFiles |
integer | 10000 |
Максимальна кількість файлів, які перевіряє сканер тем |
blockTags |
object | {} |
Відповідності елементів, псевдоніми тегів і scanPhp для правила тегу блоку |
Ці параметри керують канонічною командою blockstudio-phpstan. Попередньо встановлені режими, рівні конфігурації та перехід див. у розділі PHPStan.
ai
| Параметр | Тип | Значення за замовчуванням | Опис |
|---|---|---|---|
enableContextGeneration |
boolean | false |
Створити об’єднаний файл контексту з блоками, параметрами, схемами та документацією для інструментів LLM |
Документацію та повний згенерований текст див. в індексі розділу Інтеграція зі штучним інтелектом.
Увімкніть і комбінуйте вбудовані безголові компоненти UI, представлені в Blockstudio 7.3.