O WordPress Playground lançou dois novos recursos: um Terminal integrado para PHP e WP-CLI e um grupo de opções de ferramentas para desenvolvedores no menu Dock. O Dock compacto mantém as ações do dia a dia à vista e oferece a quem desenvolve um caminho direto para as ferramentas de inspeção e de alteração de um site.
No Terminal, você pode inspecionar o conteúdo, verificar as configurações, testar uma API do WordPress ou fazer uma alteração rápida sem configurar um ambiente local nem sair de playground.wordpress.net. Os comandos são executados no Playground ativo: eles leem ou alteram o mesmo site WordPress exibido atrás do painel.
Ferramentas para desenvolvedores agrupadas no menu Dock
Acesse playground.wordpress.net e aguarde o WordPress iniciar. O Dock, na parte inferior da tela, mostra New, Playgrounds, Site Settings, Export e Dev Tools. Quando está no modo compacto, ele oculta os botões voltados ao desenvolvimento e oferece uma barra de ferramentas mais simples para quem está explorando o WordPress.
Selecione Dev Tools, ao lado de Export, para expandir o Dock. As opções Blueprint, Database, Terminal, Files, Logs e Email aparecerão. Em seguida, selecione Terminal para abrir a ferramenta de execução de comandos do site atual.
O Playground lembra se as ferramentas para desenvolvedores estavam visíveis ou ocultas mesmo após recarregar a página. Ao recolhê-las, ele mantém um comando inacabado no Terminal ou um rascunho de Blueprint, para que você possa reabrir a ferramenta e continuar.
O outro novo recurso é o Terminal, que oferece dois modos:
- PHP executa trechos curtos de código PHP com o WordPress já carregado.
- WP-CLI executa comandos de linha de comando do WordPress no site ativo.
Explorando WordPress com PHP
O modo PHP oferece um editor com realce de sintaxe, números de linha e alguns exemplos prontos para executar. Você pode selecionar exemplos como Versions, Site URL, List posts, Create post ou Active plugins, editar o código e selecionar Run.
O WordPress já estará carregado, e a tag inicial <?php é opcional. Por exemplo, este trecho lista os títulos dos posts do site:
foreach ( get_posts() as $post ) {
echo $post->post_title . "\n";
}
Você também pode inspecionar versões e configurações:
echo 'WordPress ' . get_bloginfo( 'version' ) . "\n";
echo 'PHP ' . phpversion() . "\n";
echo 'Site URL: ' . get_site_url();
Cada execução é avaliada de forma independente. As variáveis de uma execução não ficam disponíveis na próxima, mas as alterações feitas pelas APIs do WordPress permanecem no Playground ativo. Por exemplo, update_option() altera o banco de dados do site da mesma forma que alteraria se fosse chamada por um plugin.
Use Ctrl+Enter ou Command+Enter para executar o código pelo teclado. Se o trecho estiver incompleto, ele permanecerá no editor para que você possa terminá-lo. Erros de sintaxe e de execução aparecem em mensagens concisas, com a posição no código quando essa informação está disponível.
Gerenciando WordPress com WP-CLI
Mude para WP-CLI quando ela for a maneira mais rápida de inspecionar ou alterar o WordPress. Comece com um comando que apenas consulta dados:
wp option get blogname
O wp inicial é opcional; option get blogname também funciona. Na primeira execução de WP-CLI, o Playground baixa o executável, caso ele ainda não esteja disponível. Os comandos seguintes reutilizam esse executável.
Confira alguns comandos úteis. Execute cada linha separadamente:
wp core version
wp plugin list
wp post list --fields=ID,post_title,post_status
wp option get siteurl
Você também pode criar conteúdo diretamente:
wp post create --post_title='Created from the Playground Terminal' --post_status=publish
O resultado mostra Success: Created post, seguido do ID do post. Execute wp post list --fields=ID,post_title,post_status novamente para confirmar o título e o status de publicação. Para ver o post no WordPress, feche o Terminal, digite /wp-admin/edit.php no campo de endereço do Dock e abra o post na tela Posts. Apenas atualizar a página de boas-vindas não exibirá o novo post. Cada vez que você executar novamente o comando de criação, outro post será criado.
Simulando cenários reais
A WP-CLI é especialmente útil para preparar um site de testes antes de conferir o resultado no WordPress. Se você está desenvolvendo um plugin ou quer verificar como um tema se comporta em determinada tela, os exemplos a seguir mostram como preparar um Playground novo usando comandos do Terminal.
Inicie o Playground com o WooCommerce ativo. O plugin acrescenta seus próprios comandos wp wc, e --user=admin concede a eles as permissões necessárias para gerenciar os dados da loja. Crie um produto de teste publicado e um cupom de 10% executando estes dois comandos separadamente:
wp wc product create --name="Playground Test Mug" --type=simple --status=publish --regular_price=19.99 --sku=playground-test-mug-01 --user=admin
wp wc shop_coupon create --code=PLAYGROUND10 --discount_type=percent --amount=10 --user=admin
Abra a loja no site WordPress, adicione Playground Test Mug ao carrinho e aplique PLAYGROUND10 em Add coupons. Em um teste com um Playground novo, o produto apareceu por US$ 19,99, e o cupom reduziu o total do carrinho para US$ 17,99.
Os comandos criam os dados de teste; adicionar o produto ao carrinho e aplicar o cupom ainda são ações feitas no navegador. Consulte a referência de comandos do WooCommerce para conhecer outras operações da loja.
Preparando posts para testar temas e o core do WordPress
Quando um recurso precisa de mais de um post de exemplo, gere doze posts publicados com um único comando:
wp post generate --count=12 --post_type=post --post_status=publish
Os posts gerados aparecem em Posts. No teste com o Playground, eles também preencheram a primeira página do blog e fizeram surgir uma segunda página de posts. Isso oferece conteúdo para testar paginação, ordenação, pesquisa ou ações em massa. Consulte a referência do comando de geração de posts da WP-CLI.
Para um teste rápido e específico do editor de blocos, crie um post com conteúdo salvo como um bloco de parágrafo:
wp post create --post_title='Block smoke test' --post_status=publish --post_content='Block smoke test'
Use o ID informado pelo comando para abrir /wp-admin/post.php?post=ID&action=edit, substituindo ID pelo número do post. O post de teste foi aberto como um bloco de parágrafo no editor. Para testar o bloco de um plugin, substitua o conteúdo deste exemplo pelo conteúdo salvo correspondente ao bloco: se ele não corresponder à definição do bloco, poderá gerar um aviso de validação. O guia sobre a representação dos blocos no conteúdo salvo explica o formato.
Um executor de comandos, não um shell completo.
O Terminal integrado é voltado a PHP e WP-CLI. Ele não é um shell de uso geral nem oferece um TTY interativo.
Inclua todos os valores necessários no próprio comando da WP-CLI. Comandos que aguardam uma entrada interativa são rejeitados, em vez de interpretar a entrada indisponível como um valor vazio. Comandos interativos de longa duração, como wp shell e wp server, não são compatíveis.
Essa restrição torna a execução no navegador mais previsível. Ela também impede que um comando altere inesperadamente o WordPress após uma tentativa malsucedida de ler a entrada padrão. O mesmo comportamento de falha imediata agora se aplica à etapa wp-cli do Blueprint. Por isso, os comandos de Blueprint também precisam fornecer explicitamente os argumentos necessários.
Um caminho mais rápido da pergunta à resposta.
O Terminal preenche o espaço entre navegar pelo wp-admin e montar um ambiente de desenvolvimento local. Quem desenvolve plugins pode verificar uma opção ou a lista de plugins ativos enquanto reproduz um erro. Quem escreve documentação ou está aprendendo pode executar exemplos de PHP no contexto do WordPress. Quem contribui com o projeto pode inspecionar um site de testes antes de exportá-lo ou compartilhar um Blueprint que permita reproduzir o cenário.
O Terminal chegou à solicitação de alteração nº 3808, Add Terminal to the Dock, a partir de um pedido anterior para integrar a WP-CLI ao site do Playground. A atualização do Dock para Dev Tools facilitou mostrar ou ocultar esse conjunto crescente de ferramentas.
Agradecemos a @akirk pelo desenvolvimento do Terminal e às pessoas que criaram e aperfeiçoaram os controles do Dock.
Abra o WordPress Playground, selecione Dev Tools Terminal e comece com wp option get blogname ou um dos exemplos de PHP. Ao terminar, recolha Dev Tools para voltar ao Dock mais simples. Se encontrar um erro ou tiver uma ideia para melhorar o fluxo de trabalho, abra uma issue no repositório do WordPress Playground ou participe do canal #playground no Slack do Making WordPress.
Deixe um comentário
Você precisa fazer o login para publicar um comentário.