WP Composer: nezávislá náhrada za WPackagist pro instalaci pluginů a šablon přes Composer

Pokud stavíš WordPress projekty moderně (Bedrock, vlastní deployment, CI), Composer je často základní stavební kámen. A s ním dlouhé roky přišel jeden skoro samozřejmý předpoklad: pluginy a šablony z WordPress.org bereš přes WPackagist.

Jenže v okamžiku, kdy se z podobně kritické infrastruktury pro workflow celé komunity stane majetek jedné korporace, je fér zpozornět. V březnu 2026 byl WPackagist akvírován společností WP Engine. V takové situaci je rozumné mít vedle existující služby i nezávislou alternativu, která je provozovaná otevřeně a má jasný governance model.

Roots proto postavili WP Composer: nezávislý, komunitně financovaný a plně open source Composer repository pro WordPress pluginy a šablony.

Proč na tom záleží (a proč to není jen „další mirror“)

WPackagist původně vytvořili Outlandish a řadu let jej udržovali. V pozdější fázi ale projekt začal působit zanedbaně: pomalé aktualizace, omezená údržba a minimální reálný prostor pro komunitní input. Akvizice WP Engine tyhle obavy logicky ještě zesílila.

Když je základní vývojářský nástroj pod kontrolou jediné firmy, komunita ztrácí hlas. Směřování, dostupnost nebo potenciální monetizace se pak neřeší transparentně, ale spíš „za zavřenými dveřmi“. Navíc není úplně jasné, zda WPackagist zůstává skutečně open source v praxi – veřejný GitHub repozitář https://github.com/outlandishideas/wpackagist už neodpovídá běžícímu webu.

WP Composer je postavený tak, aby byl transparentní, komunitně financovaný a provozovaný lidmi, kteří WordPress infrastrukturu řeší dlouhodobě.

Detailní srovnání rozdílů (výkon, metadata, technické detaily) je na: WP Composer vs WPackagist.

Co WP Composer poskytuje

Z pohledu běžného projektu je klíčové tohle: WP Composer poskytuje každý free plugin a free šablonu z WordPress.org adresáře, instalovatelnou přes Composer, a to s čistým a konzistentním pojmenováním balíčků.

Největší ergonomická změna je v názvech balíčků:

• pluginy používají prefix wp-plugin/*
• šablony používají prefix wp-theme/*
• odpadá historické wpackagist-plugin a wpackagist-theme

Typické nastavení composer.json pak vypadá takto:

{
  "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ň doporučený repository doplněk k balíčkům WordPress core od Roots: roots/wordpress, roots/wordpress-full a roots/wordpress-no-content. Typický projekt na Bedrock používá roots/wordpress pro core a WP Composer pro pluginy a šablony.

Migrace z WPackagist: konkrétní kroky

Přechod je ve výsledku jednoduchý: jde hlavně o výměnu repository a přejmenování balíčků v require. Prakticky to zvládneš pár příkazy.

1) Odeber wpackagist balíčky

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

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

2) Vyměň repository v Composer konfiguraci

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) Nainstaluj balíčky pod novým názvem (wp-plugin/<em>, wp-theme/</em>)

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

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

Alternativa: migrační script pro automatickou úpravu composer.json

Pokud nechceš ručně procházet všechny dependency (typicky u větších projektů), existuje migrační script, který aktualizuje composer.json automaticky:

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

Používáš-li GitHub Action pro sledování changelogů/aktualizací pluginů, došlo i k přejmenování: z „WPackagist Changelog Action“ na WP Composer Changelog Action. Akce plně podporuje nové formáty názvů wp-plugin/<em> a wp-theme/</em>.

Výkon: proč je WP Composer rychlejší při resolve

Tady WP Composer míří na velmi konkrétní technickou věc: podporuje protokol Composer v2 metadata-url. To znamená, že Composer stahuje metadata jen pro balíčky, které skutečně potřebuje vyřešit.

WPackagist naopak používá starší přístup provider-includes, který nutí Composer stáhnout velké indexy obsahující metadata pro tisíce balíčků ještě předtím, než vůbec může dependency začít rozumně resolvovat.

Časy resolve (cold cache)

Měřeno jako cold resolve (bez cache) – nižší čas je lepší:

• 10 pluginů: WP Composer 0,7 s vs WPackagist 12,3 s (cca 17× rychlejší)
• 20 pluginů: WP Composer 1,1 s vs WPackagist 19,0 s (cca 17× rychlejší)

Metadata a caching rozdíly

• Composer v2 metadata-url: WP Composer ano, WPackagist ne
• CDN caching: WP Composer public, max-age=300, WPackagist no-cache, private
• Per-package soubory: WP Composer „immutable, content-addressed, cached indefinitely“, WPackagist „not content-addressed“

Benchmarky byly spuštěné z jedné lokace a na Composer 2.7+. Výsledky se můžou lišit podle regionu a kvality sítě. Samotné benchmark skripty jsou otevřené: https://github.com/roots/wp-composer/tree/main/benchmarks.

Plně open source (včetně deploymentu)

WP Composer není jen „hotový endpoint“, který musíš slepě věřit. Celá aplikace, dokumentace i deployment konfigurace jsou dostupné jako open source na GitHubu: https://github.com/roots/wp-composer. Přispívat může kdokoliv a pokud chceš, můžeš si repository forknout a provozovat vlastní instanci.

Komunitní financování přes GitHub Sponsors

Provoz a vývoj WP Composeru je financovaný výhradně komunitně přes GitHub Sponsors. Sponzoring jde přímo na infrastrukturu, vývoj a údržbu WP Composeru i širšího Roots ekosystému.

Pokud Composer používáš jako standardní součást WordPress vývoje, dává tohle modelu nástrojů smysl: udržuje klíčovou infrastrukturu nezávislou a volně dostupnou.