Comandi comuni

Questo testo è stato tradotto utilizzando l’IA. Se desideri visualizzare il testo originale in inglese, fai clic qui.

Esistono diversi comandi che possono risultare utili quando si lavora con il proprio sito. Questi comandi e i relativi parametri più comuni sono elencati di seguito. Sono disponibili anche molti altri comandi utili, e queste sezioni non li includono tutti. Per ulteriori informazioni, consulta la Guida ai comandi CLI per sviluppatori di WordPress.org.

Gestione utenti

Utilizza i seguenti comandi per gestire gli utenti locali del tuo sito. Tieni presente che la modifica degli aspetti relativi agli utenti tramite CLI non cambierà le impostazioni degli account utente WordPress.com eventualmente associati agli account locali.

wp user list

Elenca tutti gli utenti del sito. Se hai molti utenti, potresti voler limitare l’elenco a ruoli specifici utilizzando il flag --role:

wp user list –role=adminstrator

wp user get {USER ID/NAME/EMAIL}

Restituisce un utente specifico, tramite ID utente, nome utente o indirizzo e-mail.

wp user create {NAME} {USER EMAIL} –role={ROLE}

Crea un nuovo utente con il nome, l’indirizzo e-mail e il ruolo definiti.

Questo comando non crea un utente WordPress.com corrispondente. Se utilizzi WordPress.com Secure Sign-On (SSO), dovresti invece creare l’utente locale invitando un utente tramite Utenti > Aggiungi nuovo. In questo modo verranno creati sia un account WordPress.com che un utente locale.

wp user update {USER ID/NAME/EMAIL} –{KEY}={VALUE}

Aggiorna un utente in base all’ID utente, al nome o all’indirizzo e-mail. Aggiorna l’insieme di coppie chiave/valore specificato. 

Le chiavi includono display_name, user_email, role e user_pass

Nota: non sarà possibile aggiornare lo user_login di un utente con il comando wp user update. L’aggiornamento dello user_login richiede invece l’uso di wp search-replace. Questa modifica, tuttavia, non è consigliata poiché esegue sostituzioni parziali. Ad esempio: se ci sono due utenti con i nomi utente “techie” e “nontechie”, sostituendo “techie” con “sense” si otterrà “sense” e “nonsense”.

Se desideri comunque sostituire uno user_login, il comando da utilizzare è:

wp --skip-plugins --skip-themes search-replace "old username" "new username" *users --include-columns=user_login,user_nicename --dry-run

Gestire plugin e temi

Utilizza i seguenti comandi per gestire i tuoi plugin e temi. Quando lavori con plugin e temi, tieni presente che lo slug correlato non sempre corrisponde al nome del plugin/tema.

Se riscontri problemi con un plugin o un tema, puoi iniziare il comando con wp --skip-themes --skip-plugins per eseguire i comandi nonostante i conflitti.

Puoi trovare maggiori informazioni sui comandi skip qui sotto.

wp plugin/theme list

Elenca tutti i plugin/temi installati sul sito e il loro stato. Da questi elenchi troverai gli slug dei plugin e dei temi installati, che potrai utilizzare per eseguire i comandi riportati di seguito.

wp plugin/theme activate {SLUG}

Attiva il plugin/tema specificato.

Per disattivare un tema, è necessario attivarne un altro al suo posto.

wp plugin deactivate {SLUG}

Disattiva il plugin specificato.

wp plugin/theme delete {SLUG}

Elimina il plugin/tema specificato.

Non è possibile eliminare un tema attivo o temi gestiti con questo comando. Per rimuovere un tema attivo, passa prima a un tema diverso, quindi elimina il tema desiderato. Per rimuovere i temi gestiti, è possibile farlo tramite SFTP.

wp plugin/theme install {SLUG or URL TO INSTALLATION_FILE}

Installa un plugin/tema dal repository WordPress.org in base allo slug o tramite un percorso URL a un file di installazione .zip.

Non è possibile sovrascrivere un plugin/tema esistente a meno che non si esegua il comando con il flag --force. È possibile utilizzarlo per aggiornare i plugin e correggere cartelle di plugin danneggiate.

Per attivare automaticamente un plugin dopo l’installazione, includi il flag --activate.

wp plugin/theme update {SLUG}

Aggiorna il plugin/tema specificato, se disponibile. Non è possibile utilizzare questo comando per aggiornare plugin/temi gestiti.

È anche possibile utilizzare il flag --all per aggiornare tutti i plugin/temi.

wp plugin auto-updates {COMMAND} {PLUGIN SLUG}

