WP Composer: alternativa modernă la WPackagist pentru pluginuri și teme WordPress instalate cu Composer

În ecosistemul WordPress, Composer a devenit de ani buni instrumentul preferat atunci când vrei proiecte reproductibile, deploy-uri curate și control real asupra dependențelor. Iar pentru pluginuri și teme, soluția „implicită” mult timp a fost WPackagist.

Doar că, în momentul în care infrastructura pe care se bazează fluxul tău de lucru ajunge sub controlul unei singure companii, apar întrebări legitime despre transparență, direcție și sustenabilitate. Exact aici intră în scenă WP Composer: un repository Composer independent pentru pluginuri și teme WordPress, finanțat de comunitate și dezvoltat de Roots.

De ce contează schimbarea asta (mai ales pentru echipele care folosesc Composer zilnic)

WPackagist a fost construit inițial de Outlandish și a fost întreținut ani la rând. În timp însă, proiectul a ajuns să sufere din cauza lipsei de mentenanță: update-uri lente, întreținere limitată și, practic, fără input comunitar relevant.

În martie 2026, WPackagist a fost achiziționat de WP Engine (companie de hosting susținută de private equity). Pentru un element atât de central în workflow-ul WordPress + Composer, faptul că e controlat de o singură corporație ridică riscuri evidente: deciziile despre disponibilitate, costuri sau direcție pot ajunge să fie luate „în boardroom”, nu în mod deschis, împreună cu comunitatea.

Mai mult, rămâne neclar cât de „open source” mai este WPackagist în practică: repository-ul GitHub public (https://github.com/outlandishideas/wpackagist) nu mai reflectă starea site-ului live.

WP Composer pornește de la o premisă simplă: ar trebui să existe o alternativă transparentă, finanțată de comunitate și construită de oameni care lucrează cu WordPress la nivel de infrastructură și tooling de mult timp.

Dacă vrei o comparație detaliată (performanță, metadata, diferențe de funcționare), există și pagina dedicată: WP Composer vs WPackagist.

Ce oferă concret WP Composer

WP Composer (https://wp-composer.com) este un repository Composer complet open source, întreținut de Roots, care expune toate pluginurile și temele gratuite din directorul WordPress.org, instalabile direct cu Composer.

Unul dintre cele mai practice detalii: naming-ul pachetelor este curat și previzibil:

Pluginuri: wp-plugin/*
Teme: wp-theme/*
Fără prefixele wpackagist-plugin și wpackagist-theme

Configurația tipică în composer.json arată așa:

{
  "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 este recomandat și în combinație cu pachetele Roots pentru WordPress core:

roots/wordpress
roots/wordpress-full
roots/wordpress-no-content

Într-un proiect Bedrock (https://roots.io/bedrock/), scenariul uzual este: roots/wordpress pentru core și WP Composer pentru pluginuri și teme.

Migrarea de la WPackagist: pași clari (și un script automat)

Dacă ai proiecte existente care folosesc WPackagist, schimbarea se face rapid. Varianta manuală are trei pași.

1) Elimină pachetele WPackagist existente

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

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

2) Înlocuiește repository-ul în configurația Composer

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) Cere din nou pachetele, cu naming-ul nou

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

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

Dacă preferi să nu atingi manual composer.json, există un script de migrare care face update automat:

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

Iar dacă folosești GitHub Action-ul Roots pentru a urmări update-urile de pluginuri, acesta a fost redenumit din „WPackagist Changelog Action” în WP Composer Changelog Action, cu suport complet pentru formatul wp-plugin/<em> și wp-theme/</em>: https://github.com/roots/wp-composer-changelog-action

Performanță: de ce WP Composer poate rezolva dependențele mult mai repede

Dincolo de partea de guvernanță și independență, WP Composer vine cu un avantaj foarte pragmatic: performanță mai bună la composer install / composer update, în special când nu ai cache (cold resolve).

Diferența tehnică majoră: WP Composer suportă protocolul Composer v2 metadata-url, ceea ce permite lui Composer să descarce metadata doar pentru pachetele de care are nevoie. WPackagist folosește încă modelul mai vechi provider-includes, care obligă Composer să descarce fișiere de index mari, cu metadata pentru mii de pachete, înainte să poată rezolva dependențele.

Timp de resolve (cold, fără cache)

Valorile de mai jos sunt pentru cold resolve (cache gol) – mai mic înseamnă mai bine:

10 pluginuri: WP Composer 0.7s vs WPackagist 12.3s (aprox. 17x mai rapid)
20 pluginuri: WP Composer 1.1s vs WPackagist 19.0s (aprox. 17x mai rapid)

Metadata și caching: diferențe care se simt în practică

Composer v2 metadata-url: WP Composer Yes, WPackagist No
CDN caching: WP Composer folosește public, max-age=300, WPackagist folosește no-cache, private
Fișiere per-pachet: WP Composer folosește fișiere immutable, content-addressed, cache-uite pe termen nedefinit; WPackagist nu folosește content addressing

Despre benchmark-uri

Testele au fost rulate dintr-o singură locație, folosind Composer 2.7+. Rezultatele pot varia în funcție de regiune și condițiile de rețea. Scripturile de benchmark sunt publice: https://github.com/roots/wp-composer/tree/main/benchmarks

Open source, cap-coadă (inclusiv deploy)

Un aspect important pentru orice infrastructură critică: WP Composer este fully open source. Codul aplicației, documentația și configurația de deployment sunt disponibile pe GitHub: https://github.com/roots/wp-composer

Asta înseamnă inclusiv că oricine poate contribui, poate face fork și poate rula propria instanță, dacă are nevoie de asta (de exemplu, pentru cerințe interne sau pentru redundanță).

Finanțare din comunitate (și ce înseamnă asta pentru independență)

WP Composer este finanțat integral de comunitate prin GitHub Sponsors: https://github.com/sponsors/roots

Sponsorizările susțin direct infrastructura, dezvoltarea și mentenanța WP Composer, dar și ecosistemul Roots în ansamblu. Pentru echipele care se bazează pe Composer în proiecte WordPress, modelul acesta de finanțare e un mod concret de a păstra tooling-ul independent și disponibil.

Ideea principală: un repo Composer pentru WordPress ar trebui să fie neutru și predictibil

WP Composer bifează două lucruri pe care, ca dezvoltatori, le simțim imediat: un naming coerent (wp-plugin/<em>, wp-theme/</em>) și un salt semnificativ de performanță la rezolvarea dependențelor datorită metadata-url. La fel de important însă este cadrul: un proiect transparent, open source, finanțat de comunitate, unde direcția nu depinde de o singură entitate comercială.