Comandos comuns

Este texto foi traduzido usando IA. Se você deseja ver o texto original em inglês, clique aqui.

Existem vários comandos que podem ser úteis ao trabalhar com o seu site. Esses comandos e seus parâmetros mais comuns estão incluídos abaixo. Há também muitos outros comandos úteis disponíveis, e estas seções não incluem todos eles. Consulte o Guia de Comandos CLI para Desenvolvedores do WordPress.org para mais informações.

Gerenciar Usuários

Use os comandos a seguir para gerenciar os usuários locais do seu site. Tenha em mente que alterar aspectos do usuário no CLI não alterará as configurações das contas de usuário do WordPress.com que possam estar associadas às contas locais.

wp user list

Lista todos os usuários do site. Se você tiver muitos usuários, pode restringir a lista a funções específicas usando a flag --role:

wp user list –role=adminstrator

wp user get {USER ID/NAME/EMAIL}

Retorna um usuário específico, seja pelo ID do usuário, nome de usuário ou endereço de e-mail.

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

Cria um novo usuário com o nome, e-mail do usuário e função definidos.

Este comando não cria um usuário correspondente no WordPress.com. Se você estiver usando o WordPress.com Secure Sign-On (SSO), em vez disso, crie o usuário local convidando um usuário em Usuários > Adicionar novo. Isso garantirá que tanto a conta do WordPress.com quanto o usuário local sejam criados.

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

Atualiza um usuário com base no ID, nome ou e-mail do usuário. Atualiza o conjunto de pares chave/valor especificados. 

As chaves incluem display_name, user_email, role e user_pass

Observação: não será possível atualizar o user_login de um usuário com o comando wp user update. Em vez disso, a atualização do user_login requer o uso de wp search-replace. No entanto, essa alteração não é recomendada, pois realiza substituições parciais. Por exemplo: se houver dois usuários com os nomes de usuário “techie” e “nontechie”, substituir “techie” por “sense” resultará em “sense” e “nonsense”.

Se ainda assim você quiser substituir um user_login, o comando a ser usado é:

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

Gerenciar plugins e temas

Use os comandos a seguir para gerenciar seus plugins e temas. Ao trabalhar com plugins e temas, observe que o slug correspondente nem sempre será igual ao nome do plugin/tema.

Se você estiver tendo problemas com um plugin ou tema, pode iniciar seu comando com wp --skip-themes --skip-plugins para executar os comandos mesmo com conflitos.

Você pode encontrar mais informações sobre comandos de skip abaixo.

wp plugin/theme list

Lista todos os plugins/temas instalados no site e seus status. Nessas listas, você encontrará os slugs dos plugins e temas instalados, que podem ser usados para executar os comandos abaixo.

wp plugin/theme activate {SLUG}

Ativa o plugin/tema especificado.

Para desativar um tema, você precisa ativar outro em seu lugar.

wp plugin deactivate {SLUG}

Desativa o plugin especificado.

wp plugin/theme delete {SLUG}

Exclui o plugin/tema especificado.

Você não pode excluir um tema ativo ou temas gerenciados com este comando. Para remover um tema ativo, primeiro mude para um tema diferente e depois exclua o tema desejado. Para remover temas gerenciados, você pode fazer isso via SFTP.

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

Instala um plugin/tema do repositório WordPress.org com base no slug ou por meio de um caminho de URL para um arquivo .zip de instalação.

Você não pode sobrescrever um plugin/tema existente a menos que execute o comando com a flag --force. Você pode usar isso para atualizar plugins e corrigir pastas de plugins corrompidas.

Para ativar automaticamente um plugin após a instalação, inclua a flag --activate.

wp plugin/theme update {SLUG}

Atualiza o plugin/tema especificado, se disponível. Você não pode usar este comando para atualizar plugins/temas gerenciados.

Você também pode usar a flag --all se quiser atualizar todos os plugins/temas.

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

Exibe o status das atualizações de plugins ou ativa/desativa atualizações para um plugin específico.

Os COMMANDS disponíveis são status, enable, disable.

Não é possível desativar atualizações para plugins ou temas gerenciados.