Visualizza lo stato degli aggiornamenti dei plugin oppure abilita/disabilita gli aggiornamenti per un plugin specifico.

I COMANDI disponibili sono status, enable, disable.

Non è possibile disabilitare gli aggiornamenti per plugin o temi gestiti.

Gestire Jetpack

Utilizza i seguenti comandi per regolare i moduli di Jetpack, verificare la connessione di Jetpack o risolvere problemi relativi a Jetpack.

wp jetpack module list

Elenca i moduli di Jetpack e i relativi stati.

wp jetpack module activate {MODULE NAME}

Attiva il modulo Jetpack specificato.

Puoi anche usare all al posto di {MODULE NAME}

wp jetpack module deactivate {MODULE NAME}

Disattiva il modulo Jetpack specificato.

Puoi anche usare all al posto di {MODULE NAME}

wp jetpack status

Mostra lo stato di Jetpack, incluso quale account utente è la connessione principale (dovrebbe essere sempre il proprietario del sito).

È possibile aggiungere un parametro aggiuntivo, full, per visualizzare i dettagli completi, tra cui la versione di Jetpack, la versione di WordPress e lo stato dei moduli.

Gestire le impostazioni del sito

Utilizza i seguenti comandi per gestire vari aspetti del tuo sito e degli utenti.

wp site empty –yes

Svuota un sito dei suoi contenuti (articoli e pagine).

wp site empty –uploads –yes

Svuota il sito, inclusi i file multimediali.

I comandi wp site non eliminano temi o plugin, né reimpostano un tema o cancellano le impostazioni dei plugin. Se hai bisogno di reimpostare completamente il tuo sito, contatta il supporto WordPress.com.

wp option get {OPTION}

Restituisce il valore di un’opzione.

wp option update {OPTION} {VALUE}

Aggiorna il valore di un’opzione.

wp option add {OPTION} {VALUE}

Aggiungi una nuova opzione.

wp option delete {OPTION}

Elimina un’opzione.

Quando si lavora con i comandi wp option, se nel terminale viene visualizzato il seguente errore, potrebbe significare che la tabella delle opzioni è stata danneggiata:

One or more database tables are unavailable. The database may need to be repaired

È possibile ripristinare la tabella riportando la tabella SQL del sito a un’ultima copia funzionante. Tieni presente che questa operazione annullerà tutte le modifiche mutabili al database successive al punto di ripristino e potrebbe comportare la perdita di dati.

Per ripristinare una tabella SQL:

1. Nella bacheca del sito, vai su Jetpack > Registro attività.
2. Seleziona un punto di backup a cui ripristinare.
3. Deseleziona tutte le caselle tranne Database del sito (SQL).
4. Fai clic su Conferma ripristino.

wp role list

Restituisce un elenco dei ruoli

wp role reset {ROLE}

Ripristina il ruolo specificato. È possibile elencare più ruoli (senza virgole)

wp reset role administrator editor

È anche possibile sostituire {ROLE} con --all per ripristinarli tutti contemporaneamente

Gestire i contenuti

Puoi utilizzare i seguenti comandi per gestire i contenuti del tuo sito, inclusi articoli/pagine, menu e media.

wp post list

Restituisce un elenco di articoli del blog.

Con questo comando è possibile utilizzare diversi flag, tra cui:

--format={FORMAT}

