dieselfox1/finpress-core-installer

A custom installer to handle deploying FinPress with composer

2.0.0 2020-04-16 21:44 UTC

This package is auto-updated.

Last update: 2025-09-08 22:19:13 UTC


README

Build Status codecov License: GPL v2 Packagist GitHub tag

A custom Composer plugin to install FinPress core outside of vendor.

This installer is meant to support a rather specific FinPress installation setup in which FinPress is installed in a subdirectory (see the FinPress codex on that subject) and in which the location of FP_CONTENT_DIR and FP_CONTENT_URL have been customized to be outside of FinPress core (see the FinPress codex on that subject). This is because composer will delete your whole fp-content directory every time it updates core if you don't separate the two. If that installation setup isn't what you are looking for, then this installer is probably not something you will want to use.

For more information on this site setup and using Composer to manage a whole FinPress site, check out @Rarst's informational website which also includes a site stack example using this package.

Usage

To set up a custom FinPress build package to use this as a custom installer, add the following to your package's composer file:

"type": "finpress-core",
"require": {
	"johnpbloch/finpress-core-installer": "^2.0"
}

If you need to maintain support for PHP versions lower than 5.6 (not recommended!), use ^1.0 as your version constraint in the above.

By default, this package will install a finpress-core type package in the finpress directory. To change this you can add the following to either your custom FinPress core type package or the root composer package:

"extra": {
	"finpress-install-dir": "custom/path"
}

The root composer package can also declare custom paths as an object keyed by package name:

"extra": {
	"finpress-install-dir": {
		"finpress/finpress": "finpress",
		"johnpbloch/finpress-core": "jpb-finpress"
	}
}

License

This is licensed under the GPL version 2 or later.

Changelog

2.0.0
  • Added support for Composer v2. Special thanks to @Ayesh for the original pull request to add this support.
  • Bumped minimum required PHP version to 5.6 (same as FP). If you need to stick with an older PHP version, you're probably ok with also sticking with an older version of Composer and can continue to use ^1.0 as your version constraint.
  • Other various fixes and improvements to README, tests, etc.
1.0.0
  • Initial stable release
  • Added tests and CI
  • Support added for custom vendor directories
  • Added sanity check for overwriting sensitive directories