Treci la conținut

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

Shell
wp bs blocks list
Cod
+----------------------------+---------------------+-----------+------------------------+
| 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

Shell
wp bs blocks list --components

Afișați ca JSON

Shell
wp bs blocks list --format=json

Validați câmpurile stocate

Shell
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

Shell
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.

Cod
+---------------------+----------+------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------+------+
| 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:

JSON
[
  {
    "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.

Shell
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:

Shell
wp bs pages sync --authoritative --full

Pentru scripturile de implementare care au nevoie de raportul complet:

Shell
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

Shell
wp bs db schemas
Cod
+-------------------+-------------+---------+---------------------+
| 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

Shell
# 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:

Shell
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:

Shell
wp bs db migrate my-theme/app subscribers --to=storh

Pentru blocuri cu o singură schemă:

Shell
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:

Shell
wp bs db list my-theme/app subscribers --format=json

RPC

Listați toate funcțiile

Shell
wp bs rpc list
Cod
+-------------------+-------------+--------+----------------+---------+
| 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

Shell
wp bs rpc call my-theme/app subscribe --email=user@example.com

Ieșirea este JSON:

JSON
{
  "success": true
}

Parametrii sunt transmiși ca opțiuni --key=value:

Shell
wp bs rpc call my-theme/app load_more --offset=10 --limit=5

Cron

Listați toate sarcinile

Shell
wp bs cron list
Cod
+-------------------+----------+----------+---------------------+
| 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ă

Shell
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

Shell
wp bs settings list

Obțineți o anumită setare

Shell
wp bs settings get tailwind/enabled
wp bs settings get assets/enqueue

Tailwind

Compilați HTML în CSS

Shell
wp bs tailwind compile '<div class="flex items-center p-4">'

Compilați din fișier

Shell
wp bs tailwind compile --file=template.html

Gestionarea memoriei cache

Shell
wp bs tailwind cache path    # show cache directory
wp bs tailwind cache clear   # clear compiled cache

SCSS

Compilați SCSS în CSS

Shell
wp bs scss compile '$color: red; .test { color: $color; }'

Compilați din fișier

Shell
wp bs scss compile --file=styles.scss

Câmpuri personalizate

Listați toate câmpurile personalizate înregistrate

Shell
wp bs fields list
Cod
+-------+----------------+---------------------------+
| name  | title          | fields                    |
+-------+----------------+---------------------------+
| hero  | Hero Section   | heading, description, cta |
| card  | Card           | title, image, link        |
+-------+----------------+---------------------------+

Resurse

Listați toate resursele

Shell
wp bs assets list

Filtrați după tip

Shell
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ă:

Shell
# 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

Shell
wp bs content pull

Limitați extragerea la un singur tip de postare sau o singură taxonomie configurată:

Shell
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:

Shell
wp bs content pull --dry-run

Încărcați fișierele în baza de date

Shell
wp bs content push

Previzualizați planul de aplicare fără să scrieți:

Shell
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:

Shell
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

Shell
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

Shell
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

Shell
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

Shell
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ă

Shell
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ă

Shell
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:

Shell
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

Shell
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.