CLI
Blockstudio reģistrē WP-CLI komandas bloku, failos balstītu lapu, datubāzes ierakstu, RPC funkciju, cron darbu, iestatījumu un WPML valodas konfigurācijas pārvaldībai terminālī.
Bloki
Uzskaitīt visus blokus
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 |
+----------------------------+---------------------+-----------+------------------------+
Filtrēt, atlasot tikai komponentus
wp bs blocks list --components
Izvadīt kā JSON
wp bs blocks list --format=json
Saglabāto lauku validēšana
wp bs blocks validate 42
wp bs blocks validate 42 57 --format=json
Pārbauda norādīto ierakstu ID saglabāto saturu, tostarp ligzdotos innerBlocks, izmantojot bs_validate_block().
Bloki netiek renderēti, sinhronizēto rakstu atsauces netiek izvērstas un ieraksti netiek mainīti.
Nezināmi bloki bez Blockstudio paplašinājumiem tiek izlaisti.
Noklusējuma tabulā ir norādīts ieraksta ID, bloka ceļš, kas sākas ar nulli, bloka nosaukums, atraduma kods, lauka ceļš, avots un ziņojums. JSON ietver arī sākotnējās value un expected vērtības. Ligzdotam blokam bloka ceļš var būt 0/1 un lauka ceļš — cards/2/style; tie ir atsevišķi ceļi.
Ja atradumu nav, komanda beidzas ar 0, bet, ja atradumi ir, — ar 1. JSON izvade ir vienkāršs saraksts, kurā iekļauts arī [] sekmīgas izpildes gadījumā, tāpēc automatizācija to var nolasīt arī tad, ja komanda beidzas ar 1. Kļūda tiek ziņota, ja trūkst ierakstu vai ID, vai formāts nav table vai json. Pirms validācijas sākuma tiek pārbaudīti visi ID.
Bloku renderēšana
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
Renderē reģistrētos blokus tāpat kā lapā un ziņo par visiem PHP paziņojumiem, brīdinājumiem, novecošanas paziņojumiem un izmestajām kļūdām, ko rada to veidnes. Tēma var palaist komandu CI vidē, lai pārbaudītu tās blokus ar instalēto Blockstudio. Ja nosaukumi nav norādīti, tiek renderēti visi reģistrētie bloki, tostarp komponenti.
Katrs bloks tiek renderēts, izmantojot do_blocks(), no bloka komentāra ar blockstudio.attributes — tādu formu, kādu saglabā redaktors, — WP-CLI frontend kontekstā, nevis ievietošanas priekšskatījumā. Renderēšanai netiek iestatīts neviens vaicātais ieraksts. Dinamiskās salas renderē ar īsto veidnes saturu, nevis tikai vietturi, un nejauša veidnes izvade netiek iekļauta pārskatā.
Pati komanda nesaglabā ierakstus vai lauku vērtības, taču tā izpilda jūsu veidnes un renderēšanas āķus kā parastu PHP. Tie var ierakstīt datus, izsaukt ārējos pakalpojumus vai radīt citas blakusparādības. Palaidiet to uzticamā koda vidē, īpaši šim nolūkam paredzētā testa vietnē; tā nav tikai lasāma smilškaste.
Renderēšanas atribūtus izvēlas katram blokam atsevišķi:
| Gadījums | Atribūti |
|---|---|
example |
Bloka block.json vērtības example.attributes — tās, ko izmanto ievietošanas priekšskatījums. |
defaults |
Katra lauka default. Izmanto blokiem bez example.attributes; komanda izvada rindu katram laukam. |
attributes |
--attributes vērtības, kas aizstāj piemēru. |
--attributes pieņem JSON objektu ar lauku vērtībām, kas norādītas pēc glabāšanas atslēgām, vai @ un faila ceļu uz failu, kurā šāds objekts atrodas; jānorāda tieši viens bloka nosaukums. Izmantojiet to, lai sasniegtu veidnes atzarus, ko piemērs neaptver, piemēram, variantu. Piemēra vērtības, kas ievietošanas priekšskatījumā ģenerē tikai viettura attēlus, tiek izlaistas, un piemēra innerBlocks netiek renderēti.
+---------------------+----------+------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------+------+
| 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 |
+---------------------+----------+------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------+------+
Tabulā katrai problēmai ir viena rinda. JSON izvade ir saraksts ar vienu ierakstu katram renderētajam blokam, arī tiem, kuriem nav problēmu, tāpēc automatizācija var nolasīt izmantoto gadījumu:
[
{
"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 ir Notice, Warning, Deprecated vai Error. Ja problēma atkārtojas tajā pašā failā un rindā, piemēram, ciklā, par to tiek ziņots vienreiz katram blokam. Par problēmām, kas apklusinātas ar @, netiek ziņots. WordPress pats rada novecošanas paziņojumus, piemēram, _deprecated_function() paziņojumus, tikai tad, ja ir iespējots WP_DEBUG.
Ja problēmas nav atrastas, komanda beidzas ar 0, citādi — ar 1. Nezināmi bloku nosaukumi, nelasāmi vai nederīgi --attributes, kā arī formāti, kas nav table vai json, ir kļūdas; visi nosaukumi tiek pārbaudīti, pirms tiek renderēts pirmais bloks.
Lapas
Failos glabātu lapu sinhronizācija tiek veikta skaidri. Parastie WordPress pieprasījumi nekad neveic pilnu lapu atklāšanu un neraksta lapu ierakstus. Pirmreizēji palaižot izpildvidi, var vienreiz nolasīt kolekciju manifestus, lai atjaunotu maršrutus, nesinhronizējot saturu.
wp bs pages sync
Komanda salāgo visu vēlamo inventāru un ziņo par atrastajām, izveidotajām, atjauninātajām, nemainītajām, bloķētajām, saglabātajām un noņemtajām lapām, kā arī par lapām, kuru apstrāde neizdevās. Ja pirkstu nospiedumi sakrīt, ierakstā vai ieraksta metadatos nekas netiek rakstīts.
Tabulas izvadē norāda mainīto, bloķēto, satura ziņā saglabāto un noņemto lapu ID. JSON ietver arī pages.<name>.preserved, pages.<name>.overwritten un removedPages ierakstus ar lapas nosaukumu, atslēgu, ieraksta ID un tīrīšanas darbību. Ja pēc apvienošanas pēc atslēgām ieraksts ir identisks, tas tiek atzīmēts kā nemainīts; jauna versija netiek izveidota un izmaiņu laika zīmogs netiek atjaunināts.
Esošie publicēšanas statusi tiek saglabāti; par faila pārvaldītiem nosaukuma un adreses aizstājumiem tiek izvadīti brīdinājumi. Skatiet Lauku pārvaldība ierakstā.
Izmantojiet --authoritative, lai saglabāta redaktora satura vietā ievietotu pārvaldīto saturu,
un --full, lai norādītu, ka izpilde ir pilna saskaņošana neatkarīgi no saglabātās avota identitātes.
Abos gadījumos katrā izpildē tiek salīdzināts viss inventārs:
wp bs pages sync --authoritative --full
Izvietošanas skriptiem, kam nepieciešams pilns pārskats:
wp bs pages sync --format=json
Katrai komandai parsētajai lapai tiek pārbaudīti atribūti, ko tās bloki saglabā,
bet nekad neattēlo: atribūti, ko Blockstudio bloks nedeklarē kā lauku
un nenodod tālāk saknes elementam, piemēram, nedeklarēts class. Tabulas
izvadē katrai lapai un blokam tiek parādīts brīdinājums, kolonnā dropped tiek saskaitīti brīdinājumi,
un pārskatā JSON tie ir uzskaitīti sadaļā pages.<name>.droppedAttributes. Lapas,
kuru avots nav mainījies, netiek parsētas atkārtoti, tāpēc tās tiks uzrādītas nākamajā reizē,
kad tās mainīsies, vai pirmajā sinhronizācijā pēc parsētāja atjauninājuma.
Komanda beidzas ar kļūdu, ja atklāšanas vai saskaņošanas laikā tiek ziņots par kļūdu. Skatiet Lapas, lai uzzinātu par PHP API un izvietošanas identitātes līgumu.
Datubāze
Uzskaitīt shēmas
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 |
+-------------------+-------------+---------+---------------------+
CRUD darbības
# 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
Blokiem ar vienu shēmu shēmas nosaukums pēc noklusējuma ir default:
wp bs db list my-theme/leads
Migrēt JSONC ierakstus uz Storh
Izmantojiet migrate, ja shēmai jau ir db/{schema}.jsonc fails un vēlaties
pārvietot šos ierakstus uz failos glabāto aizmugursistēmu Storh:
wp bs db migrate my-theme/app subscribers --to=storh
Blokiem ar vienu shēmu:
wp bs db migrate my-theme/app --to=storh
Komanda saglabā veselu skaitļu ierakstu ID, raksta uz
uploads/blockstudio/db/{block-scope}/{schema}/, atjauno Storh indeksus,
pārbauda mērķa krātuvi un atstāj avota .jsonc failu vietā.
Izvades formāti
Visas sarakstu komandas atbalsta --format=table (noklusējums), --format=json un
--format=csv:
wp bs db list my-theme/app subscribers --format=json
RPC
Uzskaitīt visas funkcijas
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|
+-------------------+-------------+--------+----------------+---------+
Izsaukt funkciju
wp bs rpc call my-theme/app subscribe --email=user@example.com
Izvade ir JSON:
{
"success": true
}
Parametri tiek nodoti kā --key=value karodziņi:
wp bs rpc call my-theme/app load_more --offset=10 --limit=5
Cron
Uzskaitīt visus darbus
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 |
+-------------------+----------+----------+---------------------+
Palaist darbu manuāli
wp bs cron run my-theme/app cleanup
Tas nekavējoties izpilda atzvanīšanas funkciju neatkarīgi no grafika. Noder testēšanai un atkļūdošanai.
Iestatījumi
Rādīt visus iestatījumus
wp bs settings list
Iegūt konkrētu iestatījumu
wp bs settings get tailwind/enabled
wp bs settings get assets/enqueue
Tailwind
Kompilēt HTML uz CSS
wp bs tailwind compile '<div class="flex items-center p-4">'
Kompilēt no faila
wp bs tailwind compile --file=template.html
Kešatmiņas pārvaldība
wp bs tailwind cache path # show cache directory
wp bs tailwind cache clear # clear compiled cache
SCSS
Kompilēt SCSS uz CSS
wp bs scss compile '$color: red; .test { color: $color; }'
Kompilēt no faila
wp bs scss compile --file=styles.scss
Pielāgotie lauki
Uzskaitīt visus reģistrētos pielāgotos laukus
wp bs fields list
+-------+----------------+---------------------------+
| name | title | fields |
+-------+----------------+---------------------------+
| hero | Hero Section | heading, description, cta |
| card | Card | title, image, link |
+-------+----------------+---------------------------+
Līdzekļi
Uzskaitīt visus līdzekļus
wp bs assets list
Filtrēt pēc veida
wp bs assets list --type=global
wp bs assets list --type=admin
wp bs assets list --type=editor
wp bs assets list --type=registered
Skriptēšana
Visas komandas atbalsta --format=json, lai atvieglotu datu pārsūtīšanu:
# 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
Content Sync eksportē atļauto WordPress saturu failos un lieto šos failus datubāzē. Tas tiek darīts skaidri un ir balstīts uz CLI; sinhronizācija nenotiek, ielādējot lapu vai inicializējot administrēšanas vidi.
Skatiet Content Sync, lai uzzinātu par konfigurāciju, faila formātu un ieteikumiem, kad datubāzes satura glabāšana failos ir piemērota.
Iegūt datubāzes saturu failos
wp bs content pull
Ierobežot izgūšanu līdz vienam konfigurētam ierakstu tipam vai taksonomijai:
wp bs content pull --post-type=team_member
wp bs content pull --taxonomy=category
Priekšskatīt, nerakstot UID vai failus:
wp bs content pull --dry-run
Ievietot failus datubāzē
wp bs content push
Priekšskatīt izmaiņu plānu, neko nemainot:
wp bs content push --dry-run
Izdzēst satura kopai piederošos datubāzes ierakstus un terminus, kas vairs nav failos:
wp bs content push --prune --yes
Izmantojot --prune, Blockstudio vispirms lieto visas failu izmaiņas un pēc tam noņem satura kopai piederošās entītijas, kuru vairs nav failos. Destruktīva dzēšana netiek veikta, ja nav norādīts --yes.
Pārbaudīt statusu
wp bs content status
Tabulā katra failā glabātā entītija tiek uzrādīta kā unchanged, would-update, missing-db, conflict, locked vai orphaned.
Statiskā pirmrenderēšana
Par pašu kešatmiņu skatiet Static Prerendering; šīs komandas to darbina.
Atjaunot novecojušos ierakstus
wp bs prerender warm
Ievieto novecojušos publiskos URL rindā, pēc tam atkārtoti renderē līdz warm.concurrency darbiem
no pastāvīgās atjaunošanas rindas un izvada kopsavilkumu JSON ar queued, processed,
warmed, skipped un failed skaitu. Satura un vietnes izmaiņas automātiski ievieto rindā
jaunus darbus. Palaidiet komandu vēlreiz vai ļaujiet ieplānotajam atjaunotājam apstrādāt
plašāku rindu; ja URL renderēšana neizdodas, tas paliek novecojis un tiek atkal ievietots rindā
nākamajā izpildē. Režīmā graph katras URL atjaunotājs ir izslēgts un komanda neko neievieto rindā.
Ziņot par kešatmiņas stāvokli
wp bs prerender status
Uzrāda aktīvo identitāti, failus, baitus, grafu ierakstus, rindas stāvokli, agrīnās apkalpošanas kartes pārskatu un katras tvēruma zonas trāpījumu, netrāpījumu, izveides un kļūmju skaitītājus.
Iztīrīt kešatmiņu
wp bs prerender purge
Noņem pašreizējās vietnes iepriekš renderētos dokumentus. Nākamajā anonīmajā pieprasījumā vai atjaunošanas reizē tie tiek izveidoti no jauna.
Pārbaudīt un iztīrīt agrīnās apkalpošanas karti
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
map status uzrāda visas instalācijas agrīnās apkalpošanas karti: tās ierakstus
un maršrutus, trūkstošos maršrutu dokumentus, orphaned ierakstus vietnēm,
kuru vairs nav, un dead ierakstus direktorijām, kuru vairs nav. map prune noņem
bāreņu un nederīgos ierakstus un izvada katru noņemto ierakstu kopā ar iemeslu;
--dry-run izvada to pašu pārskatu, neko nemainot. Karte, kas pieder citam rīkam,
netiek aiztikta.
WPML
Valodas konfigurācijas ģenerēšana
wp bs wpml config
wp bs wpml config --file=wp-content/themes/my-theme/wpml-config.xml
Izvada wpml-config.xml, kas deklarē visu reģistrēto bloku teksta laukus tulkošanai un to failu laukus kā pielikumu ID, vai ieraksta to, izmantojot --file. Esošā failā tiek aizstāta tikai sadaļa starp Blockstudio marķieriem. Skatiet WPML, lai uzzinātu, kas tiek deklarēts un kā uzturēt failu atjauninātu.
Bloku tagu migrācija
Atsevišķs skripts pārraksta prefiksu un aizstājvārdu saīsinājumus kanoniskajā
<bs:namespace-slug> rakstībā. Tas neielādē WordPress un neko neraksta,
ja vien nav skaidri norādīts --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
Prefiksu fails sasaista izsaucēja pārvaldītos prefiksus ar sakārtotām nosaukumtelpām. Zināmo
bloku fails ir JSON reģistrēto bloku nosaukumu saraksts. Precīzi aizstājvārdi
nav obligāti. Pārskatā iekļautas deterministiskās atbilstības, jaucējvērtības pirms un pēc,
nezināmie tagi, neviennozīmīgie aizstājvārdi, dinamiskie tagi un piemēri komentāros,
koda nožogotajos blokos, <pre> vai <code> diapazonos.
Skeneris apstrādā sapārotu, ligzdotu un pašnoslēdzošu marķējumu, tostarp literālus
tagus PHP virknēs. Tas saglabā atribūtus un maina tikai tagu nosaukumus.
Komentāri un koda paraugi tiek iekļauti tikai pārskatā. Nesaistīti pielāgotie elementi
tiek ignorēti. Migrācijas lietošana tiek bloķēta, ja paliek nezināmi, neviennozīmīgi vai dinamiski
gadījumi, ja vien izsaucējs apzināti nenorāda --allow-unresolved.
Atkārtoti palaižot komandu pār kanonisko izvadi, izmaiņas netiek veiktas.
Skatiet Migration, lai uzzinātu, kāpēc pastāv kanoniskā rakstība un ko tā atrisina.
Noņemšana
wp bs teardown
Noņem cron notikumus un statiskās pirmrenderēšanas stāvokli, kas pieder instalācijai: pašreizējās vietnes agrīnās apkalpošanas kartes ierakstu, kā arī koplietojamo advanced-cache.php ieliekamo moduli un WP_CACHE deklarāciju, kad vairs nav neviena piederoša ieraksta.
Instalācijās bez spraudņa deaktivizēšanas āķa, piemēram, Composer komplektācijās,
tīrai noņemšanai izmantojiet šo komandu. Konfigurācijas faili paliek neskarti.