Preskoči na vsebino

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

Lupina
wp bs blocks list
Koda
+----------------------------+---------------------+-----------+------------------------+
| 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

Lupina
wp bs blocks list --components

Izpis v obliki JSON

Lupina
wp bs blocks list --format=json

Preverjanje shranjenih polj

Lupina
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

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

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

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

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

Lupina
wp bs pages sync --authoritative --full

Za skripte za uvajanje, ki potrebujejo celotno poročilo:

Lupina
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

Lupina
wp bs db schemas
Koda
+-------------------+-------------+---------+---------------------+
| 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

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

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

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

Za bloke z eno shemo:

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

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

RPC

Izpišite vse funkcije

Lupina
wp bs rpc list
Koda
+-------------------+-------------+--------+----------------+---------+
| 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

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

Izpis je JSON:

JSON
{
  "success": true
}

Parametri se posredujejo kot zastavice --key=value:

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

Cron

Izpišite vsa opravila

Lupina
wp bs cron list
Koda
+-------------------+----------+----------+---------------------+
| 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

Lupina
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

Lupina
wp bs settings list

Pridobite določeno nastavitev

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

Tailwind

Prevedite HTML v CSS

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

Prevedite iz datoteke

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

Upravljanje predpomnilnika

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

SCSS

Prevedite SCSS v CSS

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

Prevedite iz datoteke

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

Polja po meri

Izpišite vsa registrirana polja po meri

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

Sredstva

Izpišite vsa sredstva

Lupina
wp bs assets list

Filtrirajte po vrsti

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

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

Lupina
wp bs content pull

Prenos omejite na eno konfigurirano vrsto objave ali taksonomijo:

Lupina
wp bs content pull --post-type=team_member
wp bs content pull --taxonomy=category

Predogled brez zapisovanja UID-jev ali datotek:

Lupina
wp bs content pull --dry-run

Potisnite datoteke v zbirko podatkov

Lupina
wp bs content push

Predogled načrta uveljavitve brez zapisovanja:

Lupina
wp bs content push --dry-run

Odstranite objave in izraze v zbirki podatkov, ki jih upravlja nabor vsebine in jih ni več v datotekah:

Lupina
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

Lupina
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

Lupina
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

Lupina
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

Lupina
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

Lupina
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

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

Lupina
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

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