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).

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 remove roots/soil

composer require roots/acorn-prettify

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.

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

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

Référence : le fichier de config par défaut est disponible ici : 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.