CLI
Blockstudio registrira ukaze WP-CLI za upravljanje blokov, strani v datotekah, zapisov v zbirki podatkov, funkcij RPC, opravil cron, nastavitev in jezikovne konfiguracije WPML v terminalu.
Bloki
Izpišite vse bloke
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 |
+----------------------------+---------------------+-----------+------------------------+
Filtrirajte samo komponente
wp bs blocks list --components
Izpis v obliki JSON
wp bs blocks list --format=json
Preverjanje shranjenih polj
wp bs blocks validate 42
wp bs blocks validate 42 57 --format=json
Preveri shranjeno vsebino navedenih ID-jev objav, vključno z ugnezdenimi elementi innerBlocks, z uporabo bs_validate_block(). Blokov ne upodablja, ne razširi sklicev na sinhronizirane vzorce in ne spreminja objav. Neznane bloke brez razširitev Blockstudio preskoči.
Privzeta tabela prikazuje ID objave, indeksno pot bloka z začetkom pri nič, ime bloka, kodo ugotovitve, pot polja, vir in sporočilo. JSON vključuje tudi izvirni vrednosti value in expected. Pot ugnezdenega bloka je lahko 0/1, pot polja pa cards/2/style; to sta ločeni poti.
Ukaz se konča z 0, če ni ugotovitev, in z 1, če ugotovitve obstajajo. Izhod JSON je navaden seznam, ki ob uspehu vključuje [], zato ga lahko avtomatizacija prebere tudi, ko se ukaz konča z 1. Manjkajoče objave, manjkajoči ID-ji in drugi formati kot table ali json povzročijo napako. Pred začetkom preverjanja se preverijo vsi ID-ji.
Upodabljanje blokov
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
Upodobi registrirane bloke tako kot stran ter sporoči vsa obvestila PHP, opozorila, opuščene funkcije in vržene napake, ki jih sprožijo njihove predloge. Tema lahko ukaz zažene v CI, da na hitro preveri bloke glede na nameščeni Blockstudio. Če imen ne navedete, se upodobi vsak registrirani blok, vključno s komponentami.
Vsak blok se upodobi prek do_blocks() iz komentarja bloka z blockstudio.attributes, torej v obliki, ki jo shrani urejevalnik, v kontekstu sprednjega dela WP-CLI in ne v predogledu vstavljalnika. Za upodabljanje se ne nastavi nobena poizvedena objava. Dinamični otoki upodobijo dejansko telo predloge in ne le označbe mesta; naključni izhod predloge ni vključen v poročilo.
Ukaz sam ne shrani objav ali vrednosti polj, vendar izvede vaše predloge in kljuke za upodabljanje kot običajni PHP. Ti lahko zapisujejo podatke, kličejo zunanje storitve ali imajo druge stranske učinke. Zaženite ga nad zaupanja vredno kodo na namenskem testnem spletnem mestu; ne gre za peskovnik samo za branje.
Atributi upodabljanja so izbrani za vsak blok posebej:
| Primer | Atributi |
|---|---|
example |
example.attributes bloka block.json, vrednosti, ki jih uporablja predogled vstavljalnika. |
defaults |
default vsakega polja. Uporabi se za bloke brez example.attributes; ukaz izpiše vrstico za vsakega. |
attributes |
Vrednosti --attributes, ki nadomestijo primer. |
--attributes sprejme objekt JSON z vrednostmi polj, razvrščenimi po ključu shranjevanja, ali @ in pot do datoteke, ki ga vsebuje; navesti je treba natanko eno ime bloka. Uporabite ga za doseganje vej predloge, ki jih primer ne pokrije, na primer različice. Primeri vrednosti, ki v predogledu vstavljalnika ustvarijo samo nadomestne slike, so preskočeni, prav tako se ne upodobijo innerBlocks primera.
+---------------------+----------+------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------+------+
| 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 |
+---------------------+----------+------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------+------+
Tabela vsebuje eno vrstico za vsako težavo. Izhod JSON je seznam z enim vnosom za vsak upodobljeni blok, tudi za bloke brez težav, zato lahko avtomatizacija prebere uporabljeni primer:
[
{
"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 je Notice, Warning, Deprecated ali Error. Težava, ki se ponavlja v isti datoteki in vrstici, na primer v zanki, se poroča enkrat za vsak blok. Težave, utišane z @, niso navedene. WordPress sproži lastna obvestila o opuščenih funkcijah, na primer tista za _deprecated_function(), samo kadar je omogočen WP_DEBUG.
Ukaz se konča z 0, če ni najdenih težav, sicer pa z 1. Neznana imena blokov, neberljiv ali neveljaven --attributes ter drugi formati kot table ali json povzročijo napako; vsa imena se preverijo pred upodabljanjem prvega bloka.
Strani
Sinhronizacija strani, shranjenih v datotekah, je izrecna. Običajne zahteve WordPress ne izvajajo odkrivanja vseh strani ali zapisovanja objav strani. Hladno okolje izvajanja lahko enkrat prebere manifeste zbirk, da obnovi poti, ne da bi sinhroniziralo vsebino.
wp bs pages sync
Ukaz uskladi celoten želeni popis in poroča o odkritih, ustvarjenih, posodobljenih, nespremenjenih, zaklenjenih, ohranjenih, odstranjenih in neuspešnih straneh. Ujemajoči se prstni odtisi ne povzročijo zapisov v objavo ali njene metapodatke.
Izhod v obliki tabele navede spremenjene, zaklenjene, vsebinsko ohranjene in odstranjene strani z njihovimi ID-ji objav. JSON vključuje vnose pages.<name>.preserved, pages.<name>.overwritten in removedPages z imenom strani, ključem, ID-jem objave in dejanjem čiščenja. Nespremenjena objava po združevanju po ključih je označena kot nespremenjena, ne da bi ustvarila revizijo ali posodobila časovni žig spremembe.
Obstoječa stanja objav so ohranjena; zamenjave naslova in polža, ki jih upravlja datoteka, so izpisane kot opozorila. Glejte Lastništvo polj objave.
Uporabite --authoritative za zamenjavo upravljane vsebine namesto ohranjanja vsebine urejevalnika s ključi, --full pa za poročanje, da je zagon popolno usklajevanje, ne glede na shranjeno identiteto vira. V obeh primerih se pri vsakem zagonu primerja celoten inventar:
wp bs pages sync --authoritative --full
Za skripte za uvajanje, ki potrebujejo celotno poročilo:
wp bs pages sync --format=json
Vsaka stran, ki jo ukaz razčleni, se preveri glede atributov, ki jih njeni bloki shranjujejo,
vendar nikoli ne izrišejo: atributov, ki jih blok Blockstudio ne določa kot polje
niti jih ne posreduje svojemu korenskemu elementu, na primer nedoločenega class. Izpis tabele prikaže opozorilo za vsako stran in blok, stolpec dropped jih prešteje,
poročilo JSON pa jih navede pod pages.<name>.droppedAttributes. Strani,
katerih vir se ni spremenil, se ne razčlenijo znova, zato bodo navedene ob naslednji spremembi ali pri prvi sinhronizaciji po nadgradnji, ki spremeni razčlenjevalnik.
Ukaz se neuspešno zaključi, če odkrivanje ali usklajevanje sporoči napako. Glejte Strani za pogodbo PHP API in identiteto uvajanja.
Zbirka podatkov
Izpišite sheme
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 |
+-------------------+-------------+---------+---------------------+
Operacije 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
Pri blokih z eno shemo je privzeto ime sheme default:
wp bs db list my-theme/leads
Preselite zapise JSONC v Storh
Uporabite migrate, če shema že ima datoteko db/{schema}.jsonc in želite
te zapise premakniti v datotečno zaledno shrambo Storh:
wp bs db migrate my-theme/app subscribers --to=storh
Za bloke z eno shemo:
wp bs db migrate my-theme/app --to=storh
Ukaz ohrani celoštevilske ID-je zapisov, zapiše v
uploads/blockstudio/db/{block-scope}/{schema}/, znova zgradi indekse Storh,
preveri ciljno shrambo in pusti izvorno datoteko .jsonc na mestu.
Oblike izpisa
Vsi ukazi za izpis podpirajo --format=table (privzeto), --format=json in
--format=csv:
wp bs db list my-theme/app subscribers --format=json
RPC
Izpišite vse funkcije
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|
+-------------------+-------------+--------+----------------+---------+
Pokličite funkcijo
wp bs rpc call my-theme/app subscribe --email=user@example.com
Izpis je JSON:
{
"success": true
}
Parametri se posredujejo kot zastavice --key=value:
wp bs rpc call my-theme/app load_more --offset=10 --limit=5
Cron
Izpišite vsa opravila
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 |
+-------------------+----------+----------+---------------------+
Ročno zaženite opravilo
wp bs cron run my-theme/app cleanup
To takoj izvede povratni klic ne glede na urnik. Uporabno za preizkušanje in razhroščevanje.
Nastavitve
Prikažite vse nastavitve
wp bs settings list
Pridobite določeno nastavitev
wp bs settings get tailwind/enabled
wp bs settings get assets/enqueue
Tailwind
Prevedite HTML v CSS
wp bs tailwind compile '<div class="flex items-center p-4">'
Prevedite iz datoteke
wp bs tailwind compile --file=template.html
Upravljanje predpomnilnika
wp bs tailwind cache path # show cache directory
wp bs tailwind cache clear # clear compiled cache
SCSS
Prevedite SCSS v CSS
wp bs scss compile '$color: red; .test { color: $color; }'
Prevedite iz datoteke
wp bs scss compile --file=styles.scss
Polja po meri
Izpišite vsa registrirana polja po meri
wp bs fields list
+-------+----------------+---------------------------+
| name | title | fields |
+-------+----------------+---------------------------+
| hero | Hero Section | heading, description, cta |
| card | Card | title, image, link |
+-------+----------------+---------------------------+
Sredstva
Izpišite vsa sredstva
wp bs assets list
Filtrirajte po vrsti
wp bs assets list --type=global
wp bs assets list --type=admin
wp bs assets list --type=editor
wp bs assets list --type=registered
Skriptno izvajanje
Vsi ukazi podpirajo --format=json za preprosto povezovanje v cevovod:
# 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
Projekti Content Sync zapisujejo vsebino WordPress z dovoljenega seznama v datoteke in te datoteke uveljavijo v zbirki podatkov. Postopek je izrecen in temelji na CLI; ne izvaja se ob nalaganju strani ali inicializaciji skrbniškega vmesnika.
Za konfiguracijo, obliko datotek in napotke o tem, kdaj je vsebina zbirke podatkov, shranjena v datotekah, primerna, glejte Content Sync.
Prenesite vsebino zbirke podatkov v datoteke
wp bs content pull
Prenos omejite na eno konfigurirano vrsto objave ali taksonomijo:
wp bs content pull --post-type=team_member
wp bs content pull --taxonomy=category
Predogled brez zapisovanja UID-jev ali datotek:
wp bs content pull --dry-run
Potisnite datoteke v zbirko podatkov
wp bs content push
Predogled načrta uveljavitve brez zapisovanja:
wp bs content push --dry-run
Odstranite objave in izraze v zbirki podatkov, ki jih upravlja nabor vsebine in jih ni več v datotekah:
wp bs content push --prune --yes
Z možnostjo --prune Blockstudio najprej uveljavi vse spremembe datotek, nato odstrani entitete, ki jih upravlja nabor vsebine in jih ni več v datotekah. Zavrne destruktivno čiščenje, če ni podana možnost --yes.
Preverite stanje
wp bs content status
Tabela vsako entiteto, shranjeno v datoteki, prikaže kot unchanged, would-update, missing-db, conflict, locked ali orphaned.
Statično vnaprejšnje izrisovanje
Glejte Statično vnaprejšnje izrisovanje za sam predpomnilnik; ti ukazi ga upravljajo.
Osvežite zastarele vnose
wp bs prerender warm
V čakalno vrsto doda zastarele javne URL-je, nato znova izriše do warm.concurrency opravil iz
trajnega čakalnega seznama za osveževanje in izpiše povzetek JSON s števci queued, processed,
warmed, skipped in failed. Spremembe vsebine in mesta samodejno dodajo nadomestna opravila. Za obdelavo večjega čakalnega seznama znova zaženite ukaz ali počakajte na načrtovano osveževanje; URL, ki ga ni mogoče izrisati, ostane zastarel in se znova doda v čakalno vrsto ob naslednjem zagonu. V načinu graph je osveževalnik za posamezni URL izklopljen in ukaz ničesar ne doda v čakalno vrsto.
Prikažite stanje predpomnilnika
wp bs prerender status
Poroča o aktivni identiteti, datotekah, bajtih, zapisih grafa, stanju čakalne vrste, poročilu zemljevida za zgodnje streženje in števcih zadetkov, zgrešitev, gradenj ter napak za posamezne obsege.
Izpraznite predpomnilnik
wp bs prerender purge
Odstrani vnaprej izrisane dokumente trenutnega mesta. Naslednja anonimna zahteva ali osvežitveni zagon jih znova zgradi.
Preverite in očistite zemljevid za zgodnje streženje
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
map status poroča o zemljevidu za zgodnje streženje za celotno namestitev: njegovih vnosih
in poteh, manjkajočih dokumentih poti, vnosih orphaned, katerih mesto ne
obstaja več, ter vnosih dead, katerih imenika ni več. map prune odstrani
osirotele in neveljavne vnose ter izpiše vsak odstranjen vnos z razlogom;
--dry-run izpiše enako poročilo brez zapisovanja. Zemljevida, ki ga upravlja drugo orodje,
se nikoli ne dotakne.
WPML
Ustvarjanje jezikovne konfiguracije
wp bs wpml config
wp bs wpml config --file=wp-content/themes/my-theme/wpml-config.xml
Izpiše wpml-config.xml, ki določa besedilna polja vsakega registriranega bloka za prevod in njegova datotečna polja kot ID-je prilog, ali pa ga zapiše z --file. V obstoječi datoteki se zamenja samo razdelek med označevalnikoma Blockstudio. Glejte WPML, kjer je pojasnjeno, kaj je določeno in kako datoteko ohraniti posodobljeno.
Selitev oznak blokov
Samostojni skript prepiše skrajšane predpone in vzdevke v kanonični
zapis <bs:namespace-slug>. Ne naloži WordPress in ničesar ne zapiše,
razen če je izrecno podan --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
Datoteka predpon preslika predpone, ki jih določi klicatelj, v urejene imenske prostore. Datoteka znanih blokov je seznam JSON registriranih imen blokov. Natančni vzdevki niso obvezni. Poročilo vključuje deterministične preslikave, zgoščene vrednosti pred in po spremembi, neznane oznake, dvoumne vzdevke, dinamične oznake in primere v komentarjih, kodnih blokih, obsegih <pre> ali <code>.
Pregledovalnik obravnava seznanjeno, ugnezdeno in samozapiralno označevanje, vključno z dobesednimi oznakami v nizih PHP. Ohranijo se atributi; spremenijo se samo imena oznak.
Komentarji in vzorci kode so samo za poročilo. Nepovezani elementi po meri so prezrti. Uveljavitev selitve je blokirana, dokler ostajajo neznani, dvoumni ali dinamični primeri, razen če klicatelj namerno poda --allow-unresolved.
Ponovni zagon ukaza nad kanoničnim izhodom ne povzroči sprememb.
Glejte Selitev, kjer izveste, zakaj obstaja kanonični zapis in kaj razrešuje.
Odstranitev
wp bs teardown
Odstrani dogodke cron in stanje statičnega vnaprejšnjega izrisovanja, ki jih upravlja namestitev: vnos zemljevida za zgodnje streženje trenutnega mesta in skupni dodatek advanced-cache.php ter deklaracijo WP_CACHE, ko ni več nobenega upravljanega vnosa.
Namestitve brez kljuke za deaktivacijo vtičnika, na primer nastavitve v paketu Composer, to uporabijo za čisto odstranitev. Konfiguracijske datoteke ostanejo nedotaknjene.