PHPackages                             johnpbloch/wordpress-core-installer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [DevOps & Deployment](/categories/devops)
4. /
5. johnpbloch/wordpress-core-installer

ActiveComposer-plugin[DevOps & Deployment](/categories/devops)

johnpbloch/wordpress-core-installer
===================================

A custom installer to handle deploying WordPress with composer

2.0.0(6y ago)22110.8M↑19.7%42[5 issues](https://github.com/johnpbloch/wordpress-core-installer/issues)20GPL-2.0-or-laterPHPPHP >=5.6.0

Since Aug 6Pushed 4y ago11 watchersCompare

[ Source](https://github.com/johnpbloch/wordpress-core-installer)[ Packagist](https://packagist.org/packages/johnpbloch/wordpress-core-installer)[ RSS](/packages/johnpbloch-wordpress-core-installer/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (3)Versions (12)Used By (20)

WordPress Core Installer
========================

[](#wordpress-core-installer)

[![Build Status](https://camo.githubusercontent.com/001dc9f89356446c1c659f65a9ab24c0a9df2dd2410391c4e0bdc36f3a731420/68747470733a2f2f7472617669732d63692e6f72672f6a6f686e70626c6f63682f776f726470726573732d636f72652d696e7374616c6c65722e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/johnpbloch/wordpress-core-installer)[![codecov](https://camo.githubusercontent.com/63270bbdd2fda507386fb3c4a69b76580a40b1f57dfc5a551aeaa5752e336faa/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f6a6f686e70626c6f63682f776f726470726573732d636f72652d696e7374616c6c65722f6d61737465722e737667)](https://codecov.io/gh/johnpbloch/wordpress-core-installer)[![License: GPL v2](https://camo.githubusercontent.com/77e900ae34f8da9ccccc42662fce61a94ab07ddbfe3f7d066178e824f3673dbd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d47504c25323076322d626c75652e737667)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)[![Packagist](https://camo.githubusercontent.com/64f2953b9c888123ec3ccb62ce5d2bdf73f1d1d40457b15fd90fd5faf9ebb85a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a6f686e70626c6f63682f776f726470726573732d636f72652d696e7374616c6c65722e737667)](https://packagist.org/packages/johnpbloch/wordpress-core-installer)[![GitHub tag](https://camo.githubusercontent.com/a6342e467d56f57499268f1ceec694bffd7a321b1d673962cf2311d9ac8c049c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f7461672f6a6f686e70626c6f63682f776f726470726573732d636f72652d696e7374616c6c65722e737667)](https://camo.githubusercontent.com/a6342e467d56f57499268f1ceec694bffd7a321b1d673962cf2311d9ac8c049c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f7461672f6a6f686e70626c6f63682f776f726470726573732d636f72652d696e7374616c6c65722e737667)

A custom Composer plugin to install WordPress core outside of `vendor`.

This installer is meant to support a rather specific WordPress installation setup in which WordPress is installed in a subdirectory ([see the WordPress codex on that subject](https://wordpress.org/support/article/giving-wordpress-its-own-directory/)) and in which the location of `WP_CONTENT_DIR` and `WP_CONTENT_URL` have been customized to be outside of WordPress core ([see the WordPress codex on that subject](https://wordpress.org/support/article/editing-wp-config-php/#moving-wp-content-folder)). This is because composer will delete your whole wp-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 WordPress site, [check out @Rarst's informational website](https://composer.rarst.net/) which also includes [a site stack example using this package](https://composer.rarst.net/recipe/site-stack/).

### Usage

[](#usage)

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

```
"type": "wordpress-core",
"require": {
	"johnpbloch/wordpress-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 `wordpress-core` type package in the `wordpress` directory. To change this you can add the following to either your custom WordPress core type package or the root composer package:

```
"extra": {
	"wordpress-install-dir": "custom/path"
}
```

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

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

### License

[](#license)

This is licensed under the GPL version 2 or later.

### Changelog

[](#changelog)

##### 2.0.0

[](#200)

- 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 WP). 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

[](#100)

- Initial stable release
- Added tests and CI
- Support added for custom vendor directories
- Added sanity check for overwriting sensitive directories

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity64

Solid adoption and visibility

Community36

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 93% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~244 days

Recently: every ~202 days

Total

11

Last Release

2223d ago

Major Versions

0.2.1 → 1.0.02017-05-31

1.0.2 → 2.0.02020-04-16

### Community

Maintainers

![](https://www.gravatar.com/avatar/044e10bd302ddb296511f2a463f61314bc17338c34fc0d292d05a425c655bc34?d=identicon)[johnpbloch](/maintainers/johnpbloch)

---

Top Contributors

[![johnpbloch](https://avatars.githubusercontent.com/u/446833?v=4)](https://github.com/johnpbloch "johnpbloch (66 commits)")[![Ayesh](https://avatars.githubusercontent.com/u/811553?v=4)](https://github.com/Ayesh "Ayesh (1 commits)")[![dangrussell](https://avatars.githubusercontent.com/u/4387475?v=4)](https://github.com/dangrussell "dangrussell (1 commits)")[![Rarst](https://avatars.githubusercontent.com/u/737584?v=4)](https://github.com/Rarst "Rarst (1 commits)")[![szepeviktor](https://avatars.githubusercontent.com/u/952007?v=4)](https://github.com/szepeviktor "szepeviktor (1 commits)")[![vinkla](https://avatars.githubusercontent.com/u/499192?v=4)](https://github.com/vinkla "vinkla (1 commits)")

---

Tags

wordpress

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/johnpbloch-wordpress-core-installer/health.svg)

```
[![Health](https://phpackages.com/badges/johnpbloch-wordpress-core-installer/health.svg)](https://phpackages.com/packages/johnpbloch-wordpress-core-installer)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)