Uma das perguntas que mais recebo quando apresento o WordPress Playground em eventos é: “Como eu garanto que o site sempre comece com meu plugin ativado e as configurações certas?”. A resposta curta é: Blueprints.

Se o Playground é o motor que roda o WordPress no navegador via WebAssembly (WASM), a Blueprint é a “receita” que define o estado inicial dessa instância. Sem ela, você teria que configurar tudo manualmente a cada nova sessão, o que mataria a produtividade.

O que é uma Blueprint?

Uma Blueprint é um arquivo JSON que descreve exatamente como sua instância do Playground deve se comportar. Ela permite definir desde versões de software até automações complexas. Com ela, você configura:

• Versões preferidas: Escolha versões específicas do PHP e do WordPress.
• Plugins e temas: Defina o que deve ser instalado e ativado automaticamente
• Passos de automação (steps): Crie posts, usuários ou execute comandos de terminal.

Começando com o pé direito: JSON Schema

Para evitar erros de sintaxe e ganhar agilidade, sempre comece sua Blueprint referenciando o JSON Schema oficial. Isso habilita o autocompletar no VS Code e valida suas propriedades em tempo real, evitando aquele “debug por tentativa e erro”.

{
  "$schema": "https://playground.wordpress.net/blueprint-schema.json",
  "landingPage": "/wp-admin/",
  "preferredVersions": {
    "php": "8.3",
    "wp": "latest"
  }
}Code language: JSON / JSON with Comments (json)

Benefícios Práticos: Do Repositório ao Teste Local

1. Live Preview no WordPress.org

Você já deve ter notado o botão de Live Preview no repositório oficial de plugins. Aquilo é alimentado por uma Blueprint. Se você é desenvolvedor, adicionar um arquivo blueprint.json na pasta /assets do seu SVN permite que qualquer usuário teste seu plugin instantaneamente. É a melhor forma de reduzir a fricção de adoção do seu projeto.

2. Automação com a CLI

No dia a dia, eu utilizo Blueprints para agilizar o debug. Em vez de subir um site e configurar o WooCommerce manualmente, eu rodo um comando e tenho o ambiente pronto em segundos:

npx @wp-playground/cli start --blueprint=setup-loja.jsonCode language: CSS (css)

Exemplo: Blueprint de Ambiente de Desenvolvimento

Aqui está uma receita completa para um ambiente de teste robusto, incluindo o uso de comandos via terminal:

{
  "$schema": "https://playground.wordpress.net/blueprint-schema.json",
  "landingPage": "/wp-admin/",
  "preferredVersions": {
    "php": "8.3",
    "wp": "6.7"
  },
  "features": {
    "networking": true
  },
  "steps": [
    {
      "step": "login",
      "username": "admin",
      "password": "password"
    },
    {
      "step": "installPlugin",
      "pluginData": {
        "resource": "wordpress.org/plugins",
        "slug": "akismet"
      },
      "options": { "activate": true }
    },
    {
      "step": "wp-cli",
      "command": "wp option update blogname 'Lab do Playground'"
    }
  ]
}Code language: JSON / JSON with Comments (json)

Conclusão

Trabalhar com Blueprints transforma o WordPress de um CMS estático em uma ferramenta de desenvolvimento dinâmico e portátil. Se você ainda não padronizou o setup dos seus plugins com receitas JSON, está perdendo tempo precioso.

Além disso, essa padronização facilita muito o trabalho em equipe, pois todos rodam exatamente a mesma configuração com um único comando.