Preskočiť na obsah
Acorn Prettify: moderný nástupca Soil pre čistejší WordPress (a ako na migráciu)
Hannah Turing
Hannah Turing 2024. January 16. · 4 min read

Acorn Prettify: moderný nástupca Soil pre čistejší WordPress (a ako na migráciu)

Ak staviaš WordPress projekty na stacku od Roots (Sage/Acorn), názov Soil ti bude povedomý. Dlhé roky to bol praktický „balík drobných vylepšení“, ktoré urobili WordPress výstup o niečo čistejší a príjemnejší na údržbu. Roots teraz uvádza Acorn Prettify – balík, ktorý preberá udržiavané časti Soil a zapadá do Acorn ekosystému (Acorn je aplikačný framework od Roots pre WordPress, ktorý prináša Laravel-like prístup).

Čo je Acorn Prettify a prečo vznikol

Acorn Prettify je nový Composer balík od Roots, ktorý oficiálne nadväzuje na Soil. Soil pôvodne žil priamo v Roots starter theme (2011–2014) a neskôr sa oddelil do samostatného pluginu. Dnes Roots komunita čoraz viac stavia na Acorn a jeho balíčkovom ekosystéme, preto dáva zmysel mať „Soil-like“ funkcionalitu v podobe Acorn package.

Dôležitý detail: nejde o snahu preniesť úplne všetko zo Soil naveky. Roots do Prettify vybrali tie funkcie, ktoré chcú dlhodobo udržiavať a ktoré zodpovedajú modernému spôsobu práce v projektoch postavených na Acorne.

Kľúčové funkcie, ktoré Prettify preberá zo Soil

  • Čistejší WordPress markup – upratanie/úprava HTML výstupu WordPressu tak, aby bol menej „roztrasený“ a príjemnejší na prácu v téme.
  • Nice search – zlepšenie správania vyhľadávania (typicky ide o menej prekvapivé URL/requests a konzistentnejšie výsledky).
  • Relative URLs – podpora relatívnych URL je k dispozícii, ale podľa oznámenia je nové správanie také, že je defaultne vypnutá (čo je často praktické kvôli kompatibilite a edge-case scenárom).

Poznámka k relatívnym URL

To, že sú relatívne URL v Prettify štandardne vypnuté, je dobrý signál pre stabilitu: relatívne cesty vedia narobiť problémy pri feedoch, sitemape, CDN, headless integráciách alebo pri rôznych proxy vrstvách. Zapínať ich má zmysel až keď presne vieš prečo.

Migrácia zo Soil na Acorn Prettify (Composer)

Ak máš Soil nainštalovaný ako Composer dependency, prechod je priamočiary. Základ je Soil odinštalovať a pridať Prettify. Potom ešte upratať prípadné theme support nastavenia v Sage.

1) Odstráň Soil z projektu

composer remove roots/soil

2) Nainštaluj Acorn Prettify

composer require roots/acorn-prettify

3) Ak používaš Sage, odstráň theme supports pre Soil

V projektoch so Sage bývali niektoré Soil funkcie zapínané cez add_theme_support(...) v súbore app/setup.php. Pri migrácii tieto voľby dáva zmysel odstrániť, aby si nemal v kóde mŕtve konfigurácie alebo konflikt očakávaní.

Roots uvádzajú konkrétny príklad z repozitára Sage: https://github.com/roots/sage/pull/3172/files

Konfigurácia: ako zapínať a upravovať funkcie Prettify

Na rozdiel od „klasických“ pluginov, ktoré často konfigurujú veci cez WP admin alebo cez PHP konštanty, Acorn Prettify ide typickou acorn cestou: funkcie sa spravujú cez konfiguračný súbor config/prettify.php.

Ak chceš meniť defaulty, najprv si konfiguráciu publikuješ do projektu a potom ju upravíš.

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

Praktický tip pre tímy

Konfig súbory typu config/prettify.php maj zvyčajne v Gite. Je to čitateľnejšie ako „klikacie“ nastavenia a v review hneď vidíš, čo sa zmenilo medzi deploymi.

Kde to celé zapadá v Roots/Acorn svete

Roots týmto krokom jasne ukazujú, že Acorn a balíčkový ekosystém je dnes ich hlavná cesta. Pre vývojára to znamená, že doplnky a „project-level“ vylepšenia sa čoraz viac budú správať ako známe Composer balíky z PHP sveta: inštalácia cez Composer, konfigurácia cez config/*.php, publikovanie vendor configov cez CLI a podobne.

Ak už v projekte používaš Acorn, Prettify je prirodzený spôsob, ako mať pod kontrolou tie úpravy WordPressu, ktoré Soil riešil roky – len v modernejšom a konzistentnejšom balení.

Zhrnutie

  1. Acorn Prettify je oficiálny nástupca Soil od Roots.
  2. Prináša udržiavané jadro funkcií: čistejší markup, vylepšené vyhľadávanie a relatívne URL (defaultne vypnuté).
  3. Migrácia je jednoduchá: composer remove roots/soilcomposer require roots/acorn-prettify + upratanie add_theme_support v Sage.
  4. Konfigurácia ide cez config/prettify.php a dá sa publikovať príkazom wp acorn vendor:publish --tag=prettify-config.
Hannah Turing

Hannah Turing

WordPress vývojárka a technická redaktorka v HelloWP. Pomáham vývojárom vytvárať lepšie webové stránky s modernými nástrojmi ako Laravel, Tailwind CSS a ekosystém WordPress. Vášnivo sa venujem čistému kódu a vývojárskej skúsenosti.

Všetky príspevky

Pridajte sa ku komunite HelloWP!

Chatujte s nami o WordPresse, webovom vývoji a zdieľajte skúsenosti s ostatnými vývojármi.

- členovia
- online
Pridať sa

We use cookies to improve your experience. By continuing, you agree to our Cookie Policy.