Acorn Prettify: modernus Soil įpėdinis Roots ekosistemoje (ir kaip migruoti)
Roots komanda pristatė Acorn Prettify – naują paketą, kuris perima ir toliau prižiūrimas pagrindines Soil idėjas, bet jas perkelia į Acorn pasaulį. Jei tavo projektai jau remiasi Acorn (arba planuoji judėti ta kryptimi su Sage), Prettify atrodo kaip natūralus „default“ pasirinkimas vietoje atskiro Soil plugin’o.
Kontekstui: Soil ilgą laiką buvo „komplektas“ patogumų ir tvarkos WordPress’e. Jis dar 2011–2014 m. buvo įtrauktas į Roots starter theme, o vėliau (išleidus Roots v7) tapo atskiru plugin’u. Dabar Roots aiškiai komunikuoja kryptį: ekosistemos centras – Acorn ir jo paketų (package) aplinka, todėl Prettify yra Soil įpėdinis šioje architektūroje.
Kas yra Acorn Prettify (ir ką jis sprendžia)
Acorn Prettify – tai Acorn paketas (package), kuris į projektą atneša kelias praktiškas funkcijas, orientuotas į WordPress „švarą“ ir UX. Kitaip tariant, tai rinkinys tvarkingų numatytųjų elgsenų, kurias anksčiau daugelis įsidėdavo per Soil.
- Švaresnis WordPress markup – mažiau triukšmo HTML’e ir tvarkingesni numatytieji išvedimai.
- Nice search – patogesnė paieškos elgsena (ypač kai norisi logiškesnio užklausų apdorojimo).
- Relative URLs – santykiniai URL’ai; svarbu, kad pagal nutylėjimą ši funkcija dabar išjungta.
Kodėl verta atkreipti dėmesį į Relative URLs
Soil pasaulyje santykiniai URL’ai dažnai būdavo „įjungiami ir pamirštami“. Prettify’e jie išjungti pagal nutylėjimą – tai signalas, kad ši funkcija gali turėti šalutinių efektų (pvz., migracijose, edge atvejais su CDN ar įvairiais peradresavimais) ir ją verta aktyvuoti tik sąmoningai.
Migracija iš Soil į Acorn Prettify (Composer)
Jei Soil tavo projekte ateina per Composer, migracija yra tiesi: pašalini vieną priklausomybę ir įdedi kitą.
composer remove roots/soilcomposer require roots/acorn-prettifyJei naudoji Sage, dar vienas praktinis žingsnis: gali pašalinti Soil skirtus add_theme_support nustatymus iš app/setup.php (jei buvai juos susidėjęs). Roots pateikė konkretų pakeitimų pavyzdį Sage repozitorijoje.
Nuoroda į pavyzdį: Sage PR diff.
Konfigūracija: kaip įjungti/išjungti funkcijas
Prettify funkcijos valdomos per konfigūracijos failą config/prettify.php. Tai patogu Acorn/Laravel stiliaus projektuose: vietoje skirtingų functions.php fragmentų ar „feature flagų“ per add_theme_support, turi vieną aiškų konfigo tašką.
Jei nori pakeisti numatytuosius nustatymus, Roots siūlo standartinį kelią: publish’inti konfigą į projektą ir tada jį redaguoti.
wp acorn vendor:publish --tag=prettify-configPats konfigūracijos failas repozitorijoje: config/prettify.php.
Ką tai reiškia Roots/Acorn ekosistemai praktiškai
Šis pokytis gerai atspindi Roots kryptį: vietoje „vieno plugin’o viskam“ judama į Acorn paketų ekosistemą, kur funkcionalumai ateina kaip aiškiai versijuojami Composer paketai, su konfigūracija ir įprastais vendor publish darbo srautais. Jei tavo WordPress projektai jau yra „modernūs“ (Composer-first, CI, aiškios priklausomybės), toks modelis dažniausiai yra paprasčiau prižiūrimas ilgainiui.
Greitas kontrolinis sąrašas po migracijos
1) Patikrink paiešką (search) realiuose scenarijuose. 2) Įsivertink, ar tau reikia Relative URLs ir įjunk tik jei tikrai naudinga. 3) Peržvelk config/prettify.php ir susilygink su tuo, ką anksčiau buvai įjungęs per Soil/Sage add_theme_support.
Hannah Turing
WordPress kūrėja ir techninė rašytoja HelloWP. Padedu kūrėjams kurti geresnes svetaines naudojant šiuolaikinius įrankius, tokius kaip Laravel, Tailwind CSS ir WordPress ekosistema. Aistringai vertinu švarų kodą ir kūrėjo patirtį.
Visi įrašai
