Acorn Prettify: o sucessor do Soil e o que muda na stack Roots
A Roots anunciou o Acorn Prettify, um novo package que assume o papel de sucessor do Soil — aquele plugin clássico que muita gente instalava quase por reflexo para deixar o WordPress mais “arrumado” por dentro. A mudança não é só de nome: ela acompanha a decisão da Roots de apostar forte no Acorn (um framework/app container para WordPress que aproxima o desenvolvimento do ecossistema Laravel, via Composer e comandos WP-CLI).
Neste artigo, o foco é entender o que o Acorn Prettify cobre, por que ele existe, e como migrar a partir do Soil num projeto que já usa Composer (e, frequentemente, Sage).
Contexto rápido: de Roots Starter Theme ao Soil e agora ao Acorn Prettify
O Soil nasceu dentro do antigo starter theme da Roots, lá no início da década passada, e mais tarde foi separado como plugin independente quando saiu a versão 7 do Roots. Desde então, ele virou um “pacote utilitário” comum em muitos projetos: instalas, ligas algumas features e segues a vida.
O que muda agora é a direção estratégica: a Roots está a consolidar o ecossistema em torno do Acorn e dos seus packages. O Acorn Prettify entra exatamente aqui: ele reúne e mantém um conjunto específico das funcionalidades do Soil que a equipa pretende continuar a suportar no futuro.
O que o Acorn Prettify traz (e o que deves esperar dele)
O Acorn Prettify inclui as principais features do Soil que vão continuar em manutenção, segundo o anúncio. Na prática, isto traduz-se em três áreas:
- Limpeza do markup do WordPress: ajustes para produzir HTML mais “limpo”/consistente, reduzindo ruído que o core tende a gerar em alguns pontos.
- Pesquisa melhorada (Nice search): uma abordagem para URLs de pesquisa mais amigáveis e previsíveis.
- Relative URLs: suporte para converter URLs absolutas em relativas — com um detalhe importante: vem desativado por defeito.
Atenção às Relative URLs
Se tinhas Relative URLs ativas no Soil e dependes disso (por exemplo, em setups multi-ambiente ou behind proxies/CDNs), valida o comportamento após a migração: no Acorn Prettify esta opção passa a estar desligada por defeito.
Migração do Soil para o Acorn Prettify (via Composer)
A migração é direta se o teu projeto já gere dependências com Composer (que é o normal na stack Roots). O processo é: remover o Soil e instalar o novo package.
composer remove roots/soil
composer require roots/acorn-prettify
Nota para projetos Sage: limpar add_theme_support antigo do Soil
Se estás em Sage, pode haver configurações antigas do Soil registadas no tema via add_theme_support (tipicamente no app/setup.php). Com o Acorn Prettify, a Roots indica que podes remover essas opções associadas ao Soil para evitar configuração duplicada/confusa.
Há um exemplo concreto desta alteração num PR do repositório do Sage (linkado na fonte), útil para comparar com a tua base de código.
Configuração: como ativar/desativar features no Acorn Prettify
Ao contrário do modelo clássico “instala plugin e liga no admin”, aqui a abordagem é mais próxima de um package moderno: as features são controladas por um ficheiro de configuração config/prettify.php.
Para alterares os defaults, a ideia é publicar o config para o teu projeto e depois editar o que precisares.
wp acorn vendor:publish --tag=prettify-config
Porque isto é relevante
Publicar config via wp acorn encaixa no workflow do Acorn: as opções ficam versionadas no projeto e tornam-se previsíveis entre ambientes (local/staging/produção), em vez de dependerem de toggles manuais.
O que esta mudança sinaliza no ecossistema Roots
Mais do que substituir um plugin por outro, o Acorn Prettify é um sinal claro de consolidação: a Roots está a empurrar as melhorias “fundacionais” do WordPress para dentro do ecossistema de packages do Acorn. Para equipas que já trabalham com Sage/Acorn, isto tende a simplificar manutenção, atualização e consistência de configuração.
Se tens projetos legados com Soil, a migração é um bom momento para rever: quais features realmente usas, se Relative URLs ainda fazem sentido no teu stack atual, e como queres controlar essas decisões via config.
Resumo
- O Acorn Prettify é o sucessor do Soil e faz parte da aposta da Roots no Acorn e no seu ecossistema de packages.
- Inclui limpeza de markup, Nice search e suporte a Relative URLs (agora desligado por defeito).
- A migração é feita via Composer:
composer remove roots/soilecomposer require roots/acorn-prettify. - A configuração é centralizada em
config/prettify.phpe pode ser publicada comwp acorn vendor:publish --tag=prettify-config.
Hannah Turing
Desenvolvedora WordPress e redatora técnica na HelloWP. Ajudo desenvolvedores a criar melhores sites com ferramentas modernas como Laravel, Tailwind CSS e o ecossistema WordPress. Apaixonada por código limpo e experiência do desenvolvedor.
Todos os posts
