|
| 1 | +--- |
| 2 | +layout: default |
| 3 | +title: Interface para linha de comando em WordPress |
| 4 | +--- |
| 5 | + |
| 6 | +[WP-CLI](https://wp-cli.org/) é um conjunto de linhas de comando para gerenciar instalações [WordPress](https://wordpress.org/). Você pode atualizar plugins, configurar instalações multisite e muito mais, sem utilizar um navegador web. |
| 7 | + |
| 8 | +Para manter-se atualizado, siga [@wpcli no Twitter](https://twitter.com/wpcli) ou [inscreva-se em nossa 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 "Tempo médio para resolver um issue") [](http://isitmaintained.com/project/wp-cli/wp-cli "Percentual de issues ainda abertos") |
| 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 | + |
| 21 | + <p>O projeto <strong>"WP-CLI mais <i>RESTful</i>"</strong> visa proporcionar todo o potencial da linha de comando para a WP REST API e é apoiado por Pressed, Chris Lema, Human Made, Pagely, Pantheon e muitos outros. <a href="https://wp-cli.org/restful/">Saiba mais →</a></p> |
| 22 | +</div> |
| 23 | + |
| 24 | +Links rápidos: [Usando](#usando) | [Instalando](#instalando) | [Suporte](#suporte) | [Extendendo](#extendendo) | [Contribuindo](#contribuindo) | [Créditos](#creditos) |
| 25 | + |
| 26 | +## Usando |
| 27 | + |
| 28 | +O objetivo da WP-CLI é fornecer uma interface em linha de comando para qualquer ação que você queira executar na administração do WordPress. Por exemplo `wp plugin install --activate` ([doc](https://wp-cli.org/commands/plugin/install/)) permite a instação e ativação de um plugin WordPress: |
| 29 | + |
| 30 | +``` |
| 31 | +$ wp plugin install rest-api --activate |
| 32 | +Installing WordPress REST API (Version 2) (2.0-beta13) |
| 33 | +Downloading install package from https://downloads.wordpress.org/plugin/rest-api.2.0-beta13.zip... |
| 34 | +Unpacking the package... |
| 35 | +Installing the plugin... |
| 36 | +Plugin installed successfully. |
| 37 | +Activating 'rest-api'... |
| 38 | +Success: Plugin 'rest-api' activated. |
| 39 | +``` |
| 40 | + |
| 41 | +WP-CLI também inclui muitos comandos para ações que não são possíveis através da administração do WordPress. Por exemplo, `wp transient delete-all` ([doc](https://wp-cli.org/commands/transient/delete-all/)) permite deletar uma ou todas as <abbr title='Dados transitórios'>transients</abbr>: |
| 42 | + |
| 43 | +``` |
| 44 | +$ wp transient delete-all |
| 45 | +Success: 34 transients deleted from the database. |
| 46 | +``` |
| 47 | + |
| 48 | +Para uma introdução mais completa sobre como usar a WP-CLI, leia o [Guia rápido](https://wp-cli.org/docs/quick-start/). |
| 49 | + |
| 50 | +Já se sente confortável com o básico? Vá para a [lista completa de comandos](https://wp-cli.org/commands/) para obter informações detalhadas na gestão de temas e plugins, importação e exportação de dados, operações de busca e substituição no banco de dados e muito mais. |
| 51 | + |
| 52 | +## Instalando |
| 53 | + |
| 54 | +Realizar o download do arquivo Phar é o método de instalação que recomendamos. Caso precise, nossa documentação para [métodos alternativos de instação](https://wp-cli.org/docs/installing/). |
| 55 | + |
| 56 | +Antes instalar a WP-CLI, certifique-se que seu ambiente possua os requesitos mínimos: |
| 57 | + |
| 58 | +- Ambiente UNIX-like (OS X, Linux, FreeBSD, Cygwin); suporte limitado para ambientes Windows |
| 59 | +- PHP 5.3.29 ou superior |
| 60 | +- WordPress 3.7 ou superior |
| 61 | + |
| 62 | +Após verificar os requesitos, faça o download do arquivo [wp-cli.phar](https://raw.github.com/wp-cli/builds/gh-pages/phar/wp-cli.phar) usando `wget` ou `curl`: |
| 63 | + |
| 64 | +``` |
| 65 | +$ curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar |
| 66 | +``` |
| 67 | + |
| 68 | +Em seguida, verifique se está funcionando: |
| 69 | + |
| 70 | +``` |
| 71 | +$ php wp-cli.phar --info |
| 72 | +``` |
| 73 | + |
| 74 | +Digite `wp` para utilizar WP-CLI a partir da linha de comando, torne o arquivo executável e mova-o para algum diretório presente em sua variável de ambiente PATH. For example: |
| 75 | + |
| 76 | +``` |
| 77 | +$ chmod +x wp-cli.phar |
| 78 | +$ sudo mv wp-cli.phar /usr/local/bin/wp |
| 79 | +``` |
| 80 | + |
| 81 | +Se WP-CLI foi instalado com sucesso, ao executar `wp --info` você deverá ver algo como: |
| 82 | + |
| 83 | +``` |
| 84 | +$ wp --info |
| 85 | +PHP binary: /usr/bin/php5 |
| 86 | +PHP version: 5.5.9-1ubuntu4.14 |
| 87 | +php.ini used: /etc/php5/cli/php.ini |
| 88 | +WP-CLI root dir: /home/wp-cli/.wp-cli |
| 89 | +WP-CLI packages dir: /home/wp-cli/.wp-cli/packages/ |
| 90 | +WP-CLI global config: /home/wp-cli/.wp-cli/config.yml |
| 91 | +WP-CLI project config: |
| 92 | +WP-CLI version: 0.23.0 |
| 93 | +``` |
| 94 | + |
| 95 | +WP-CLI pode ser atualizado com `wp cli update` ([doc](https://wp-cli.org/commands/cli/update/)), ou repetindo os passos da instalação. |
| 96 | + |
| 97 | +_Quer viver a vida no limite?_ Execute `wp cli update --nightly` para usar a última compilação de desenvolvimento da WP-CLI. Essa versão é bastante estável para utilizar em seu ambiente de desenvolvimento, e sempre inclui as melhores e mais atuais funcionalidades da WP-CLI. |
| 98 | + |
| 99 | +## Suporte |
| 100 | + |
| 101 | +Os colaboradores do projeto WP-CLI fazem seu melhor para rsponder a todos os problemas assim que possível. Para que possamos fazer melhor uso do tempo dos voluntários, verifique se já existe uma resposta para sua pergunta em umas das fontes abaixo: |
| 102 | + |
| 103 | +- [Questões comuns e suas respostas](https://wp-cli.org/docs/common-issues/) |
| 104 | +- [Melhores práticas para informar um problema](https://wp-cli.org/docs/bug-reports/) |
| 105 | +- [Portal de documentação](https://wp-cli.org/docs/) |
| 106 | +- [Questões abertas ou fechadas no Github](https://github.com/wp-cli/wp-cli/issues?utf8=%E2%9C%93&q=is%3Aissue) |
| 107 | +- [Forum WordPress no StackExchange](http://wordpress.stackexchange.com/questions/tagged/wp-cli) |
| 108 | + |
| 109 | +Caso não encontre uma resposta na fontes existentes, fique a vontade para [abrir uma questão](https://github.com/wp-cli/wp-cli/issues/new) com sua dúvida. |
| 110 | + |
| 111 | +Se você possui uma conta WordPress.org, considere se inscrever no canal `#cli` no [Slack do WordPress.org](https://make.wordpress.org/chat/). |
| 112 | + |
| 113 | +## Extendendo |
| 114 | + |
| 115 | +Um **commando** é uma unidade singular de uma funcionalidade WP-CLI. `wp plugin install` ([doc](https://wp-cli.org/commands/plugin/install/)) é um comando. `wp plugin activate` ([doc](https://wp-cli.org/commands/plugin/activate/)) é outro. |
| 116 | + |
| 117 | +WP-CLI vem com muitos comandos. Criar um comando personalizado para WP-CLi é mais fácil do que parece. Leia o [livro de receitas de comandos](https://wp-cli.org/docs/commands-cookbook/) para aprender mais. Procure a [documentação de API interna](https://wp-cli.org/docs/internal-api/) para descobrir a variedade de funcionalidades úteis que você pode utilizar no seu comando personalizado para WP-CLI. |
| 118 | + |
| 119 | +## Contribuindo |
| 120 | + |
| 121 | +Seja bem vindo e obrigado! |
| 122 | + |
| 123 | +Nós agradecemos sua iniciativa em contribuir com a WP-CLI. É por sua causa e a comunidade a sua volta, que a WP-CLI se tornou um grande projeto. |
| 124 | + |
| 125 | +**Contribuir não é limitado a somente código.** Te encorajamos a contribuir da maneira que melhor se encaixe em suas habilidades, escrevendo tutoriais, com demonstrações em palestras locais, ajudar outros usuários respondendo suas dúvidas no suporte, ou revisando nossa documentação. |
| 126 | + |
| 127 | +De uma olhada com atenção [nesse guia](https://wp-cli.org/docs/contributing/). Seguindo esses passos você estará respeitando o tempo dos outros colaboradoes. Por sua vez, eles farão o melhor para retribuir esse respeito no trabalho com você, nos diferentes fusos horários e em todo o mundo. |
| 128 | + |
| 129 | +## Criadores e liderança |
| 130 | + |
| 131 | +WP-CLI foi criado e mantido por: |
| 132 | + |
| 133 | +* [Daniel Bachhuber](https://github.com/danielbachhuber/) - Líder atual |
| 134 | +* [Cristi Burcă](https://github.com/scribu) - Líder anterior |
| 135 | +* [Andreas Creten](https://github.com/andreascreten) - Criador |
| 136 | + |
| 137 | +Saiba mais sobre os projetos de [governança](https://wp-cli.org/docs/governance/) e veja a [lista completa dos colaboradores](https://github.com/wp-cli/wp-cli/contributors). |
| 138 | + |
| 139 | +## Créditos |
| 140 | +<span id='creditos'></span> |
| 141 | + |
| 142 | +Além das bibliotecas especificadas em [composer.json](/composer.json), utilizamos o código ou idéias dos projetos abaixos: |
| 143 | + |
| 144 | +* [Drush](http://drush.ws/) para... muitas coisas |
| 145 | +* [wpshell](http://code.trac.wordpress.org/browser/wpshell) para `wp shell` |
| 146 | +* [Regenerate Thumbnails](http://wordpress.org/plugins/regenerate-thumbnails/) para `wp media regenerate` |
| 147 | +* [Search-Replace-DB](https://github.com/interconnectit/Search-Replace-DB) para `wp search-replace` |
| 148 | +* [WordPress-CLI-Exporter](https://github.com/Automattic/WordPress-CLI-Exporter) para `wp export` |
| 149 | +* [WordPress-CLI-Importer](https://github.com/Automattic/WordPress-CLI-Importer) para `wp import` |
| 150 | +* [wordpress-plugin-tests](https://github.com/benbalter/wordpress-plugin-tests/) para `wp scaffold plugin-tests` |
0 commit comments