Lewati ke konten

Pengaturan

Blockstudio menyertakan API pengaturan canggih yang memungkinkan Anda mengatur opsi melalui file blockstudio.json di dalam folder tema dan/atau melalui filter. Selain itu, pengguna yang diizinkan dapat mengubah pengaturan secara visual di area admin.

Melalui JSON

Jika file blockstudio.json tersedia di dalam folder tema, file tersebut akan digunakan untuk mengatur opsi default situs saat ini. Skema JSON tersedia untuk memvalidasi file dan membantu pelengkapan otomatis saat digunakan di IDE.

File ini bersifat opsional. Tanpanya, Blockstudio menggunakan pengaturan yang tersimpan di area admin, di atas nilai default bawaannya. Penambahan, perubahan, atau penghapusan file akan terdeteksi secara otomatis, jadi tidak perlu menghapus cache atau memuat ulang secara manual.

Properti berikut tersedia:

JSON
{
  "$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
  }
}

Melalui Filter

Sebagai alternatif, Anda dapat menggunakan filter blockstudio/settings/${setting} untuk mengatur opsi melalui PHP agar lebih fleksibel.

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');

Opsi yang diatur melalui filter blockstudio/settings/${setting} akan menggantikan opsi yang diatur melalui file blockstudio.json. Kedua metode dapat digunakan bersama.

Nilai runtime juga menyediakan filter blockstudio/performance/${setting} dan satu filter blockstudio/performance/config terakhir. Filter terakhir harus mengembalikan objek konfigurasi yang valid.

Urutan Lapisan Sumber

