README

Note

This is a fork of johnpbloch/wordpress-core-installer with fixes to enhance compatibility with roots/wordpress.

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) 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). 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 using Composer with WordPress, check out our Composer WordPress resources. Use WP Packages to install WordPress plugins and themes via Composer, and see the roots/wordpress documentation for WordPress core installation options.

Support us

Roots is an independent open source org, supported only by developers like you. Your sponsorship funds WP Packages and the entire Roots ecosystem, and keeps them independent. Support us by purchasing Radicle or sponsoring us on GitHub — sponsors get access to our private Discord.

Requirements

• Composer 2+
• PHP 7.2.24+

Composer 2 requires explicitly allowing plugins. If needed, run:

composer config --no-plugins allow-plugins.roots/wordpress-core-installer true

Community

Keep track of development and community news.

• Join us on Discord by sponsoring us on GitHub
• Join us on Roots Discourse
• Follow @rootswp on Twitter
• Follow the Roots Blog
• Subscribe to the Roots Newsletter