Gerenciar o Jetpack

Use os comandos a seguir para ajustar os módulos do Jetpack, verificar sua conexão com o Jetpack ou solucionar problemas do Jetpack.

wp jetpack module list

Lista os módulos do Jetpack e seus status.

wp jetpack module activate {MODULE NAME}

Ativa o módulo do Jetpack especificado.

Você também pode usar all no lugar de {MODULE NAME}

wp jetpack module deactivate {MODULE NAME}

Desativa o módulo do Jetpack especificado.

Você também pode usar all no lugar de {MODULE NAME}

wp jetpack status

Informa o status do Jetpack, incluindo qual conta de usuário é a conexão principal (essa deve ser sempre a do proprietário do site).

Um parâmetro adicional, full, pode ser incluído para exibir detalhes completos, como a versão do Jetpack, a versão do WordPress e o status dos módulos.

Gerenciar configurações do site

Use os comandos a seguir para gerenciar diversos aspectos do seu site e dos usuários.

wp site empty –yes

Esvazia o conteúdo de um site (posts e páginas).

wp site empty –uploads –yes

Esvazia o site, incluindo arquivos de mídia.

Os comandos wp site não excluem temas ou plugins, nem redefinem um tema ou apagam configurações de plugins. Se você precisar redefinir seu site completamente, entre em contato com o Suporte do WordPress.com.

wp option get {OPTION}

Retorna o valor de uma opção.

wp option update {OPTION} {VALUE}

Atualizar o valor de uma opção.

wp option add {OPTION} {VALUE}

Adicionar uma nova opção.

wp option delete {OPTION}

Excluir uma opção.

Ao trabalhar com comandos wp option, se você receber o seguinte erro no terminal, isso pode significar que a tabela de opções foi corrompida:

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

Você pode restaurar a tabela retrocedendo a tabela SQL do site para a última cópia válida. Observe que isso reverterá todas as alterações mutáveis no banco de dados que ocorreram após o ponto de restauração e pode resultar em perda de dados.

Para restaurar uma tabela SQL:

1. No painel do site, navegue até Jetpack > Registro de Atividade.
2. Selecione um ponto de backup para o qual deseja retornar.
3. Desmarque todas as caixas, exceto Banco de Dados do Site (SQL).
4. Clique em Confirmar Reversão.

wp role list

Retorna uma lista de funções

wp role reset {ROLE}

Redefine a função especificada. Você pode listar múltiplas funções (sem vírgulas)

wp reset role administrator editor

Você também pode substituir {ROLE} por --all para redefinir todas de uma vez

Gerenciar Conteúdo

Você pode usar os seguintes comandos para gerenciar o conteúdo do seu site, incluindo posts/páginas, menus e mídia.

wp post list

Retorna uma lista de posts do blog.

Você pode usar diversas flags com este comando, incluindo:

--format={FORMAT}