--posts_per_page={#}

--post_type={TYPE}

I tipi di articolo possibili includono posts, pages, attachments e products.

È possibile utilizzare più flag contemporaneamente.

wp post list --post_type=posts,pages --format=count

wp post update {POST_ID} –{KEY}={VALUE}

Aggiorna le informazioni dell’articolo.

wp post update123 --post_status=draft

wp post delete {POST_ID}

Elimina un articolo.

wp post exists {POST_ID}

Verifica se un articolo esiste.

wp menu list

Elenca i menu del sito.

wp menu item list {TERM_ID}

Elenca le voci di un menu specifico.

wp menu item update {MENU_ITEM_PARENT_ID}

Aggiorna una voce di menu specifica.

wp media regenerate

Rigenera le miniature dei media quando il modulo Jetpack Photon è disattivato.

Puoi utilizzare il flag --only-missing per saltare le dimensioni delle immagini già esistenti.

Risoluzione dei problemi del sito

Puoi utilizzare i seguenti comandi per risolvere i problemi sul tuo sito. Verificare la presenza di errori PHP può aiutarti a identificare le cause degli errori sul tuo sito, oppure puoi usare i comandi wp wpcomsh per eseguire rapidamente controlli sui conflitti tra plugin o per modificare l’utilizzo delle versioni gestite dei plugin.

wp php-errors

Visualizza i log degli errori in WP-CLI.

Questo comando mostra solo gli errori PHP, non quelli di altri linguaggi come HTML, Javascript o CSS. Per visualizzare questi altri errori, utilizza l’Inspector del browser.

Puoi aggiungere il flag --limit per ridurre il numero di errori mostrati e migliorare la leggibilità.

wp php-errors –limit10

wp wpcomsh deactivate-user-plugins

Disattiva i plugin dell’utente.

Puoi utilizzare il flag --interactive per forzare la conferma per ciascun plugin.

Questo comando non disattiverà Akismet, Jetpack o i plugin ecommerce gestiti.

wp wpcomsh reactivate-user-plugins

Riattiva i plugin dell’utente.

Puoi utilizzare il flag --interactive per forzare la conferma per ciascun plugin.

wp wpcomsh persistent-data {DATA}

Restituisce i dati persistenti (che Jetpack utilizza per verificare le funzionalità del sito).

Le opzioni DATA disponibili includono:

WPCOM_PLAN_EXPIRATION

JETPACK_BLOG_TOKEN

WPCOM_PURCHASES

WPCOM_PUBLIC_COMING_SOON

wp wpcomsh plugin use-managed {SLUG}

Utilizza una versione gestita (con collegamento simbolico) di un plugin.

Questo comando rimuoverà le versioni esistenti non gestite e le sostituirà con versioni gestite. È disponibile per amp, classic-editor, coblocks, crowdsignal-forms, full-site-editing, gutenberg, layout-grid, page-optimize, wp-seo, woocommerce, le estensioni WooCommerce dal Marketplace di WordPress.com e i plugin inclusi nel piano Commerce.

Puoi utilizzare il flag --remove-existing per saltare il passaggio di conferma.

wp wpcomsh theme use-managed {SLUG}

Utilizza una versione gestita (con collegamento simbolico) di un tema.

Questo comando rimuoverà le versioni esistenti non gestite e le sostituirà con versioni gestite. È disponibile per tutti i temi WordPress.com, Storefront e qualsiasi tema Twenty * (es: Twenty Twenty Two).

Puoi utilizzare il flag --remove-existing per saltare il passaggio di conferma.

wp wpcomsh plugin use-unmanaged {SLUG}

Utilizza una versione non gestita (senza collegamento simbolico) di un plugin.

Questo comando rimuoverà le versioni esistenti gestite e le sostituirà con versioni non gestite dal repository dei plugin di WordPress.org. Non funzionerà per le estensioni WooCommerce dal Marketplace di WordPress.com e per i plugin inclusi nel piano Commerce. Per ottenere la versione non gestita, dovrai installare questi plugin manualmente.

Puoi utilizzare il flag --remove-existing per saltare il passaggio di conferma e il flag --version={X.Y.Z} per definire la versione da installare.

wp wpcomsh theme use-unmanaged {SLUG}

Utilizza una versione non gestita (non collegata tramite symlink) di un tema.

Questo comando rimuoverà le versioni gestite esistenti e le sostituirà con versioni non gestite dal repository dei temi di WordPress.org, se disponibili.

Puoi utilizzare il flag --remove-existing per saltare il passaggio di conferma e il flag --version={X.Y.Z} per definire la versione da installare.

Il plugin must-use WordPress.com Site Helper o wpcomsh viene eseguito sui siti con funzionalità di hosting attivate per farli funzionare senza problemi nell’ecosistema WordPress.com.

wp cache flush

Svuota la cache.

Questo comando non è pensato come soluzione per i problemi e può nascondere le cause alla radice. Utilizzalo con cautela. Lo svuotamento della cache può anche rallentare il sito mentre la cache viene ricostruita al caricamento della pagina.

Saltare plugin e temi

Potresti voler saltare i plugin, e talvolta i temi, durante l’esecuzione dei comandi CLI. Questo può essere utile per risolvere conflitti o per aggirare le restrizioni imposte dai plugin, come il controllo sui ruoli.

• --skip-plugins può essere aggiunto prima di qualsiasi comando e salta i plugin
• --skip-themes può essere aggiunto prima di qualsiasi comando e salta i temi

Puoi utilizzare questi comandi insieme. Puoi anche utilizzare questi comandi con gli slug per escludere plugin o temi specifici. Questo può essere utile per escludere gli effetti di determinati plugin o temi quando la disattivazione non è possibile.

Ad esempio:

wp --skip-plugins=woocommerce, code-snippets, elementor-pro plugin list