Lewati ke konten

Admin

Blockstudio menyediakan layar admin di Tools > Blockstudio. Ini adalah tampilan pemeriksaan tingkat proyek untuk melihat apa yang telah didaftarkan Blockstudio dari sistem file, serta untuk menelusuri registri dan rekaman database.

Halaman ini memang bukan halaman pengaturan. Tujuannya adalah memberikan visibilitas: blok, ekstensi, field, halaman, skema, registri, dan rekaman database apa saja yang ada saat ini.

Akses

Halaman admin tersedia jika kedua kondisi berikut terpenuhi:

  • pengguna saat ini memiliki kapabilitas manage_options
  • halaman diaktifkan melalui blockstudio/admin/enabled

Nonaktifkan sepenuhnya dengan:

PHP
add_filter('blockstudio/admin/enabled', '__return_false');

Tampilan

Ikhtisar

Ikhtisar ini adalah inventaris hanya-baca dari pendaftaran Blockstudio. Ikhtisar ini mencakup tab khusus untuk:

  • Blok: jenis blok terdaftar, mode render, versi API, jumlah atribut
  • Ekstensi: target, prioritas, mode render, jumlah atribut
  • Field: definisi field.json yang dapat digunakan kembali
  • Halaman: halaman berbasis file dengan jenis post, status, engine, dan status sinkronisasi
  • Skema: skema db.php terdaftar beserta penyimpanan dan jumlah field

Tabel menggunakan DataViews WordPress bawaan agar layar tetap selaras dengan wp-admin, alih-alih membuat antarmuka terpisah.

Registri

Jika proyek Anda memiliki blocks.json dengan registri yang dikonfigurasi, halaman admin menampilkan tampilan Registry. Tampilan ini mengambil blok yang tersedia dari registri tersebut dan memungkinkan Anda mengimpornya langsung ke direktori blok yang dikonfigurasi.

Konfigurasi blocks.json yang sama digunakan oleh CLI dan peramban admin:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blocks.json",
  "directory": "blockstudio",
  "registries": {
    "ui": "https://blocks.example.com/registry.json"
  }
}

Registri terautentikasi didukung melalui format objek dengan interpolasi headers dan ${ENV_VAR}. Lihat dokumentasi Registry untuk format konfigurasi lengkap.

Database

Jika proyek Anda mendaftarkan skema db.php, halaman admin menampilkan tampilan Databases. Setiap skema memiliki tab tersendiri dan menampilkan rekaman aktual dalam tabel DataViews.

Layar ini tidak menyerialisasi semua rekaman ke dalam payload admin awal. Sebaliknya:

  1. metadata skema dilokalkan terlebih dahulu
  2. rekaman diambil sesuai kebutuhan saat Anda membuka tab database
  3. tabel melakukan paginasi melalui REST API

Dengan begitu, layar admin tetap dapat digunakan meskipun proyek memiliki kumpulan data yang lebih besar.

Cakupan

Cakupan saat ini sengaja dibatasi:

  • memeriksa apa yang telah didaftarkan Blockstudio
  • mengimpor blok dari registri yang dikonfigurasi
  • menelusuri rekaman database

Fitur ini tidak menggantikan alur kerja pengaturan yang ada dan tidak mengedit definisi blok atau halaman secara langsung.