--- title: "Acorn Prettify: następca Soil i kolejny krok Roots w stronę ekosystemu Acorn" url: "https://helloblog.io/pl/acorn-prettify-nastepca-soil-i-kolejny-krok-roots-w-strone-ekosystemu-acorn/" date: "2024-01-16" modified: "2026-01-20" author: "Katarzyna Nowak" language: "pl_PL" categories: ["Ekosystem WordPress"] tags: ["Acorn", "Composer", "Roots", "Sage", "WordPress"] featured_image: "https://helloblog.io/app/uploads/sites/8/2026/01/featured-1-1024x572.png" excerpt: "Roots wypuściło Acorn Prettify — nowy pakiet Composer, który przejmuje utrzymywane funkcje znane z Soil i przenosi je do świata Acorn. Jeśli budujesz projekty na Sage/Acorn, to jest to zmiana, którą warto od razu poukładać w repo." --- # 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](https://github.com/roots/acorn-prettify)**, ogłoszony jako następca dobrze znanego **Soil** (plugin: [roots/soil](https://github.com/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. #### Uwaga o relative URLs W Soil relatywne adresy bywały użyteczne, ale potrafiły też zaskoczyć przy integracjach, cache’owaniu, CDN-ach czy generowaniu linków w kontekstach poza stroną. Roots zaznacza, że w Acorn Prettify ta funkcja startuje jako wyłączona domyślnie. ## 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 ``` ### 2) Dodaj 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](https://github.com/roots/sage/pull/3172/files). ## Konfiguracja: jak włączać i dostosowywać funkcje? Funkcje Acorn Prettify są kontrolowane przez plik konfiguracyjny `config/prettify.php` (w repo paczki: [config/prettify.php](https://github.com/roots/acorn-prettify/blob/main/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 ``` #### Dlaczego to jest wygodne w zespołach? Konfig w repo (a nie „klikane” ustawienia) dobrze skaluje się przy code review, CI i wdrożeniach. Widać jasno, kiedy i dlaczego zmieniło się zachowanie markupów czy linków. ## 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](https://discourse.roots.io/t/-/26545). ## Odniesienia / Źródła - [Announcing Acorn Prettify](https://roots.io/announcing-acorn-prettify/) - [roots/acorn-prettify](https://github.com/roots/acorn-prettify) - [roots/soil](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) - [config/prettify.php (acorn-prettify)](https://github.com/roots/acorn-prettify/blob/main/config/prettify.php) - [Discuss this post on Roots Discourse](https://discourse.roots.io/t/-/26545)