WP Composer: nezávislá náhrada za WPackagist v Composer workflow pre WordPress

Ak používaš Composer (PHP dependency manager) na manažovanie WordPress pluginov a tém, pravdepodobne si roky siahal po WPackagist-e ako po „default“ repozitári. Bol to praktický most medzi WordPress.org adresárom a Composer ekosystémom – a pre mnohé projekty aj základ moderného WordPress deploymentu.

V marci 2026 však prišla zásadná zmena: WPackagist bol akvírovaný WP Engine, hostingovou spoločnosťou podporovanou private equity. Pri infraštruktúre, ktorá je takto centrálna pre WordPress Composer workflow, je riziko jednostrannej kontroly reálne – najmä ak sa rozhodnutia o dostupnosti, smerovaní či prípadnom spoplatnení začnú robiť mimo otvorenej komunity.

Práve preto vznikol WP Composer: nezávislý, komunitou financovaný a plne open source Composer repozitár pre WordPress pluginy a témy, ktorý buduje a prevádzkuje Roots. Web: https://wp-composer.com

Prečo to riešiť práve teraz

WPackagist pôvodne vytvoril tím Outlandish a dlhé roky ho udržiaval. Neskôr však projekt čoraz viac trpel klasickými problémami zanedbanej infraštruktúry: pomalé aktualizácie, obmedzená údržba a prakticky žiadny zmysluplný vstup komunity do rozhodovania.

Ak infraštruktúru, na ktorej stojí developer workflow, ovláda jedna korporácia, komunita prirodzene stráca hlas. A zároveň vzniká otáznik nad transparentnosťou: nie je jasné, či WPackagist zostáva naďalej skutočne open source – jeho verejný GitHub repozitár už nezodpovedá tomu, čo beží na produkčnom webe: https://github.com/outlandishideas/wpackagist.

WP Composer stavia na opačných princípoch: transparentnosť, otvorený vývoj a financovanie priamo komunitou.

Čo WP Composer poskytuje

WP Composer sprístupňuje každý bezplatný plugin a tému z WordPress.org adresára tak, aby sa dali inštalovať cez Composer – a zároveň upratuje názvoslovie balíkov.

Základná idea je jednoduchá: pluginy idú pod namespace wp-plugin/<em> a témy pod wp-theme/</em>. Tým odpadáva historické prefixovanie typu wpackagist-plugin a wpackagist-theme.

{
  "repositories": [
    {
      "name": "wp-composer",
      "type": "composer",
      "url": "https://repo.wp-composer.com",
      "only": ["wp-plugin/*", "wp-theme/*"]
    }
  ],
  "require": {
    "wp-plugin/woocommerce": "^10.0",
    "wp-theme/twentytwentyfive": "^1.0"
  }
}

{
  "repositories": [
    {
      "name": "wp-composer",
      "type": "composer",
      "url": "https://repo.wp-composer.com",
      "only": ["wp-plugin/*", "wp-theme/*"]
    }
  ],
  "require": {
    "wp-plugin/woocommerce": "^10.0",
    "wp-theme/twentytwentyfive": "^1.0"
  }
}

WP Composer je zároveň odporúčaný repozitár na použitie spolu s balíkmi WordPress core od Roots – konkrétne roots/wordpress, roots/wordpress-full a roots/wordpress-no-content. V praxi to často vyzerá tak, že projekt postavený na Bedrock používa roots/wordpress pre core a WP Composer pre pluginy a témy.

Detailný popis core balíkov od Roots nájdeš tu: https://wp-composer.com/roots-wordpress

Migrácia z WPackagistu: presné kroky

Prechod je priamočiary a dá sa spraviť buď ručne cez pár Composer príkazov, alebo automatizovane skriptom. Nižšie je postup v troch krokoch.

1) Odstráň existujúce WPackagist balíky

composer remove wpackagist-plugin/woocommerce wpackagist-theme/twentytwentyfive

composer remove wpackagist-plugin/woocommerce wpackagist-theme/twentytwentyfive

2) Vymeň repozitár v Composer konfigurácii

composer config --unset repositories.wpackagist && composer config repositories.wp-composer composer https://repo.wp-composer.com

