--- title: "Acorn Prettify: o sucessor do Soil e o que muda na stack Roots" url: "https://helloblog.io/pt/acorn-prettify-sucessor-soil-stack-roots/" date: "2024-01-16" modified: "2026-01-20" author: "Inês Silva" language: "pt_PT" categories: ["Ecossistema WordPress"] tags: ["Acorn", "Composer", "Roots", "Sage", "WordPress"] featured_image: "https://helloblog.io/app/uploads/sites/9/2026/01/featured-1-1024x572.png" excerpt: "Se usas Soil há anos para “limpar” o WordPress, a Roots tem um novo caminho oficial: Acorn Prettify. Vê o que ele traz, o que fica de fora e como migrar sem surpresas." --- # 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 1. O **Acorn Prettify** é o sucessor do **Soil** e faz parte da aposta da Roots no **Acorn** e no seu ecossistema de packages. 2. Inclui limpeza de markup, **Nice search** e suporte a **Relative URLs** (agora **desligado por defeito**). 3. A migração é feita via Composer: `composer remove roots/soil` e `composer require roots/acorn-prettify`. 4. A configuração é centralizada em `config/prettify.php` e pode ser publicada com `wp acorn vendor:publish --tag=prettify-config`. ## Referências / Fontes - [Announcing Acorn Prettify](https://roots.io/announcing-acorn-prettify/) - [roots/acorn-prettify](https://github.com/roots/acorn-prettify) - [Soil plugin](https://github.com/roots/soil) - [Creating an Acorn package](https://roots.io/creating-an-acorn-package/) - [Sage PR example (Soil removal)](https://github.com/roots/sage/pull/3172/files)