Acorn Prettify: następca Soil i kolejny krok Roots w stronę ekosystemu Acorn

W ekosystemie Roots dzieje się kolejna istotna zmiana: pojawił się pakiet Acorn Prettify, ogłoszony jako następca dobrze znanego Soil (plugin: roots/soil). W praktyce oznacza to przeniesienie wybranych, utrzymywanych funkcji Soil do rozwiązania opartego o Acorn (czyli warstwę aplikacyjną Roots, inspirowaną podejściem frameworkowym).

Soil ma długą historię: był częścią startera Roots w latach 2011–2014, a wraz z wydaniem Roots v7 został wydzielony do osobnego pluginu. Teraz Roots jasno komunikuje kierunek: pełna koncentracja na Acorn i rozwój jego ekosystemu paczek (package ecosystem).

Co dokładnie wnosi Acorn Prettify (i co przejmuje z Soil)?

Acorn Prettify skupia się na tych funkcjach Soil, które Roots deklaruje dalej utrzymywać. Z perspektywy typowego projektu WordPress (zwłaszcza opartego o Sage) są to rzeczy, które porządkują codzienną pracę i redukują liczbę „małych irytacji” w markupie czy adresach URL.

• Czyszczenie/porządkowanie markupów WordPressa (cleaner WordPress markup) – mniej zbędnych elementów w HTML generowanym przez core.
• Lepsza wyszukiwarka (nice search) – usprawnienia związane z zachowaniem wyszukiwania.
• Relative URLs (adresy względne) – w Acorn Prettify są domyślnie wyłączone, co jest ważną zmianą w oczekiwaniach względem zachowania projektu.

Migracja z Soil do Acorn Prettify (Composer)

Jeśli masz Soil jako zależność (często spotykane w projektach opartych o Roots/Sage), migracja sprowadza się do przepięcia paczek w Composerze. Warto zrobić to w jednej gałęzi i szybko sprawdzić rendering szablonów, wyszukiwanie oraz linkowanie (szczególnie jeśli wcześniej polegałeś na relative URLs).

1) Usuń Soil z zależności

composer remove roots/soil

composer remove roots/soil

2) Dodaj Acorn Prettify

composer require roots/acorn-prettify

composer require roots/acorn-prettify

3) (Sage) Usuń stare add_theme_support dla Soil

W projektach Sage często były dodane wpisy add_theme_support(...) pod funkcje Soil. Po migracji można je usunąć z pliku app/setup.php, żeby nie utrzymywać martwej konfiguracji. Roots pokazało to na przykładzie w repo Sage: PR/zmiany w Sage.

Konfiguracja: jak włączać i dostosowywać funkcje?

Funkcje Acorn Prettify są kontrolowane przez plik konfiguracyjny config/prettify.php (w repo paczki: config/prettify.php). W praktyce oznacza to podejście „konfiguracja jako kod”: zamiast rozproszonych ustawień w kilku miejscach, masz jedno źródło prawdy.

Jeżeli chcesz zmienić wartości domyślne, publikujesz plik konfiguracyjny do projektu, a potem edytujesz go lokalnie:

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

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

Co to oznacza dla projektów na Roots/Sage?

Najważniejszy sygnał jest strategiczny: Roots „dowozi” kolejny element układanki pod Acorn, wzmacniając jego rolę jako podstawy dla nowoczesnego developmentu w WordPressie. Jeżeli budujesz nowe projekty na Sage, to Acorn Prettify jest po prostu bardziej naturalnym wyborem niż trzymanie się Soil z przyzwyczajenia.

Z perspektywy utrzymania kodu najrozsądniej jest potraktować migrację jako mały refactor: przepiąć zależności, usunąć stare add_theme_support, opublikować config tylko wtedy, gdy faktycznie potrzebujesz zmian, i zrobić szybki smoke test: archiwa, single, wyszukiwanie oraz linkowanie.

Podsumowanie

1. Acorn Prettify to oficjalny następca Soil, dostarczany jako paczka Composer.
2. Zawiera utrzymywane funkcje: porządkowanie markupów, usprawnienia wyszukiwania i relative URLs (domyślnie wyłączone).
3. Migracja jest prosta: composer remove roots/soil i composer require roots/acorn-prettify, a w Sage dodatkowo sprzątnięcie add_theme_support.
4. Konfiguracja odbywa się przez config/prettify.php, publikowany komendą wp acorn vendor:publish --tag=prettify-config.

Jeśli potrzebujesz kontekstu lub chcesz prześledzić decyzje projektowe, Roots prowadzi dyskusję pod ogłoszeniem na Discourse: Discuss this post on Roots Discourse.