--posts_per_page={#}

--post_type={TYPE}

Os tipos de post possíveis incluem posts, pages, attachments e products.

Várias flags podem ser usadas ao mesmo tempo.

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

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

Atualiza as informações do post.

wp post update123 --post_status=draft

wp post delete {POST_ID}

Excluir um post.

wp post exists {POST_ID}

Verificar se um post existe.

wp menu list

Listar menus do site.

wp menu item list {TERM_ID}

Listar itens de menu de um menu específico.

wp menu item update {MENU_ITEM_PARENT_ID}

Atualize um item de menu específico.

wp media regenerate

Regenere as miniaturas de mídia quando o módulo Jetpack Photon estiver desativado.

Você pode usar a flag --only-missing para pular tamanhos de imagem já existentes.

Solução de problemas do site

Você pode usar os comandos a seguir ao solucionar problemas no seu site. Verificar erros de PHP pode ajudar a identificar as origens dos erros no seu site, ou você pode usar os comandos wp wpcomsh para realizar rapidamente verificações de conflito de plugins ou para ajustar se você está usando ou não as versões gerenciadas dos plugins.

wp php-errors

Exiba os logs de erro no WP-CLI.

Este comando exibe apenas erros de PHP, não de outras linguagens como HTML, Javascript ou CSS. Para ver esses outros erros, use o Inspetor do Navegador.

Você pode adicionar a flag --limit para reduzir o número de erros exibidos e melhorar a legibilidade.

wp php-errors –limit10

wp wpcomsh deactivate-user-plugins

Desativa plugins do usuário.

Você pode usar a flag --interactive para forçar a confirmação para cada plugin.

Este comando não desativa o Akismet, o Jetpack ou plugins gerenciados de ecommerce.

wp wpcomsh reactivate-user-plugins

Reativa plugins do usuário.

Você pode usar a flag --interactive para forçar a confirmação para cada plugin.

wp wpcomsh persistent-data {DATA}

Retorna dados persistentes (que o Jetpack usa para verificar as capacidades do site).

As opções de DATA disponíveis incluem:

WPCOM_PLAN_EXPIRATION

JETPACK_BLOG_TOKEN

WPCOM_PURCHASES

WPCOM_PUBLIC_COMING_SOON

wp wpcomsh plugin use-managed {SLUG}

Usa uma versão gerenciada (com link simbólico) de um plugin.

Este comando removerá versões existentes não gerenciadas e as substituirá por versões gerenciadas. Está disponível para amp, classic-editor, coblocks, crowdsignal-forms, full-site-editing, gutenberg, layout-grid, page-optimize, wp-seo, woocommerce, extensões do WooCommerce do Marketplace do WordPress.com e plugins incluídos no plano Commerce.

Você pode usar a flag --remove-existing para pular a etapa de confirmação.

wp wpcomsh theme use-managed {SLUG}

Usar uma versão gerenciada (com symlink) de um tema.

Este comando removerá as versões existentes não gerenciadas e as substituirá por versões gerenciadas. Ele está disponível para todos os temas do WordPress.com, Storefront e qualquer tema Twenty * (ex: Twenty Twenty Two).

Você pode usar a flag --remove-existing para pular a etapa de confirmação.

wp wpcomsh plugin use-unmanaged {SLUG}

Usar uma versão não gerenciada (sem symlink) de um plugin.

Este comando removerá as versões gerenciadas existentes e as substituirá por versões não gerenciadas do repositório de plugins do WordPress.org. Ele não funcionará para extensões do WooCommerce do Marketplace do WordPress.com e plugins incluídos no plano Commerce. Você precisará instalar esses plugins manualmente para obter a versão não gerenciada.

Você pode usar a flag --remove-existing para pular a etapa de confirmação e a flag --version={X.Y.Z} para definir a versão a ser instalada.

wp wpcomsh theme use-unmanaged {SLUG}

Use uma versão não gerenciada (sem symlink) de um tema.

Este comando removerá versões existentes gerenciadas e as substituirá por versões não gerenciadas do repositório de temas do WordPress.org, se disponíveis.

Você pode usar a flag --remove-existing para pular a etapa de confirmação e a flag --version={X.Y.Z} para definir a versão a ser instalada.

O WordPress.com Site Helper, ou plugin must-use wpcomsh, é executado em sites com recursos de hospedagem ativados para que funcionem perfeitamente no ecossistema do WordPress.com.

wp cache flush

Limpar o cache.

Este comando não deve ser usado como solução para problemas e pode ocultar causas raiz. Use com cuidado. Limpar o cache também pode deixar seu site mais lento enquanto o cache é reconstruído no carregamento das páginas.

Ignorando plugins e temas

Você pode querer ignorar plugins, e às vezes temas, ao executar comandos CLI. Isso pode ser útil para solucionar conflitos ou para contornar restrições impostas por plugins, como controle sobre funções de usuário.

• --skip-plugins pode ser adicionado antes de qualquer comando e ignora os plugins
• --skip-themes pode ser adicionado antes de qualquer comando e ignora os temas

Você pode usar esses comandos juntos. Também pode usá-los com slugs para ignorar plugins ou temas específicos. Isso pode ser útil para descartar os efeitos de determinados plugins ou temas quando a desativação não é possível.

Por exemplo:

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