Setiap sumber dimuat dan digabungkan, dimulai dari prioritas terendah:

  1. Nilai default bawaan
  2. Pengaturan yang disimpan melalui UI admin (opsi blockstudio_settings)
  3. blockstudio.json di tema
  4. Filter blockstudio/settings/*

blockstudio.json hanya menggantikan kunci yang dideklarasikannya. Sebelumnya, pengaturan yang tersimpan akan diganti seluruhnya, sehingga nilai tersimpan dari admin yang tidak terkait berhenti diterapkan begitu file muncul; sekarang, nilai dalam file ditambahkan di atasnya. Sebaliknya, nilai lama yang disimpan melalui admin UI tetap diterapkan sampai file mendeklarasikan kunci tersebut atau nilai tersimpan itu dihapus. Jika suatu pengaturan berperilaku berbeda dari yang tercantum dalam file, periksa lapisan tersimpan dengan wp bs settings atau Settings::get_raw(), yang hanya mengembalikan nilai yang secara eksplisit dideklarasikan oleh sumber JSON atau opsi yang aktif.

Membaca pengaturan dari PHP

Blockstudio\Settings memuat sumber aktif, melaporkan JSON yang tidak valid, dan memuat ulang secara otomatis saat blockstudio.json berubah:

PHP
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);
}

Gunakan Settings::get_raw() jika integrasi hanya memerlukan nilai yang dinyatakan secara eksplisit oleh JSON aktif atau sumber opsi. Settings::fingerprint() mengembalikan identitas pengaturan efektif yang deterministik. Proses yang berjalan lama dapat memanggil Settings::reload() secara eksplisit untuk segera membaca perubahan file. Akses normal memeriksa file paling banyak sekali per detik dalam sebuah permintaan atau proses PHP yang berjalan lama, termasuk perubahan dengan ukuran yang sama. Perubahan jalur yang dikonfigurasi berlaku pada pembacaan berikutnya. Jika tidak ada file JSON yang aktif, pengaturan basis data tersimpan tidak tertunda oleh jeda ini.

Profil performa yang telah ditentukan tersedia melalui Blockstudio\Runtime_Settings::current(). Profil ini mendukung jalur dengan garis miring atau titik:

PHP
use Blockstudio\Runtime_Settings;

$runtime = Runtime_Settings::current();

if ($runtime->enabled('measurement/queryMonitor')) {
    $hash = $runtime->hash();
}

Pengaturan yang Tersedia

users

Opsi Jenis Default Deskripsi
ids array [] ID pengguna dengan akses editor
roles array [] Peran pengguna dengan akses editor

assets

Opsi Tipe Default Deskripsi
enqueue boolean true Otomatis antrekan aset blok
reset.enabled boolean false Hapus gaya blok inti dan terapkan reset utilitas editor
reset.fullWidth array [] Jenis pos yang menggunakan tata letak editor lebar penuh
minify.css boolean false Minifikasi output CSS
minify.js boolean false Minifikasi output JS
process.scss boolean false Memproses file SCSS
output string source Lokasi penulisan aset terkompilasi: source atau cache
inlineLimit integer 0 Byte blok CSS eksternal yang dicetak sebaris per halaman

output secara default bernilai source, yang membuat direktori _dist di samping setiap blok. Atur ke cache agar aset yang dikompilasi ditulis di direktori cache Blockstudio, sehingga pohon sumber blok tetap bersih dan dapat di-deploy dari checkout yang tidak dapat diubah. Sumber Blockstudio yang tidak dapat menulis ke sana akan tetap dialihkan ke cache, apa pun pengaturan ini.

inlineLimit nonaktif pada 0, sehingga setiap stylesheet eksternal tetap memiliki tag <link>. Atur nilainya ke jumlah byte untuk mencetak stylesheet blok eksternal terkecil pada suatu halaman secara sebaris, selama totalnya tidak melebihi jumlah tersebut. 40000 adalah batas WordPress core yang digunakan untuk aturan yang sama. Lihat Menyisipkan Stylesheet Kecil Sebaris.

Saat reset.enabled aktif, Blockstudio juga menyalin nilai body_class frontend yang telah disanitasi ke kanvas editor. Gunakan blockstudio/editor/canvas/body_class untuk menyesuaikan daftar kelas khusus editor.

cache

Opsi Jenis Default Deskripsi
enabled boolean true Aktifkan cache berbasis file Blockstudio
path string "blockstudio/cache" Jalur cache, relatif terhadap WP_CONTENT_DIR atau absolut
namespaceGrace integer 86400 Jumlah detik namespace cache yang dipensiunkan disimpan sebelum dibersihkan

Secara default, file cache ditulis ke wp-content/blockstudio/cache, di luar direktori uploads. path relatif dihitung dari WP_CONTENT_DIR; jalur absolut digunakan langsung. Ini mendukung host yang menyediakan volume cache khusus yang dapat ditulisi.

Jika diaktifkan, Blockstudio menggunakan satu root ini untuk payload build, data registrasi blok yang sudah dibuat sebelumnya, aset editor yang telah ditentukan, Tailwind CSS, dokumen render, fragmen island, prerender statis, indeks graf, antrean, dan diagnostik. Setiap objek diisolasi berdasarkan jaringan, situs, identitas runtime lengkap, dan cakupan. Identitas runtime mencakup Blockstudio, pengaturan, WordPress, PHP, tema aktif, plugin aktif, sumber penemuan logis, konteks host, dan hash dependensi eksplisit yang diberikan oleh operasi pemiliknya.

Perubahan konten, istilah, pengguna, dan metadata membatalkan pilihan field yang telah terisi, bukan penemuan blok struktural atau aset yang telah dikompilasi. Pilihan diperbarui secara terpisah dengan kunci jalur build tetap. Serangkaian penulisan, seperti sinkronisasi terjemahan atau impor, digabungkan: penulisan pertama setelah jeda memperbarui pilihan langsung, dan penulisan terakhir dalam rangkaian tersebut tercermin setelah tiga puluh detik berlalu, yang dapat disesuaikan dengan blockstudio/cache/populate_debounce. Metadata yang WordPress tulis sebagai pencatatan, seperti kunci edit kiriman, tidak dihitung sebagai perubahan; blockstudio/cache/populate_ignored_meta_keys memperluas daftar itu. Editor selalu meminta opsi terbaru, jadi jeda tersebut hanya memengaruhi pilihan tersimpan yang dibaca saat render. File sumber dan pengaturan build tetap membatalkan cache struktural seperti biasa. Menimpa pilihan tidak memindai ulang direktori cache setiap kali konten berubah; pembersihan berkala tetap menghapus file sementara yang tidak lagi digunakan. Identitas runtime khusus bahasa tetap terisolasi; keberadaan beberapa direktori namespace cache di situs multibahasa tidak dengan sendirinya menandakan cache tidak ditemukan.

Aktivitas jurnal SQLite di dalam direktori data db suatu blok tidak membuang metadata blok yang tersimpan di cache. Perubahan pada db.php, file sumber yang dipantau, atau struktur file sumber dan subdirektori dalam direktori data tetap membatalkan cache.

Pembangunan ulang runtime serentak memiliki satu builder yang terpilih. Permintaan lain menunggu hingga lima detik, lalu menggunakan kembali metadata blok terakhir yang valid jika file sumber dan aset kompilasi yang diperlukan masih tersedia. Permintaan tanpa payload yang aman mengembalikan HTTP 503 dengan Retry-After alih-alih memulai build lain. Filter blockstudio/cache/build_wait_budget menyesuaikan waktu tunggu dalam milidetik untuk pembangunan ulang struktural dan penyegaran pilihan. Host tanpa kunci file advisori menyegarkan pilihan tanpa pengamanan dan tetap menerbitkannya, sehingga permintaan berikutnya dapat menggunakan hasil tersebut.

File .build.lock khusus kunci yang tidak aktif dan ditinggalkan versi sebelumnya akan dikumpulkan dari seluruh namespace cache situs ini oleh WP-Cron, mulai lima menit setelah pemutakhiran, dengan menghapus hingga 10,000 kunci per menit dalam batas waktu sepuluh detik. wp bs cache status melaporkan jumlah yang tersisa dan wp bs cache cleanup segera menguras antrean, sedangkan wp bs cache clear menghapus cache runtime. Jika batch terjadwal terlambat lebih dari sepuluh menit karena cron tidak berjalan, permintaan akan menyapu sejumlah kunci terbatas setiap jam agar proses pengurasan tidak macet. Kunci yang baru dibuat atau sedang digunakan dibiarkan, dan kunci jalur tetap yang baru tidak pernah dikumpulkan. Setelah antrean kosong, batch yang sama mengumpulkan namespace cache yang ditinggalkan setelah namespaceGrace berlalu, paling banyak sekali sejam per situs, dan tetap menjalankan proses harian. Masa tenggang dihitung sejak penyapuan pertama yang menemukan namespace sudah tidak aktif, bukan sejak file terbarunya, dan namespace yang masih aktif untuk salah satu cakupannya tidak pernah dikumpulkan. Pembersihan cache internal tidak menjalankan filter penghapusan lampiran WordPress. Host yang menonaktifkan WP-Cron harus terus menjalankan worker cron terjadwal seperti biasa; jangan menghapus file kunci aktif secara sembarangan untuk mengosongkan antrean.

Filter pengaturan blockstudio/settings/cache/path mengubah nilai yang dikonfigurasi. Untuk menentukan jalur berdasarkan deployment, blockstudio/cache/dir memfilter direktori dasar yang telah ditentukan:

PHP
add_filter('blockstudio/cache/dir', function (string $directory): string {
    return WP_CONTENT_DIR . '/cache/blockstudio';
});

Host dengan identitas tenant yang berbeda dari ID jaringan/blog WordPress dapat memfilter blockstudio/cache/site_key. Hasilnya disanitasi dan hanya digunakan sebagai segmen direktori. blockstudio/cache/context tetap merupakan tempat yang tepat untuk varian runtime yang dapat diserialisasi dan harus mengubah identitas objek.

themeDefaults

Opsi Jenis Default Deskripsi
titleTag boolean false Aktifkan dukungan tema tag judul WordPress
suppressDirectoryUpdates boolean false Hapus tema anak dan induk yang aktif dari hasil pembaruan direktori

Pola tetap menggunakan Blockstudio\Patterns API yang sudah ada; nilai default ini tidak memperkenalkan fasad halaman atau pola alternatif.

performance

Profil compat membiarkan perilaku umum WordPress tetap sama. speed dan strict mengaktifkan default frontend opsional yang sama; setiap pengaturan turunan dapat mengganti nilai profilnya.

Pengaturan opsional berfungsi sebagai gerbang registrasi. Saat fitur opsional false, Blockstudio tidak memasang callback frontend, admin, editor, REST, atau callback terjadwal milik fitur tersebut. Menonaktifkan Early Serve atau pemanasan terjadwal setelah digunakan akan menjalankan pembersihan yang menjadi tanggung jawabnya satu kali; permintaan berikutnya tidak melakukan apa pun.

Opsi Tipe Default kompatibilitas Default kecepatan/ketat Deskripsi
profile string "compat" Tidak berlaku compat, speed, atau strict
wordpress.headNoise boolean false true Hapus penemuan head generik dan keluaran emoji
wordpress.embeds boolean false true Hapus penemuan oEmbed dan skrip host
wordpress.xmlrpc boolean false true Nonaktifkan XML-RPC dan pingback
wordpress.editor boolean false true Nonaktifkan permukaan penemuan editor jarak jauh
wordpress.frontendAssets boolean false true Hapus aset frontend core generik
wordpress.media boolean false true Terapkan default keluaran gambar
wordpress.heartbeat boolean false true Batasi Heartbeat di luar editor
preload.links string "off" "intent" Prefetch dokumen satu origin setelah ada niat pengguna
media.lazy boolean false true Gunakan pemuat gambar milik Blockstudio
media.skeleton boolean false true Tampilkan skeleton pemuatan bawaan
media.metadata boolean false true Nyatakan penggunaan assets/media.json
media.rootMargin string "300px" "300px" Margin intersection pemuat malas
measurement.enabled boolean false false Aktifkan API pengukuran runtime
measurement.queryMonitor boolean false false Sertakan kueri yang memerlukan setidaknya 50ms
measurement.headers boolean false false Kirim header hash profil dan konfigurasi
measurement.timings boolean false false Kirim header runtime yang telah berlalu
staticPrerender.enabled boolean false false Aktifkan caching HTML yang aman secara anonim
staticPrerender.ttl integer 86400 86400 Usia maksimum dokumen dalam cache, dalam detik
staticPrerender.invalidate string "signature" "signature" Gunakan identitas signature atau graph inkremental
staticPrerender.earlyServe boolean false false Sajikan hasil cache yang aman sebelum WordPress dimulai
staticPrerender.serveLoggedIn boolean false false Izinkan pengguna memakai hasil cache, tetapi tidak membuatnya
staticPrerender.dynamicPaths array [] [] Awalan jalur yang harus tetap dinamis
staticPrerender.replayHeaders array ["Link"] ["Link"] Header respons yang disimpan bersama dan dikirim pada hasil cache
staticPrerender.warm.enabled boolean false false Aktifkan antrean pemanasan terjadwal yang persisten
staticPrerender.warm.interval integer 3600 3600 Interval pemanasan dalam detik
staticPrerender.warm.concurrency integer 2 2 Jumlah maksimum pekerjaan yang diproses dalam satu proses pemanasan
staticPrerender.warm.transport string "http" "http" Gunakan http atau renderer yang disediakan host internal

Prarender statis tetap dinonaktifkan kecuali diaktifkan secara eksplisit. Sakelar utama yang dinonaktifkan tidak mendaftarkan hook permintaan prarender, dan sakelar earlyServe serta warm.enabled yang dinonaktifkan tidak mendaftarkan hook admin atau cron. Mode tanda tangan menggunakan identitas teraktivasi yang ringan pada permintaan biasa. Mode graf ditujukan untuk build eksplisit: mode ini mencatat dependensi sumber per halaman sehingga perubahan pada satu halaman tidak membatalkan dokumen lain yang tidak terkait. Lihat Prarender Statis untuk detail pemanasan, deployment, penyajian awal, dan keamanan.

Pengukuran tersedia secara terprogram:

PHP
use Blockstudio\Performance_Measurement;

$snapshot = Performance_Measurement::snapshot();

Saat header diaktifkan, Blockstudio mengirim X-Blockstudio-Performance-Profile, X-Blockstudio-Performance-Config, dan secara opsional X-Blockstudio-Performance-Time. Aksi blockstudio/performance/measurement_enabled menerima pengaturan runtime yang telah ditetapkan.

Opsi media mengatur bs_media_image(), manifes assets/media.json, dan pemuat malas frontend. Lihat Media untuk helper, pembuat manifes, dan perilaku pemuat.

content

Opsi Tipe Default Deskripsi
enabled boolean false Aktifkan konfigurasi Content Sync
id string "default" Namespace kumpulan konten yang disimpan pada entitas tersinkron
path string "content" Direktori file konten relatif terhadap tema
includePageSyncManaged boolean false Sertakan kiriman yang dikelola Page Sync tanpa mengambil alih isinya
authors string "ignore" Penanganan penulis (ignore atau login pengguna yang sudah ada)
postTypes array [] Jenis kiriman yang diizinkan
meta.include array [] Pola glob untuk kunci meta yang disinkronkan
meta.exclude array ["_edit_lock", "_edit_last", "_wp_old_slug"] Pola glob untuk mengecualikan kunci meta
meta.references object {} Referensi meta yang dinyatakan dan ditulis ulang antara ID dan UID
taxonomies array [] Taksonomi terdaftar yang diizinkan untuk istilah dan relasi
media string "manifest" Perilaku referensi lampiran (manifest atau none)

Content Sync dikelola melalui wp bs content dan mengekspor kiriman, postmeta, serta referensi yang dinyatakan ke file portabel. Lihat Content Sync untuk alur kerja dan format file.

editor

Opsi Tipe Default Deskripsi
formatOnSave boolean false Format block.json saat disimpan
assets array [] Aset tambahan yang dimuat di editor
markup boolean false Aktifkan pengeditan markup

tailwind

Opsi Tipe Default Deskripsi
enabled boolean false Aktifkan kompilasi Tailwind CSS
config string "" Konfigurasi Tailwind v4-first CSS

Lihat Tailwind CSS untuk perilaku kompilasi dan format konfigurasi yang CSS-first.

blockTags

Opsi Tipe Default Deskripsi
enabled boolean false Aktifkan rendering tag bs: tingkat halaman pada konten kiriman dan area widget
allow array [] Daftar izin pola nama blok; mendukung wildcard fnmatch()
deny array [] Daftar larangan pola nama blok; didahulukan daripada allow
prefixes object {} Awalan untuk memberi namespace pada singkatan, setiap nilai berupa namespace atau array berurutan

Rendering tag tingkat templat selalu aktif; opsi ini mengontrol penggantian pada tingkat halaman. Lihat Rendering untuk sintaks tag dan aturan resolusi.

ui

Opsi Tipe Default Deskripsi
enabled boolean false Daftarkan komponen bsui/* UI bawaan dan aplikasi demo app/*

blockEditor

Opsi Tipe Default Deskripsi
disableLoading boolean false Nonaktifkan pemuatan blok di editor
enhance boolean false Aktifkan fitur hover dan pemilihan editor Blockstudio
cssClasses array [] URL stylesheet untuk mengekstrak kelas CSS bagi pelengkapan otomatis kolom kelas
cssVariables array [] URL stylesheet untuk mengekstrak variabel CSS bagi pelengkapan otomatis kolom kode

blockEditor.blocks

Gunakan blockEditor.blocks untuk kebijakan penyisip blok di seluruh proyek. allow dan deny menerima nama blok dan pola wildcard seperti core/*.

JSON
{
  "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 membatalkan pendaftaran gaya yang didaftarkan melalui registri gaya blok WordPress’ PHP:

JSON
{
  "blockEditor": {
    "blocks": {
      "styles": {
        "deny": {
          "my-theme/card": ["outline"],
          "my-theme/media": ["framed"]
        }
      }
    }
  }
}

blockEditor.patterns

Gunakan blockEditor.patterns untuk menonaktifkan sumber pola global dan memfilter kategori pola.

JSON
{
  "blockEditor": {
    "patterns": {
      "core": false,
      "remote": false,
      "theme": true,
      "blockstudio": true,
      "categories": {
        "deny": ["gallery"],
        "rename": {
          "featured": "Featured Layouts"
        },
        "order": ["featured", "buttons"]
      }
    }
  }
}

blockEditor.media

Gunakan blockEditor.media untuk kebijakan penyisip media global.

JSON
{
  "blockEditor": {
    "media": {
      "openverse": false,
      "imageSizes": {
        "allow": ["thumbnail", "large"],
        "deny": ["medium_large"]
      }
    }
  }
}

dev

Opsi Tipe Default Deskripsi
grab.enabled boolean false Aktifkan pengambil elemen frontend
perf boolean false Aktifkan profiler kinerja pada setiap pemuatan halaman
canvas.enabled boolean false Aktifkan kanvas
canvas.adminBar boolean true Tampilkan bilah admin WordPress saat melihat kanvas

githooks

Opsi Tipe Default Deskripsi
commit boolean false Buat hook pre-commit khusus analisis saat blockstudio-githooks sync dijalankan

Lihat hook commit terkelola untuk mengetahui apa yang dijalankan hook yang dibuat dan bagaimana hook tersebut tetap tersinkron.

phpstan

Opsi Tipe Default Deskripsi
preset string "base" Preset analisis saat baris perintah tidak memilih preset: base, theme, extreme-theme, atau wordpress-render
configuration string "" Konfigurasi proyek PHPStan yang disertakan bersama preset, diselesaikan dari blockstudio.json
roots array ["."] Root tema yang dianalisis oleh perintah kanonis
excludePaths array [] Pengecualian pemindai tambahan relatif terhadap setiap root yang dikonfigurasi
maxFiles integer 10000 Jumlah maksimum file yang diperiksa pemindai tema
blockTags object {} Pemetaan elemen, alias tag, dan scanPhp untuk aturan tag blok

Pengaturan ini mengendalikan perintah blockstudio-phpstan kanonis. Lihat PHPStan untuk preset, lapisan, dan adopsi.

ai

Opsi Tipe Default Deskripsi
enableContextGeneration boolean false Buat file konteks gabungan berisi blok, pengaturan, skema, dan dokumentasi untuk alat LLM

Lihat Integrasi AI untuk indeks dokumentasi dan teks lengkap yang dihasilkan.

UI Komponen

Aktifkan dan susun komponen headless UI bawaan yang diperkenalkan pada Blockstudio 7.3.