WordPress dengan Composer

Setelah beberapa tahun (seriously) saya akhirnya harus bersentuhan lagi dengan WordPress. Banyak yang berubah sejak terakhir saya ngoprek — semakin bagus, tapi codebase-nya juga semakin besar karena pergeseran fokus dari sekedar engine blog menjadi CMS platform yang sangat fleksibel.

Project yang sedang saya kerjakan butuh beberapa 3rd-party library, jadi saya coba integrasikan WordPress dengan Composer untuk mempermudah dependensi dan autoloading. Awalnya saya pikir akan sulit — WordPress di sini berperan ganda sebagai webroot sekaligus package dependency. Ternyata salah; sudah ada library Composer yang bisa mendefinisikan webroot directory dan webroot package sehingga kita bisa mendikte di mana paket di-deploy.

Kabar baik berikutnya: wpackagist.org me-mirror plugin dan theme dari wordpress.org dan menggunakan composer installer, jadi kita bisa instal plugin/theme via Composer dengan mengkonfigurasi installer-paths di composer.json.

Konfigurasi composer.json

{
  "name": "chz/test",
  "description": "whatever it takes. lets roll",
  "license": "MIT",
  "repositories": [
    { "type": "composer", "url": "https://wpackagist.org" },
    {
      "type": "package",
      "package": {
        "name": "wordpress",
        "type": "webroot",
        "version": "3.8",
        "dist": {
          "type": "zip",
          "url": "https://github.com/WordPress/WordPress/archive/3.8.zip"
        },
        "require": { "fancyguy/webroot-installer": "1.0.0" }
      }
    }
  ],
  "require": {
    "php": ">=5.3.0",
    "wordpress": "3.8",
    "fancyguy/webroot-installer": "1.0.0",
    "wpackagist/wp-original-media-path": "1.3.0",
    "wpackagist/w3-total-cache": "0.9.3"
  },
  "require-dev": {
    "wpackagist/debug-bar": "~0.8",
    "wpackagist/debug-bar-console": "~0.3"
  },
  "extra": {
    "wp-content": "public/content",
    "webroot-dir": "public/wp",
    "webroot-package": "wordpress",
    "installer-paths": {
      "public/content/plugins/{$name}/": ["type:wordpress-plugin"],
      "public/content/themes/{$name}/":  ["type:wordpress-theme"]
    }
  }
}

Beberapa poin penting:

• Deklarasi package repositories untuk webroot-installer, wpackagist, dan wordpress.
• Spesifik untuk WordPress kita tandai sebagai webroot.
• Di blok extra, webroot-package di-deploy ke webroot-dir. Semua dependency bertipe wordpress-plugin di-deploy ke public/content/plugins/{$name}/.
• Wpackagist otomatis menandai plugin dan theme dengan tipe yang sesuai.

Struktur Direktori

Hasilnya, dengan sedikit manual copy-paste:

public/
├── content/
│   ├── themes/
│   └── plugins/
├── media/
├── wp/
├── index.php
├── wp-config.php
├── wp-config-production.php
└── wp-config-local.php
vendor/
composer.json

Trus Ngapain Susah-susah?

Pertanyaan yang valid kalau ada 5-minutes install. Personal preference — berikut yang saya suka dari instalasi kustom ini:

• Mencegah backward-compatibility break saat update core/plugin: GUI update di wp-admin di-disable, semua update dilakukan via Composer. composer update selesai.
• Karena instalasi WP terpisah dari file webroot yang sudah dimodifikasi, composer update tidak konflik.
• Maintenance dependency lebih gampang — import dan autoloading di-handle Composer. A big win.
• VCS lebih bersih, hanya berisi codebase milik kita.
• Dengan bantuan wp-original-media-path, struktur URL di front-end bebas dari prefix bawaan wp- — termasuk asset theme/plugin dan uploaded media. Hanya akses wp-admin yang masih menggunakan URI WordPress.

It worth the extra work.

Suksma.