---
title: "Acorn Prettify : le successeur moderne de Soil pour assainir WordPress (version Roots/Acorn)"
url: "https://helloblog.io/fr/acorn-prettify-successeur-soil-wordpress-roots-acorn/"
date: "2024-01-16"
modified: "2026-01-20"
author: "Camille Dubois"
language: "fr_FR"
categories: ["Écosystème WordPress"]
tags: ["Acorn", "Composer", "Roots", "Sage", "WordPress"]
featured_image: "https://helloblog.io/app/uploads/sites/4/2026/01/featured-1-1024x572.png"
excerpt: "Soil faisait partie des “petites améliorations indispensables” dans beaucoup de projets Roots/Sage. Acorn Prettify reprend l’essentiel, le place au cœur de l’écosystème Acorn, et te donne une configuration plus propre via un simple fichier de config."
---

# Acorn Prettify : le successeur moderne de Soil pour assainir WordPress (version Roots/Acorn)

Roots vient de publier **Acorn Prettify**, un nouveau package Composer pensé comme le **successeur direct de Soil**. Si tu as déjà travaillé avec Roots/Sage, tu vois probablement Soil comme ce plugin “hygiène” qui corrige plein de détails WordPress pénibles (markup inutile, recherche parfois surprenante, URLs relatives…). L’idée ici est simple : garder les fonctionnalités que l’équipe Roots souhaite continuer à maintenir, et les intégrer proprement dans le monde **Acorn** (le runtime/app container de Roots, inspiré de Laravel).

## Pourquoi Soil évolue vers Acorn Prettify ?

Petit rappel historique : Soil était initialement intégré au starter theme Roots (autour de 2011–2014), puis a été séparé en plugin standalone à partir de Roots v7. Aujourd’hui, Roots annonce clairement miser sur **Acorn** et sur son **écosystème de packages**. Acorn Prettify s’inscrit dans cette logique : un package dédié, maintenable, aligné sur l’outillage Acorn et sa configuration.

## Ce qu’Acorn Prettify apporte (les “essentiels” de Soil)

Acorn Prettify reprend les fonctionnalités principales que Roots veut continuer à faire évoluer. Concrètement, tu y retrouves :

- **Nettoyage du markup WordPress** : l’objectif est d’obtenir un HTML plus propre côté rendu (moins de bruit, plus de cohérence).
- **Une recherche “plus agréable”** (*Nice search*) : amélioration du comportement de recherche pour des résultats plus pertinents/moins surprenants selon les cas d’usage WordPress.
- **Relative URLs** : prise en charge des URLs relatives, mais **désactivée par défaut** (ce point est important si tu t’appuyais dessus auparavant).

#### À retenir

Si tu utilises les URLs relatives via Soil, vérifie bien ton comportement après migration : dans Acorn Prettify, cette fonctionnalité est annoncée comme **off par défaut**.

## Migration : passer de Soil à Acorn Prettify (Composer)

La migration se fait de façon très directe via Composer : tu retires Soil, puis tu ajoutes Acorn Prettify.

```
composer remove roots/soil
```

```
composer require roots/acorn-prettify
```

Côté projets **Sage**, Roots indique aussi que tu peux supprimer les options `add_theme_support` liées à Soil dans ton `app/setup.php` (puisque tu ne pilotes plus Soil de cette manière). Un exemple concret est visible dans le diff partagé par l’équipe Sage.

Lien utile : [exemple de suppression dans le repo Sage](https://github.com/roots/sage/pull/3172/files).

## Configuration : activer/ajuster les features via config/prettify.php

L’activation des fonctionnalités d’Acorn Prettify se fait via un fichier de configuration : `config/prettify.php`. En pratique, ça veut dire que les features sont pilotées comme dans beaucoup de projets “à la Laravel” : un fichier de config unique, lisible, versionnable.

Si tu veux modifier les valeurs par défaut, Roots recommande de **publier** le fichier de configuration dans ton projet, puis de l’éditer.

```
wp acorn vendor:publish --tag=prettify-config
```

Référence : le fichier de config par défaut est disponible ici : [`config/prettify.php`](https://github.com/roots/acorn-prettify/blob/main/config/prettify.php).

## Ce que ça change au quotidien sur un projet Roots/Sage

Le bénéfice principal, c’est la **consolidation** autour d’Acorn : même logique de packages, même approche de configuration, même “surface” d’outillage (WP-CLI via `wp acorn`, publication de config, etc.). Pour une base Sage moderne, ça évite d’avoir un plugin historique à part, avec ses conventions, alors que le reste du projet vit déjà dans l’univers Acorn.

Enfin, le fait que certaines fonctionnalités (comme les **Relative URLs**) soient désormais **désactivées par défaut** envoie un signal : Roots privilégie des defaults plus prudents et attend que tu actives explicitement ce dont tu as besoin.

## Résumé

1. **Acorn Prettify** remplace Soil pour les fonctionnalités “hygiène” que Roots maintient activement.
2. La migration est essentiellement un swap Composer : `roots/soil` → `roots/acorn-prettify`.
3. Sur Sage, tu peux retirer les `add_theme_support` dédiés à Soil dans `app/setup.php`.
4. La configuration passe par `config/prettify.php`, publiable via `wp acorn vendor:publish --tag=prettify-config`.
5. Les **Relative URLs** sont présentes, mais **off par défaut** : à valider après migration.

## Références / Sources

- [Announcing Acorn Prettify](https://roots.io/announcing-acorn-prettify/)
- [roots/acorn-prettify](https://github.com/roots/acorn-prettify)
- [Soil](https://github.com/roots/soil)
- [Creating an Acorn package](https://roots.io/creating-an-acorn-package/)
- [Example from the Sage repo (PR diff)](https://github.com/roots/sage/pull/3172/files)
- [Acorn Prettify config file (config/prettify.php)](https://github.com/roots/acorn-prettify/blob/main/config/prettify.php)