CLI per WordPress

WordPress CLI: deploy e git per il tuo sito

La CLI nucleo esporta il sito WordPress in una cartella, la versiona con git e la riporta sul sito con push. Un comando per ogni passo.

Node 20+GitDesign tokenScreenshot
Il problema

Il sito vive nel database, non nei file

Il sito WordPress vive nel database. Le modifiche fatte in wp-admin non passano dalla revisione di un repository, e il deploy diventa un lavoro manuale.

Nucleo mette pagine, token e componenti in file. La cartella va in git, la CLI la sincronizza con il sito, e il motore qualità controlla ogni push prima della pubblicazione.

Funzioni

Cosa trovi nella CLI nucleo

Comandi per ogni passo

pull, push, tokens, component, media, screenshot e critical. Il sito si scarica e si carica con due comandi.

Git come flusso di lavoro

nucleo pull scrive il sito in una cartella. Commit, branch e review sono quelli del tuo repository.

Token dal design

tokens suggest legge il CSS del design e propone i token per i valori usati almeno tre volte. push --use-tokens sostituisce i valori con i token.

Componenti in locale

component new crea un plugin con l’intestazione richiesta. component deploy lo copia nel sito locale o di sviluppo, dopo il controllo.

Agenti via STDIO

nucleo mcp fa da proxy STDIO verso il server MCP del sito. Il client AI avvia il comando e lavora con i permessi dell’utente collegato.

Screenshot e CSS critico

screenshot salva le pagine a 390 e 1440 px. critical genera il CSS critico. Entrambi usano Playwright, dipendenza facoltativa.

Come si usa

Esportare, modificare e riportare il sito

  1. 1
    Configura il sito

    Serve Node 20 o superiore. Imposta sito, utente e Application Password di WordPress in nucleo.config.json, oppure nelle variabili NUCLEO_SITE, NUCLEO_USER e NUCLEO_APP_PASSWORD.

  2. 2
    Esporta e versiona

    nucleo pull nucleo-site scarica pagine, token e contenuti nella cartella. Fai commit con git come per qualsiasi progetto.

  3. 3
    Controlla e pubblica

    nucleo push nucleo-site --dry-run valida ogni documento come il push vero. Senza errori, lancia il push senza --dry-run.

Domande

Domande sulla CLI WordPress

La CLI di Nucleo sostituisce wp-cli?
No. Il plugin aggiunge comandi wp nucleo a wp-cli. La CLI nucleo è un programma separato che lavora sulla cartella del sito.
Serve Node sul server del sito?
No. Node 20 o superiore serve dove lavori sul progetto. Il sito riceve le richieste con l’Application Password di WordPress.
Come si versiona un sito WordPress con git?
nucleo pull scrive pagine, token e contenuti in file. Git tiene la storia, e le modifiche si leggono nei diff.
Come si distribuisce un componente WordPress?
nucleo component deploy copia il plugin nel sito locale o di sviluppo, dopo il check. Su staging e produzione il componente arriva con la migrazione o con il deploy git.
Come si estraggono i token da un design?
nucleo tokens suggest design.html propone un token per ogni valore usato almeno tre volte. Il comando non scrive sul sito.
Il push può pubblicare pagine con errori di qualità?
No. Una segnalazione bloccante ferma la pubblicazione. La decide una persona con --acknowledge, mai l’agente.
Quali requisiti servono?
Node 20 o superiore e una Application Password di un utente WordPress. Il plugin Nucleo richiede WordPress 6.9 o successivo e PHP 8.2 o successivo.
Inizia

Porta il sito nel tuo repository

Il plugin gratuito è sul repository di WordPress. Configura la CLI con il sito e una Application Password, poi esporta il primo pull.