|
| 1 | +--- |
| 2 | +layout: default |
| 3 | +title: Interfaccia da linea di comando per WordPress |
| 4 | +--- |
| 5 | + |
| 6 | +[WP-CLI](https://wp-cli.org/) è un insieme di strumenti da linea di comando per la gestione delle installazioni [WordPress](https://wordpress.org/). Potete aggiornare plugin, configurare installazioni multisito e molto altro, senza utilizzare un browser web. |
| 7 | + |
| 8 | +Per rimanere aggiornati, seguite [@wpcli su Twitter](https://twitter.com/wpcli) oppure [iscrivetevi alla nostra newsletter](http://wp-cli.us13.list-manage.com/subscribe?u=0615e4d18f213891fc000adfd&id=8c61d7641e). |
| 9 | + |
| 10 | +[](https://travis-ci.org/wp-cli/wp-cli) [](https://gemnasium.com/github.com/wp-cli/wp-cli) [](http://isitmaintained.com/project/wp-cli/wp-cli "Average time to resolve an issue") [](http://isitmaintained.com/project/wp-cli/wp-cli "Percentage of issues still open") |
| 11 | + |
| 12 | +<div style=" |
| 13 | + border: 1px solid #7AD03A; |
| 14 | + -webkit-border-radius: 5px; |
| 15 | + -moz-border-radius: 5px; |
| 16 | + border-radius: 5px; |
| 17 | + padding-left: 10px; |
| 18 | + padding-right: 10px; |
| 19 | +"> |
| 20 | + <p><strong>Un orientamento RESTful di WP-CLI</strong>, mira a sbloccare le potenzialità WP REST API dalla linea di comando. Progetto sostenuto da Pressed, Chris Lema, Human Made, Pagely, Pantheon e molti altri. <a href="https://wp-cli.org/restful/">Scopri di più →</a></p> |
| 21 | +</div> |
| 22 | + |
| 23 | +Collegamenti rapidi: [Utilizzo](#utilizzo) | [Installazione](#installazione) | [Supporto](#supporto) | [Estendere](#estendere) | [Contribuire](#contribuire) | [Crediti](#crediti) |
| 24 | + |
| 25 | +## Utilizzo |
| 26 | + |
| 27 | +L'obiettivo di WP-CLI è quello di fornire un interfaccia da linea di comando per le azioni che normalmente si possono effettuare attraverso l'area amministrativa. Per esempio, `wp plugin install --activate` ([doc](https://wp-cli.org/commands/plugin/install/)) vi permette di installare ed attivare un plugin di WordPress: |
| 28 | + |
| 29 | +```bash |
| 30 | +$ wp plugin install rest-api --activate |
| 31 | +Installing WordPress REST API (Version 2) (2.0-beta13) |
| 32 | +Downloading install package from https://downloads.wordpress.org/plugin/rest-api.2.0-beta13.zip... |
| 33 | +Unpacking the package... |
| 34 | +Installing the plugin... |
| 35 | +Plugin installed successfully. |
| 36 | +Activating 'rest-api'... |
| 37 | +Success: Plugin 'rest-api' activated. |
| 38 | +``` |
| 39 | + |
| 40 | +WP-CLI include anche dei comandi per molte operazioni che normalmente non sarebbe possibile svolgere nell'area amministrativa di WordPress. Per esempio, `wp transient delete-all` ([doc](https://wp-cli.org/commands/transient/delete-all/)) vi permetterà di eliminare uno o tutti i transienti: |
| 41 | + |
| 42 | +```bash |
| 43 | +$ wp transient delete-all |
| 44 | +Success: 34 transients deleted from the database. |
| 45 | +``` |
| 46 | + |
| 47 | +Per una più completa panoramica sull'utilizzo di WP-CLI, vi invitiamo a leggere la [Quick Start guide](https://wp-cli.org/docs/quick-start/). |
| 48 | + |
| 49 | +Vi sentite già a vostro agio con le basi? Andate dritti alla [lista completa dei comandi](https://wp-cli.org/commands/) per le informazioni dettagliate su come gestire temi e plugin, importare ed esportare dati, operare ricerche e sostituzioni nel database ed altro. |
| 50 | + |
| 51 | +## Installazione |
| 52 | + |
| 53 | +Come metodo di installazione, raccomandiamo di scaricare il Phar. Se vi occorre, leggete la nostra documentazione sui [metodi alternativi di installazione](https://wp-cli.org/docs/installing/). |
| 54 | + |
| 55 | +Prima di procedere con l'installazione di WP-CLI, vi preghiamo di assicurarvi che il vostro ambiente soddisfi i minimi requisiti richiesti: |
| 56 | + |
| 57 | +- Ambiente UNIX-like (OS X, Linux, FreeBSD, Cygwin); in ambienti Windows il supporto è limitato |
| 58 | +- PHP 5.3.29 o successivo |
| 59 | +- WordPress 3.7 o successivo |
| 60 | + |
| 61 | +Una volta che avrete verificato i requisiti, scaricate il file [wp-cli.phar](https://raw.github.com/wp-cli/builds/gh-pages/phar/wp-cli.phar) mediante `wget` o `curl`: |
| 62 | + |
| 63 | +```bash |
| 64 | +$ curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar |
| 65 | +``` |
| 66 | + |
| 67 | +Successivamente, controllate il suo funzionamento: |
| 68 | + |
| 69 | +```bash |
| 70 | +$ php wp-cli.phar --info |
| 71 | +``` |
| 72 | + |
| 73 | +Per richiamare WP-CLI dalla linea di comando scrivendo `wp`, rendete il file eseguibile e spostatelo nel vostro PATH, ad esempio: |
| 74 | + |
| 75 | +```bash |
| 76 | +$ chmod +x wp-cli.phar |
| 77 | +$ sudo mv wp-cli.phar /usr/local/bin/wp |
| 78 | +``` |
| 79 | + |
| 80 | +Se l'installazione di WP-CLI è andata a buon fine, lanciando il comando `wp --info`, dovreste vedere qualcosa di simile: |
| 81 | + |
| 82 | +```bash |
| 83 | +$ wp --info |
| 84 | +PHP binary: /usr/bin/php5 |
| 85 | +PHP version: 5.5.9-1ubuntu4.14 |
| 86 | +php.ini used: /etc/php5/cli/php.ini |
| 87 | +WP-CLI root dir: /home/wp-cli/.wp-cli |
| 88 | +WP-CLI packages dir: /home/wp-cli/.wp-cli/packages/ |
| 89 | +WP-CLI global config: /home/wp-cli/.wp-cli/config.yml |
| 90 | +WP-CLI project config: |
| 91 | +WP-CLI version: 0.23.0 |
| 92 | +``` |
| 93 | + |
| 94 | +### Aggiornamenti |
| 95 | + |
| 96 | +Potete aggiornare WP-CLI attraverso il comando `wp cli update` ([doc](https://wp-cli.org/commands/cli/update/)), oppure ripetendo i passi descritti per l'istallazione. |
| 97 | + |
| 98 | +Volete vivere sul filo del rasoio? Lanciate `wp cli update --nightly` per usare la versione quotidiana notturna di WP-CLI. La versione quotidiana notturna è sufficientemente stabile da essere utilizzata negli ambienti di sviluppo, e include sempre le ultime e migliori caratteristiche. |
| 99 | + |
| 100 | +### Autocompletamento |
| 101 | + |
| 102 | +WP-CLI inoltre mette a disposizione uno script per l'autocompletamento per Bash e ZSH. Basta scaricare [wp-completion.bash](https://github.com/wp-cli/wp-cli/raw/master/utils/wp-completion.bash) a attivarlo da `~/.bash_profile`: |
| 103 | + |
| 104 | +```bash |
| 105 | +source /FULL/PATH/TO/wp-completion.bash |
| 106 | +``` |
| 107 | + |
| 108 | +Alla fine del suo utilizzo, non dimenticate di reimpostare il profilo originale digitando `source ~/.bash_profile`. |
| 109 | + |
| 110 | +Se state usando la shell zsh, avrete bisogno di caricare ed avviare `bashcompinit` prima di impostare il profilo. Eseguite i seguenti comandi dalla vostra `.zshrc`: |
| 111 | + |
| 112 | +```bash |
| 113 | +autoload bashcompinit |
| 114 | +bashcompinit |
| 115 | +source /FULL/PATH/TO/wp-completion.bash |
| 116 | +``` |
| 117 | + |
| 118 | +## Supporto |
| 119 | + |
| 120 | +I manutentori e i contributori di WP-CLI sono volontari, hanno limitate disponibilità da dedicare al supporto generale. Primariamente, cercate delle risposte nelle seguenti risorse: |
| 121 | + |
| 122 | +- [Problemi comuni e le loro soluzioni](https://wp-cli.org/docs/common-issues/) |
| 123 | +- [Portale della documentazione](https://wp-cli.org/docs/) |
| 124 | +- [Problemi segnalati o estinti su Github](https://github.com/wp-cli/wp-cli/issues?utf8=%E2%9C%93&q=is%3Aissue) |
| 125 | +- [Estratti di runcommand](https://runcommand.io/excerpts/) |
| 126 | +- [Forum di WordPress su StackExchange](http://wordpress.stackexchange.com/questions/tagged/wp-cli) |
| 127 | + |
| 128 | +Se non trovare delle risposte in questi posti, entrate al canale `#cli` su [WordPress.org Slack organization](https://make.wordpress.org/chat/) per vedere se qualche membro della comunità può offrirvele. |
| 129 | + |
| 130 | +Le questioni su Github servono a tracciare migliorie e i bachi dei comandi esistenti, non per il supporto generico. Prima di sottoporre un rapporto su un baco, vi preghiamo di [rileggere le nostre procedure](https://wp-cli.org/docs/bug-reports/) per fare in modo che il vostro problema sia indirizzato in modo tempestivo. |
| 131 | + |
| 132 | +Vi preghiamo di non richiedere supporto su Twitter. Twitter non è un mezzo accettabile di supporto perché: 1) è difficile gestire una conversazione in meno di 140 caratteri, e 2) Twitter non è un luogo dove altre persone con il vostro stesso problema possano reperire facilmente la risposta tra le conversazioni. |
| 133 | + |
| 134 | +Ricordate, libero != gratis; la licenza di software libero vi garantisce la libertà di usare e di modificare, ma non di rubare tempo altrui. Per favore, siate rispettosi, e comportatevi di conseguenza. |
| 135 | + |
| 136 | +## Estendere |
| 137 | + |
| 138 | +Un **comando** è una funzionalità atomica di WP-CLI. `wp plugin install` ([doc](https://wp-cli.org/commands/plugin/install/)) è un comando. `wp plugin activate` ([doc](https://wp-cli.org/commands/plugin/activate/)) è un altro. |
| 139 | + |
| 140 | +WP-CLI supporta la dichiarazione di una qualsiasi classe richiamabile oppure una closure, come comando. Legge i dettagli attraverso la callback di PHPdoc. `WP_CLI::add_command()` ([doc](https://wp-cli.org/docs/internal-api/wp-cli-add-command/)) viene usata sia per le registrazioni dei comandi interni che per quelli di terze parti. |
| 141 | + |
| 142 | +```php |
| 143 | +/** |
| 144 | + * Cancella un opzione dal database. |
| 145 | + * |
| 146 | + * Restituisce un errore se l'opzione non esiste. |
| 147 | + * |
| 148 | + * ## OPZIONI |
| 149 | + * |
| 150 | + * <key> |
| 151 | + * : Key per l'opzione. |
| 152 | + * |
| 153 | + * ## ESEMPI |
| 154 | + * |
| 155 | + * $ wp option delete my_option |
| 156 | + * Success: Opzione 'my_option' cancellata. |
| 157 | + */ |
| 158 | +$delete_option_cmd = function( $args ) { |
| 159 | + list( $key ) = $args; |
| 160 | + |
| 161 | + if ( ! delete_option( $key ) ) { |
| 162 | + WP_CLI::error( "Non posso eliminare l'opzione '$key'. Esiste?" ); |
| 163 | + } else { |
| 164 | + WP_CLI::success( "Opzione '$key' cancellata." ); |
| 165 | + } |
| 166 | +}; |
| 167 | +WP_CLI::add_command( 'option delete', $delete_option_cmd ); |
| 168 | +``` |
| 169 | + |
| 170 | +WP-CLI offre dozzine di comandi. Creare nuovi comandi personalizzati è più facile di quel che sembri. Leggete il [commands cookbook](https://wp-cli.org/docs/commands-cookbook/) per sapere di più. Consultate la [documentazione delle internal API](https://wp-cli.org/docs/internal-api/) per scoprire la varietà di utili funzioni disponibili per i vostri comandi WP-CLI. |
| 171 | + |
| 172 | +## Contribuire |
| 173 | + |
| 174 | +Benvenuti e grazie! |
| 175 | + |
| 176 | +Apprezziamo che vogliate prendere parte e contribuire a WP-CLI. È per merito vostro e della comunità che vi gravita attorno se WP-CLI è un grande progetto. |
| 177 | + |
| 178 | +**Contribuire non si limita soltanto alla programmazione** |
| 179 | + |
| 180 | +Vi incoraggiamo a contribuire nel modo che meglio rispecchia le vostre abilità, scrivendo tutorial, offrendo dimostrazioni durante i vostri incontri locali, prestare aiuto ad altri utenti riguardo le loro richieste di aiuto, o revisionando la documentazione. |
| 181 | + |
| 182 | +Vi preghiamo di riservare un po' di tempo da dedicare alla [lettura approfondita delle linee guida](https://wp-cli.org/docs/contributing/). Seguirle dimostra il rispetto dei tempi altrui sul progetto. |
| 183 | + |
| 184 | +## Coordinamento |
| 185 | + |
| 186 | +WP-CLI è guidato dai seguenti individui: |
| 187 | + |
| 188 | +* [Daniel Bachhuber](https://github.com/danielbachhuber/) - manutentore corrente |
| 189 | +* [Cristi Burcă](https://github.com/scribu) - manutentore precedente |
| 190 | +* [Andreas Creten](https://github.com/andreascreten) - fondatore |
| 191 | + |
| 192 | +Leggi di più riguardo la [politica del progetto](https://wp-cli.org/docs/governance/) e guarda la [lista completa dei contributori](https://github.com/wp-cli/wp-cli/contributors). |
| 193 | + |
| 194 | +## Crediti |
| 195 | + |
| 196 | +Oltre alle librerie definite in [composer.json](composer.json), abbiamo adottato codice o spunti dai seguenti progetti: |
| 197 | + |
| 198 | +* [Drush](http://drush.ws/) per... un mucchio di cose |
| 199 | +* [wpshell](http://code.trac.wordpress.org/browser/wpshell) per `wp shell` |
| 200 | +* [Regenerate Thumbnails](http://wordpress.org/plugins/regenerate-thumbnails/) per `wp media regenerate` |
| 201 | +* [Search-Replace-DB](https://github.com/interconnectit/Search-Replace-DB) per `wp search-replace` |
| 202 | +* [WordPress-CLI-Exporter](https://github.com/Automattic/WordPress-CLI-Exporter) per `wp export` |
| 203 | +* [WordPress-CLI-Importer](https://github.com/Automattic/WordPress-CLI-Importer) per `wp import` |
| 204 | +* [wordpress-plugin-tests](https://github.com/benbalter/wordpress-plugin-tests/) per `wp scaffold plugin-tests` |
0 commit comments