akimsko/courier

Install composer packages to custom folders

Courier Composer Plugin.

This composer installer will install any package-type, to any path you wish., _(*1)

It can be any of composers built-in package-types, or you can invent your own package-types, as you see fit., _(*2)

In order for this plugin to work, it must be required in the package that specifies the custom install paths., _(*3)

Like so..., _(*4)

{
  ...
  "require": {
    "akimsko/courier": "~1.0"
  }
}

From here, you can override install paths for all package-types required by this package, by defining them in the extra section., _(*5)

The extra-option is courier-paths, and must contain one or more entries of <package-type>: <directory>., _(*6)

To insert the package name in the path use {name} (The package name after the '/')., _(*7)

To insert the vendor name in the path use {vendor} (The package name before the '/')., _(*8)

Like so..., _(*9)

{
  ...
  "extra": {
    "courier-paths": {
      "my-custom-module-type": "modules/{vendor}-{name}",
      "my-custom-theme-type": "theme/{name}"
      "library": "lib/{vendor}/{name}"
    }
  }
}

This will install all packages of type my-custom-module-type to <projectroot>/modules/<vendor-name>-<package-name>., _(*10)

All packages of type my-custom-theme-type to <projectroot>/themes/<package-name>., _(*11)

And finally all packages of type library to <projectroot>/lib/<vendor-name>/<package-name>., _(*12)

If a package-type does not match anything in courier-paths extra section, it will be installed to the default vendor path as normal., _(*13)