CLI
Blockstudio înregistrează comenzi WP-CLI pentru gestionarea blocurilor, paginilor bazate pe fișiere, înregistrărilor din baza de date, funcțiilor RPC, sarcinilor cron, setărilor și configurației de limbă WPML din terminal.
Blocuri
Listați toate blocurile
wp bs blocks list
+----------------------------+---------------------+-----------+------------------------+
| name | title | component | category |
+----------------------------+---------------------+-----------+------------------------+
| my-theme/hero | Hero | | my-theme |
| my-theme/card | Card | yes | my-theme |
| my-theme/newsletter | Newsletter | | my-theme |
+----------------------------+---------------------+-----------+------------------------+
Filtrați numai componentele
wp bs blocks list --components
Afișați ca JSON
wp bs blocks list --format=json
Validați câmpurile stocate
wp bs blocks validate 42
wp bs blocks validate 42 57 --format=json
Verifică conținutul stocat al ID-urilor de postare specificate, inclusiv innerBlocks imbricate, folosind bs_validate_block().
Nu randează blocuri, nu extinde referințele la modele sincronizate și nu modifică postările. Blocurile necunoscute fără extensii Blockstudio sunt omise.
Tabelul implicit listează ID-ul postării, calea blocului indexată de la zero, numele blocului, codul constatării, calea câmpului, sursa și mesajul. JSON include și valorile originale value și expected. Un bloc imbricat poate avea calea blocului 0/1 și calea câmpului cards/2/style; acestea sunt căi distincte.
Comanda se încheie cu 0 dacă nu există constatări și cu 1 dacă există. Ieșirea JSON este o listă simplă, care include [] la succes, astfel încât automatizarea să o poată citi chiar și când comanda se încheie cu 1. Postările inexistente, ID-urile lipsă și formatele diferite de table sau json sunt erori. Toate ID-urile sunt verificate înainte de începerea validării.
Randați blocurile
wp bs blocks render
wp bs blocks render my-theme/hero my-theme/card
wp bs blocks render my-theme/card --attributes='{"variant":"wide"}'
wp bs blocks render my-theme/card --attributes=@card.json --format=json
Randează blocurile înregistrate așa cum ar face o pagină și raportează fiecare notificare PHP, avertisment, depreciere și eroare generată de șabloanele lor. O temă poate rula comanda în CI pentru a testa rapid blocurile în raport cu Blockstudio instalat. Dacă nu specificați nume, sunt randate toate blocurile înregistrate, inclusiv componentele.
Fiecare bloc este randat prin do_blocks() dintr-un comentariu de bloc cu blockstudio.attributes, forma stocată de editor, în contextul frontendului WP-CLI, nu în previzualizarea inseratorului. Nu este configurată nicio postare interogată pentru randare. Insulele dinamice își randează corpul real al șablonului, nu doar substituentul, iar ieșirea incidentală a șablonului nu este inclusă în raport.
Comanda nu salvează postări sau valori de câmp, dar execută șabloanele și hook-urile de randare ca orice PHP obișnuit. Acestea pot scrie date, apela servicii externe sau produce alte efecte secundare. Rulați comanda pe cod de încredere, pe un site de test dedicat; nu este un mediu izolat cu acces doar pentru citire.
Atributele unei randări sunt alese pentru fiecare bloc:
| Caz | Atribute |
|---|---|
example |
example.attributes din block.json ale blocului, valorile folosite de previzualizarea inseratorului. |
defaults |
default fiecărui câmp. Folosit pentru blocurile fără example.attributes; comanda afișează câte un rând pentru fiecare. |
attributes |
Valorile din --attributes, care înlocuiesc exemplul. |
--attributes acceptă un obiect JSON cu valorile câmpurilor indexate după cheia de stocare sau @ și calea unui fișier care conține un astfel de obiect și necesită exact un nume de bloc. Folosiți-l pentru a accesa ramuri ale șablonului pe care exemplul nu le acoperă, cum ar fi o variantă. Valorile exemplului care generează doar imagini substituent în previzualizarea inseratorului sunt omise, iar innerBlocks din exemplu nu sunt randate.
+---------------------+----------+------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------+------+
| block | case | level | message | file | line |
+---------------------+----------+------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------+------+
| smoke/deprecated | defaults | Deprecated | strlen(): Passing null to parameter #1 ($string) of type string is deprecated | /wordpress/wp-content/themes/smoke-theme/blockstudio/deprecated/index.php | 1 |
| smoke/undefined-key | example | Warning | Undefined array key "subtitle" | /wordpress/wp-content/themes/smoke-theme/blockstudio/undefined-key/index.php | 2 |
+---------------------+----------+------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------+------+
Tabelul conține câte un rând pentru fiecare problemă. Ieșirea JSON este o listă cu câte o intrare pentru fiecare bloc randat, inclusiv blocurile fără probleme, astfel încât automatizarea să poată citi ce caz a fost folosit:
[
{
"block": "smoke/branch",
"case": "attributes",
"problems": [
{
"level": "Warning",
"message": "Undefined array key \"width\"",
"file": "/wordpress/wp-content/themes/smoke-theme/blockstudio/branch/index.php",
"line": 2
}
]
}
]
level este Notice, Warning, Deprecated sau Error. O problemă care se repetă în același fișier și pe aceeași linie, de exemplu într-o buclă, este raportată o singură dată pentru fiecare bloc. Problemele ignorate cu @ nu sunt raportate. WordPress generează propriile notificări de depreciere, precum cele ale _deprecated_function(), numai când WP_DEBUG este activată.
Comanda se încheie cu 0 dacă nu sunt găsite probleme și cu 1 în caz contrar. Numele de blocuri necunoscute, fișierele --attributes care nu pot fi citite sau sunt invalide și formatele diferite de table sau json sunt erori, iar toate numele sunt verificate înainte de randarea primului bloc.
Pagini
Sincronizarea paginilor susținute de fișiere este explicită. Cererile obișnuite WordPress nu descoperă niciodată toate paginile și nu scriu postări de pagină. Un runtime rece poate citi o singură dată manifestele colecțiilor pentru a restaura rutele, fără să sincronizeze conținutul.
wp bs pages sync
Comanda reconciliază inventarul complet dorit și raportează paginile descoperite, create, actualizate, nemodificate, blocate, păstrate, eliminate și procesate cu erori. Amprentele digitale identice nu generează scrieri în postări sau în metadatele postărilor.
Ieșirea tabelară afișează paginile modificate, blocate, păstrate cu conținutul existent și eliminate, împreună cu ID-urile postărilor lor. JSON include intrările pages.<name>.preserved, pages.<name>.overwritten și removedPages, cu numele paginii, cheia, ID-ul postării și acțiunea de curățare. O postare identică după îmbinarea pe baza cheilor este raportată ca nemodificată, fără a crea o revizie sau a actualiza marcajul temporal al modificării.
Stările de publicare existente sunt păstrate; înlocuirile titlului și slug-ului gestionate de fișier sunt afișate ca avertismente. Consultați Proprietatea câmpurilor postării.
Folosiți --authoritative pentru a înlocui conținutul gestionat, în loc să păstrați
conținutul editorului asociat cheilor, și --full pentru a raporta procesarea ca reconciliere completă,
indiferent de identitatea sursei stocate. În ambele cazuri, fiecare procesare compară
întregul inventar:
wp bs pages sync --authoritative --full
Pentru scripturile de implementare care au nevoie de raportul complet:
wp bs pages sync --format=json
Fiecare pagină analizată de comandă este verificată pentru a găsi atribute pe care blocurile sale le stochează,
dar nu le redau: atribute pe care un bloc Blockstudio nu le declară ca câmp
și nu le transmite elementului rădăcină, cum ar fi un class nedeclarat. Tabelul
afișează un avertisment pentru fiecare pagină și bloc, coloana dropped le numără,
iar raportul JSON le enumeră la pages.<name>.droppedAttributes. Paginile
a căror sursă nu s-a schimbat nu sunt analizate din nou, așa că sunt raportate
la următoarea modificare sau la prima sincronizare după o actualizare care schimbă analizatorul.
Comanda se încheie cu eșec dacă descoperirea sau reconcilierea raportează o eroare. Consultați Pagini pentru contractul privind PHP API și identitatea implementării.
Bază de date
Listați schemele
wp bs db schemas
+-------------------+-------------+---------+---------------------+
| block | schema | storage | fields |
+-------------------+-------------+---------+---------------------+
| my-theme/app | subscribers | table | email, name, plan |
| my-theme/app | logs | jsonc | action, details |
| my-theme/app | events | storh | title, status |
+-------------------+-------------+---------+---------------------+
Operațiuni CRUD
# List records
wp bs db list my-theme/app subscribers
# List with filters
wp bs db list my-theme/app subscribers --plan=pro --limit=10
# Get a single record
wp bs db get my-theme/app subscribers 1
# Create a record
wp bs db create my-theme/app subscribers --email=a@b.com --plan=pro
# Update a record
wp bs db update my-theme/app subscribers 1 --plan=enterprise
# Delete a record
wp bs db delete my-theme/app subscribers 1
Pentru blocurile cu o singură schemă, numele schemei este implicit default:
wp bs db list my-theme/leads
Migrați înregistrările JSONC în Storh
Folosiți migrate când o schemă are deja un fișier db/{schema}.jsonc și doriți
să mutați acele înregistrări în backendul de fișiere Storh:
wp bs db migrate my-theme/app subscribers --to=storh
Pentru blocuri cu o singură schemă:
wp bs db migrate my-theme/app --to=storh
Comanda păstrează ID-urile întregi ale înregistrărilor, scrie în
uploads/blockstudio/db/{block-scope}/{schema}/, reconstruiește indexurile Storh,
verifică stocarea țintă și lasă fișierul sursă .jsonc pe loc.
Formate de ieșire
Toate comenzile de listare acceptă --format=table (implicit), --format=json și
--format=csv:
wp bs db list my-theme/app subscribers --format=json
RPC
Listați toate funcțiile
wp bs rpc list
+-------------------+-------------+--------+----------------+---------+
| block | function | public | capability | methods |
+-------------------+-------------+--------+----------------+---------+
| my-theme/app | subscribe | yes | | POST |
| my-theme/app | stats | | edit_posts | POST |
| my-theme/app | get_status | | | GET,POST|
+-------------------+-------------+--------+----------------+---------+
Apelați o funcție
wp bs rpc call my-theme/app subscribe --email=user@example.com
Ieșirea este JSON:
{
"success": true
}
Parametrii sunt transmiși ca opțiuni --key=value:
wp bs rpc call my-theme/app load_more --offset=10 --limit=5
Cron
Listați toate sarcinile
wp bs cron list
+-------------------+----------+----------+---------------------+
| block | job | schedule | next_run |
+-------------------+----------+----------+---------------------+
| my-theme/app | cleanup | daily | 2026-03-17 00:00:00 |
| my-theme/app | sync | hourly | 2026-03-16 15:00:00 |
+-------------------+----------+----------+---------------------+
Rulați manual o sarcină
wp bs cron run my-theme/app cleanup
Aceasta execută imediat funcția callback, indiferent de programare. Este utilă pentru testare și depanare.
Setări
Afișați toate setările
wp bs settings list
Obțineți o anumită setare
wp bs settings get tailwind/enabled
wp bs settings get assets/enqueue
Tailwind
Compilați HTML în CSS
wp bs tailwind compile '<div class="flex items-center p-4">'
Compilați din fișier
wp bs tailwind compile --file=template.html
Gestionarea memoriei cache
wp bs tailwind cache path # show cache directory
wp bs tailwind cache clear # clear compiled cache
SCSS
Compilați SCSS în CSS
wp bs scss compile '$color: red; .test { color: $color; }'
Compilați din fișier
wp bs scss compile --file=styles.scss
Câmpuri personalizate
Listați toate câmpurile personalizate înregistrate
wp bs fields list
+-------+----------------+---------------------------+
| name | title | fields |
+-------+----------------+---------------------------+
| hero | Hero Section | heading, description, cta |
| card | Card | title, image, link |
+-------+----------------+---------------------------+
Resurse
Listați toate resursele
wp bs assets list
Filtrați după tip
wp bs assets list --type=global
wp bs assets list --type=admin
wp bs assets list --type=editor
wp bs assets list --type=registered
Scriptare
Toate comenzile acceptă --format=json pentru redirecționare simplă:
# Export all subscribers as JSON
wp bs db list my-theme/app subscribers --format=json > subscribers.json
# Count records
wp bs db list my-theme/app subscribers --format=json | jq length
# Batch delete
wp bs db list my-theme/app logs --format=json | \
jq -r '.[].id' | \
xargs -I {} wp bs db delete my-theme/app logs {}
Content Sync
Proiectele Content Sync exportă conținut WordPress permis în fișiere și aplică acele fișiere în baza de date. Procesul este explicit și bazat pe CLI; nu sincronizează la încărcarea paginii sau la inițializarea panoului de administrare.
Consultați Sincronizarea conținutului pentru configurare, formatul fișierelor și recomandări privind situațiile în care conținutul bazei de date bazat pe fișiere este potrivit.
Extrageți conținutul bazei de date în fișiere
wp bs content pull
Limitați extragerea la un singur tip de postare sau o singură taxonomie configurată:
wp bs content pull --post-type=team_member
wp bs content pull --taxonomy=category
Previzualizați fără a scrie UID-uri sau fișiere:
wp bs content pull --dry-run
Încărcați fișierele în baza de date
wp bs content push
Previzualizați planul de aplicare fără să scrieți:
wp bs content push --dry-run
Eliminați postările și termenii din baza de date deținute de setul de conținut, care nu mai există în fișiere:
wp bs content push --prune --yes
Cu --prune, Blockstudio aplică mai întâi toate modificările din fișiere, apoi elimină entitățile deținute de setul de conținut care nu mai există în fișiere. Refuză să execute o eliminare distructivă dacă nu este prezent --yes.
Verificați starea
wp bs content status
Tabelul raportează fiecare entitate susținută de fișiere ca unchanged, would-update, missing-db, conflict, locked sau orphaned.
Pre-redare statică
Consultați Pre-redare statică pentru cache-ul propriu-zis; aceste comenzi îl gestionează.
Încălziți intrările învechite
wp bs prerender warm
Adaugă URL-uri publice învechite în coadă, apoi redă din nou până la warm.concurrency sarcini din
coada persistentă de încălzire și afișează un rezumat JSON cu numărul de queued, processed,
warmed, skipped și failed. Modificările de conținut și de site adaugă automat sarcini
de înlocuire în coadă. Rulați din nou comanda sau lăsați procesul de încălzire programat
să golească o coadă mai mare; o URL care nu poate fi redată rămâne
învechită și este adăugată din nou la următoarea rulare. În modul graph, procesul de încălzire
per URL este dezactivat, iar comanda nu adaugă nimic în coadă.
Raportați starea cache-ului
wp bs prerender status
Raportează identitatea activă, fișierele, octeții, înregistrările grafului, starea cozii, raportul hărții de servire anticipată și contoarele de accesări/ratări/creări/eșecuri pentru fiecare domeniu.
Goliți cache-ul
wp bs prerender purge
Elimină documentele pre-redate ale site-ului curent. Următoarea cerere anonimă sau rulare de încălzire le reconstruiește.
Verificați și curățați harta de servire anticipată
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
map status raportează harta de servire anticipată la nivelul întregii instalări: intrările și
rutele sale, documentele rutelor care lipsesc, intrările orphaned al căror site
nu mai există și intrările dead al căror director a dispărut. map prune elimină
intrările orfane și inactive și afișează fiecare intrare eliminată împreună cu motivul;
--dry-run afișează același raport fără să scrie. O hartă deținută de alt
instrument nu este niciodată modificată.
WPML
Generați configurația de limbă
wp bs wpml config
wp bs wpml config --file=wp-content/themes/my-theme/wpml-config.xml
Afișează un wpml-config.xml care declară câmpurile text ale fiecărui bloc înregistrat pentru traducere și câmpurile de fișiere ca ID-uri de atașament sau îl scrie cu --file. Într-un fișier existent, este înlocuită doar secțiunea dintre markerii Blockstudio. Consultați WPML pentru a afla ce se declară și cum să păstrați fișierul actualizat.
Migrarea etichetelor de bloc
Un script independent rescrie formele prescurtate cu prefix și alias în forma canonică
<bs:namespace-slug>. Nu încarcă WordPress și nu scrie nimic
dacă nu este furnizat explicit --apply:
php vendor/blockstudio/blockstudio/bin/migrate-block-tags.php \
--root="$PWD" \
--prefix-map=/tmp/project-prefixes.json \
--known-blocks=/tmp/project-blocks.json \
--aliases=/tmp/project-aliases.json \
--report=/tmp/blockstudio-tag-migration.json \
--dry-run
Fișierul cu prefixe asociază prefixele gestionate de apelant cu spații de nume ordonate. Fișierul
cu blocuri cunoscute este o listă JSON cu numele blocurilor înregistrate. Aliasurile exacte
sunt opționale. Raportul include asocieri deterministe, hash-uri înainte/după,
etichete necunoscute, aliasuri ambigue, etichete dinamice și exemple găsite în comentarii,
blocuri de cod, în intervale <pre> sau <code>.
Analizatorul gestionează marcajele pereche, imbricate și cu închidere automată, inclusiv
etichetele literale în șiruri PHP. Păstrează atributele și modifică doar numele etichetelor.
Comentariile și exemplele de cod sunt incluse numai în raport. Elementele personalizate fără legătură
sunt ignorate. Aplicarea unei migrări este blocată cât timp rămân cazuri necunoscute, ambigue sau dinamice,
dacă apelantul nu transmite în mod deliberat --allow-unresolved.
Rularea din nou a comenzii pe rezultatul canonic nu produce modificări.
Consultați Migrare pentru a afla de ce există forma canonică și ce rezolvă.
Dezinstalare
wp bs teardown
Elimină evenimentele cron și starea de pre-redare statică deținute de instalare: intrarea
hărții de servire anticipată pentru site-ul curent și declarația WP_CACHE, precum și elementul drop-in advanced-cache.php
partajat, după eliminarea ultimei intrări deținute.
Instalările fără un hook de dezactivare a pluginului, cum sunt configurațiile grupate în Composer,
folosesc această comandă pentru o eliminare curată. Fișierele de configurare rămân intacte.