CLI
Blockstudio registrerar WP-CLI-kommandon för att hantera block, filbaserade sidor, databasposter, RPC-funktioner, cron-jobb, inställningar och WPML-språkkonfigurationen från terminalen.
Block
Lista alla block
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 |
+----------------------------+---------------------+-----------+------------------------+
Filtrera så att endast komponenter visas
wp bs blocks list --components
Skriv ut som JSON
wp bs blocks list --format=json
Validera lagrade fält
wp bs blocks validate 42
wp bs blocks validate 42 57 --format=json
Kontrollerar det lagrade innehållet för de angivna inläggs-ID:na, inklusive nästlade
innerBlocks, med hjälp av bs_validate_block().
Block renderas inte, synkroniserade mönsterreferenser expanderas inte och inlägg ändras inte.
Okända block utan Blockstudio-tillägg hoppas över.
Standardtabellen listar inläggs-ID, blockets nollbaserade sökväg, blocknamn,
träningskod, fältsökväg, källa och meddelande. JSON innehåller även de ursprungliga
värdena för value och expected. Ett nästlat block kan ha blocksökvägen 0/1
och fältsökvägen cards/2/style; det är två separata sökvägar.
Kommandot avslutas med 0 om inga problem hittas och 1 om problem finns.
JSON-utdata är en vanlig lista, inklusive [] vid lyckat resultat, så att automatisering kan
läsa den även när kommandot avslutas med 1. Inlägg som saknas, ID:n som saknas och
format andra än table eller json ger fel. Alla ID:n kontrolleras innan
valideringen börjar.
Rendera block
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
Renderar registrerade block på samma sätt som en sida och rapporterar varje PHP-notis, varning, föråldring och kastat fel som deras mallar ger upphov till. Ett tema kan köra kommandot i CI för att röktesta sina block mot installerade Blockstudio. Utan namn renderas alla registrerade block, inklusive komponenter.
Varje block renderas genom do_blocks() från en blockkommentar med
blockstudio.attributes, den form som redigeraren lagrar, i WP-CLIs frontendkontext
i stället för infogarens förhandsgranskning. Inget inlägg som hämtats via en fråga ställs in för
renderingen. Dynamiska öar renderar sitt faktiska mallinnehåll i stället för bara sin
platshållare, och oavsiktlig mallutdata utelämnas från rapporten.
Kommandot sparar inte inlägg eller fältvärden i sig, men det kör dina mallar och renderingshooks som vanliga PHP. De kan skriva data, anropa externa tjänster eller ha andra bieffekter. Kör det mot betrodd kod på en särskild testwebbplats; det är ingen skrivskyddad sandlåda.
Renderingsattributen väljs för varje block:
| Fall | Attribut |
|---|---|
example |
example.attributes för blockets block.json, alltså värdena som infogarens förhandsgranskning använder. |
defaults |
default för varje fält. Används för block utan example.attributes; kommandot skriver en rad för varje fält. |
attributes |
Värdena i --attributes ersätter exemplet. |
--attributes tar emot ett JSON-objekt med fältvärden som nycklas efter lagringsnyckel, eller
@ och sökvägen till en fil som innehåller ett sådant objekt, och kräver exakt ett blocknamn.
Använd det för att nå mallgrenar som exemplet inte täcker, till exempel en
variant. Exempelvärden som bara genererar platshållarbilder i infogarens förhandsgranskning hoppas över, och
innerBlocks från exemplet renderas inte.
+---------------------+----------+------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------+------+
| 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 |
+---------------------+----------+------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------+------+
Tabellen innehåller en rad per problem. JSON-utdata är en lista med en post per renderat block, även block utan problem, så att automatisering kan läsa vilket fall som användes:
[
{
"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 är Notice, Warning, Deprecated eller Error. Ett problem
som upprepas på samma fil och rad, till exempel i en loop, rapporteras en gång per
block. Problem som tystas med @ rapporteras inte. WordPress ger upphov till egna
föråldringsnotiser, till exempel de från _deprecated_function(), endast när
WP_DEBUG är aktiverat.
Kommandot avslutas med 0 när inga problem hittas och 1 annars. Okända
blocknamn, oläsbara eller ogiltiga --attributes och format andra än
table eller json ger fel, och alla namn kontrolleras innan det första blocket
renderas.
Sidor
Synkronisering av filbaserade sidor sker uttryckligen. Vanliga WordPress-förfrågningar utför aldrig en fullständig upptäckt av sidor eller skriver sidinlägg. En kall körning kan läsa samlingsmanifest en gång för att återställa rutter, utan att synkronisera innehåll.
wp bs pages sync
Kommandot stämmer av hela den önskade förteckningen och rapporterar upptäckta, skapade, uppdaterade, oförändrade, låsta, bevarade, borttagna och misslyckade sidor. Identiska fingeravtryck leder inte till några skrivningar av inlägg eller inläggsmetadata.
Tabellutdata anger ändrade, låsta, innehållsbevarade och borttagna sidor med
deras inläggs-ID:n. JSON innehåller poster för pages.<name>.preserved,
pages.<name>.overwritten och removedPages med sidnamn, nyckel,
inläggs-ID och rensningsåtgärd. Ett identiskt inlägg efter sammanslagning med nycklar rapporteras
som oförändrat utan att en revision skapas eller dess ändringstid uppdateras.
Befintliga publiceringsstatusar bevaras; ersättningar av titlar och sluggar som ägs av filer skrivs ut som varningar. Se Ägarskap för inläggsfält.
Använd --authoritative för att ersätta hanterat innehåll i stället för att bevara nycklat
redigerarinnehåll, och --full för att rapportera körningen som en fullständig avstämning
oavsett den lagrade källidentiteten. Hela inventeringen jämförs vid varje körning:
wp bs pages sync --authoritative --full
För distributionsskript som behöver hela rapporten:
wp bs pages sync --format=json
Varje sida som kommandot tolkar kontrolleras för attribut som blocken lagrar
men aldrig renderar: attribut som ett Blockstudio-block varken deklarerar som fält
eller skickar vidare till sitt rotelement, till exempel ett odeklarerat class. Tabellutdata
visar en varning per sida och block, kolumnen dropped räknar dem,
och rapporten JSON listar dem under pages.<name>.droppedAttributes. Sidor
där källan inte ändrats tolkas inte igen. De rapporteras därför nästa gång de ändras,
eller vid den första synkroniseringen efter en uppgradering som ändrar tolken.
Kommandot avslutas med felstatus om upptäckten eller avstämningen rapporterar ett fel. Se Sidor för avtalet om PHP API och distributionsidentitet.
Databas
Lista scheman
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-åtgärder
# 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
För block med ett enda schema är schemanamnet som standard default:
wp bs db list my-theme/leads
Migrera poster från JSONC till Storh
Använd migrate när ett schema redan har en db/{schema}.jsonc-fil och du vill
flytta posterna till filbackend för Storh:
wp bs db migrate my-theme/app subscribers --to=storh
För block med ett schema:
wp bs db migrate my-theme/app --to=storh
Kommandot bevarar heltals-ID:n för poster, skriver till
uploads/blockstudio/db/{block-scope}/{schema}/, bygger om index för Storh,
verifierar mållagret och låter källfilen .jsonc ligga kvar.
Utdataformat
Alla listkommandon stöder --format=table (standard), --format=json och
--format=csv:
wp bs db list my-theme/app subscribers --format=json
RPC
Lista alla funktioner
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|
+-------------------+-------------+--------+----------------+---------+
Anropa en funktion
wp bs rpc call my-theme/app subscribe --email=user@example.com
Utdata är JSON:
{
"success": true
}
Parametrar skickas som flaggor för --key=value:
wp bs rpc call my-theme/app load_more --offset=10 --limit=5
Cron
Lista alla jobb
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 |
+-------------------+----------+----------+---------------------+
Kör ett jobb manuellt
wp bs cron run my-theme/app cleanup
Detta kör återanropet direkt, oavsett schemat. Användbart för testning och felsökning.
Inställningar
Visa alla inställningar
wp bs settings list
Hämta en specifik inställning
wp bs settings get tailwind/enabled
wp bs settings get assets/enqueue
Tailwind
Kompilera HTML till CSS
wp bs tailwind compile '<div class="flex items-center p-4">'
Kompilera från fil
wp bs tailwind compile --file=template.html
Cachehantering
wp bs tailwind cache path # show cache directory
wp bs tailwind cache clear # clear compiled cache
SCSS
Kompilera SCSS till CSS
wp bs scss compile '$color: red; .test { color: $color; }'
Kompilera från fil
wp bs scss compile --file=styles.scss
Anpassade fält
Lista alla registrerade anpassade fält
wp bs fields list
+-------+----------------+---------------------------+
| name | title | fields |
+-------+----------------+---------------------------+
| hero | Hero Section | heading, description, cta |
| card | Card | title, image, link |
+-------+----------------+---------------------------+
Resurser
Lista alla resurser
wp bs assets list
Filtrera efter typ
wp bs assets list --type=global
wp bs assets list --type=admin
wp bs assets list --type=editor
wp bs assets list --type=registered
Skriptning
Alla kommandon stöder --format=json för enkel vidarebefordran:
# 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 exporterar tillåtlistat innehåll i WordPress till filer och tillämpar filerna på databasen. Det är uttryckligt och styrs av CLI; synkronisering sker inte vid sidinläsning eller initiering av adminpanelen.
Se Content Sync för konfiguration, filformat och vägledning om när filbaserat databas-innehåll passar bra.
Hämta databasinnehåll till filer
wp bs content pull
Begränsa hämtningen till en konfigurerad inläggstyp eller taxonomi:
wp bs content pull --post-type=team_member
wp bs content pull --taxonomy=category
Förhandsgranska utan att skriva UID:er eller filer:
wp bs content pull --dry-run
Skicka filer till databasen
wp bs content push
Förhandsgranska tillämpningsplanen utan att skriva:
wp bs content push --dry-run
Rensa databasposter och termer som ägs av innehållsuppsättningen och inte längre finns i filer:
wp bs content push --prune --yes
Med --prune tillämpar Blockstudio först alla filändringar och tar sedan bort entiteter som ägs av innehållsuppsättningen och inte längre finns i filerna. En destruktiv rensning körs inte utan --yes.
Kontrollera status
wp bs content status
Tabellen rapporterar varje filbaserad entitet som unchanged, would-update, missing-db, conflict, locked eller orphaned.
Statisk förgenerering
Se Statisk förgenerering för själva cachen; dessa kommandon hanterar den.
Värm inaktuella poster
wp bs prerender warm
Köar inaktuella offentliga URL:er, renderar sedan om upp till warm.concurrency jobb från
den beständiga uppvärmningskön och skriver ut en sammanfattning av typen JSON med antal för queued, processed,
warmed, skipped och failed. Ändringar av innehåll och webbplats köar automatiskt ersättningsjobb. Kör kommandot igen, eller låt den schemalagda uppvärmningen köras, för att beta av en större kö. En URL som inte kan renderas förblir inaktuell och köas igen vid nästa körning. I läget graph är uppvärmningen per URL avstängd och köar inga jobb.
Rapportera cachens tillstånd
wp bs prerender status
Rapporterar den aktiva identiteten, filer, byte, grafposter, köstatus, rapporten över tidig visning samt träff-, miss-, bygg- och felräknare per omfång.
Rensa cachen
wp bs prerender purge
Tar bort den aktuella webbplatsens förgenererade dokument. Nästa anonyma förfrågan eller uppvärmningskörning bygger upp dem igen.
Kontrollera och rensa kartan för tidig visning
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
map status rapporterar kartan för tidig visning för hela installationen: dess poster och
rutter, ruttdokument som saknas, poster för orphaned vars webbplats inte längre
finns och poster för dead vars katalog har försvunnit. map prune tar bort
föräldralösa och inaktuella poster och skriver ut varje borttagen post med sin orsak;
--dry-run skriver ut samma rapport utan att göra ändringar. En karta som ägs av ett annat
verktyg lämnas orörd.
WPML
Skapa språkkonfigurationen
wp bs wpml config
wp bs wpml config --file=wp-content/themes/my-theme/wpml-config.xml
Skriver ut en wpml-config.xml som anger textfälten i varje registrerat
block för översättning och dess filfält som bilage-ID:n, eller skriver den med
--file. I en befintlig fil ersätts endast avsnittet mellan markörerna Blockstudio.
Se WPML för vad som deklareras och hur filen hålls uppdaterad.
Migrering av blocktaggar
Ett fristående skript skriver om prefix- och aliasförkortningar till den kanoniska
stavningen <bs:namespace-slug>. Det läser inte in WordPress och skriver ingenting
om inte --apply uttryckligen anges:
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
Prefixfilen mappar anroparägda prefix till ordnade namnrymder. Filen med kända
block är en JSON-lista över registrerade blocknamn. Exakta alias är valfria. Rapporten innehåller deterministiska mappningar, hashvärden före och efter, okända taggar, tvetydiga alias och exempel i kommentarer,
kodblock, <pre>– eller <code>-intervall.
Skannern hanterar parvisa, nästlade och självstängande taggar, även bokstavliga
taggar i PHP-strängar. Den bevarar attribut och ändrar endast taggnamn.
Kommentarer och kodexempel tas bara med i rapporten. Orelaterade anpassade element
ignoreras. En migrering kan inte tillämpas medan okända, tvetydiga eller dynamiska
fall återstår, om inte anroparen avsiktligt skickar --allow-unresolved.
Om kommandot körs igen på kanonisk utdata görs inga ändringar.
Se Migrering för varför den kanoniska stavningen finns och vad den löser.
Avinstallation
wp bs teardown
Tar bort de cron-händelser och det statiska förgenereringstillstånd som installationen äger: den aktuella webbplatsens post i kartan för tidig visning samt det delade tillägget advanced-cache.php
och deklarationen WP_CACHE när den sista ägda posten har försvunnit.
Installationer utan en hook för avaktivering av tillägg, till exempel upplägg
med Composer, använder detta för en ren avinstallation. Konfigurationsfiler lämnas orörda.