composer config --unset repositories.wpackagist && composer config repositories.wp-composer composer https://repo.wp-composer.com

3) Pridaj balíky už v novom názvosloví

composer require wp-plugin/woocommerce wp-theme/twentytwentyfive

composer require wp-plugin/woocommerce wp-theme/twentytwentyfive

Alternatíva: migračný skript, ktorý upraví composer.json automaticky

Ak chceš premapovať názvy balíkov v composer.json bez ručných zásahov, existuje migračný skript priamo v repozitári:

curl -sO https://raw.githubusercontent.com/roots/wp-composer/main/scripts/migrate-from-wpackagist.sh && bash migrate-from-wpackagist.sh

curl -sO https://raw.githubusercontent.com/roots/wp-composer/main/scripts/migrate-from-wpackagist.sh && bash migrate-from-wpackagist.sh

Skript je dostupný aj na GitHub-e: https://github.com/roots/wp-composer/blob/main/scripts/migrate-from-wpackagist.sh

GitHub Action na changelogy: premenovanie a podpora nového formátu

Ak používaš GitHub Action, ktorá sleduje aktualizácie pluginov, počítaj s tým, že action bola premenovaná z „WPackagist Changelog Action“ na WP Composer Changelog Action a podporuje nové názvoslovie wp-plugin/<em> a wp-theme/</em>.

Repozitár action: https://github.com/roots/wp-composer-changelog-action

Výkon: prečo je WP Composer rýchlejší pri resolve

Najväčší praktický rozdiel pri každodennom použití je v tom, ako Composer sťahuje metadáta. WP Composer podporuje protokol Composer v2 metadata-url, vďaka ktorému Composer ťahá metadáta iba pre balíky, ktoré reálne potrebuje na vyriešenie závislostí.

WPackagist naďalej používa starší prístup provider-includes, kde Composer musí najprv stiahnuť veľké index súbory s metadátami pre tisíce balíkov, až potom môže začať resolve závislostí. To je presne ten typ „skrytej“ režie, ktorý ťa bolí najmä v CI a pri cold cache.

Časy resolve (cold resolve, bez cache) – menej je lepšie

Nižšie sú uvedené namerané hodnoty:

• 10 pluginov: WP Composer 0.7s vs WPackagist 12.3s (≈ 17× rýchlejšie)
• 20 pluginov: WP Composer 1.1s vs WPackagist 19.0s (≈ 17× rýchlejšie)

Metadáta a cacheovanie

• Composer v2 metadata-url: WP Composer áno, WPackagist nie
• CDN caching: WP Composer public, max-age=300, WPackagist no-cache, private
• Per-package súbory: WP Composer má immutable, content-addressed súbory cacheované „indefinitely“; WPackagist nie je content-addressed

Plne open source: kód, dokumentácia aj deployment

WP Composer je navrhnutý tak, aby bol auditovateľný a znovupoužiteľný: aplikačný kód, dokumentácia aj deployment konfigurácia sú verejne dostupné na GitHub-e: https://github.com/roots/wp-composer.

Dôležitý detail: ktokoľvek si vie projekt forknúť a spustiť vlastnú inštanciu. To je presne typ nezávislosti, ktorý pri kritickej infraštruktúre dáva komunite istotu, že nie je „zamknutá“ do jedného poskytovateľa.

Financovanie komunitou cez GitHub Sponsors

Prevádzka takéhoto repozitára niečo stojí (infra, vývoj, údržba). WP Composer je financovaný výhradne komunitou cez GitHub Sponsors: https://github.com/sponsors/roots. Sponsoring má podporovať nielen WP Composer, ale aj širší Roots ekosystém.

Zhrnutie pre prax

• WP Composer je nezávislý Composer repozitár pre WordPress pluginy a témy, udržiavaný Roots.
• Používa čisté názvy balíkov wp-plugin/<em> a wp-theme/</em>.
• Migrácia z WPackagistu je otázkou pár príkazov alebo jedného skriptu.
• Vďaka Composer v2 metadata-url je resolve výrazne rýchlejší, najmä pri cold cache a v CI.
• Projekt je plne open source a financovaný komunitou cez GitHub Sponsors.