Boilerplate designed to get you up and running with Catalyst WP in a few short minutes.
Note: The best way to utilize this package is via the Catalyst WP CLI as it will automatically generate necessary configuration files.
- Composer Support
- Wordpress Loaded from
/wp
directory .gitignore
setup
- Make sure you have Composer installed
- Clone this repo and
cd
into it via terminal - Run
composer install
- Add database credentials and nonces to
wp-config.php
(see gotchas below) - Duplicate the Atom theme and name the copied directory
atom-child
- Update the child theme's
style.css
header so thatTheme Name:
isAtom Child
and add a field forTemplate: atom
- Profit
For more details on working with the Catalyst WP Toolbox see documentation for the Atom Theme
-
Catalyst WP CLI will generate a
wp-config.php
file for you. If you're not using the CLI you will need to manually create one in the project root - do not put in the/wp
directory. You will also need to add the following lines to the file:- Autoload Composer dependencies
require __DIR__ . '/vendor/autoload.php';
- Load dependencies from the
/wp
and/wp-content
directoriesdefine('WP_CONTENT_DIR', dirname( __FILE__ ) . '/wp-content'); define('WP_CONTENT_URL', 'http://' . $_SERVER['SERVER_NAME'] . '/wp-content'); define('WP_SITEURL', 'http://' . $_SERVER['SERVER_NAME'] . '/wp'); define('WP_HOME', 'http://' . $_SERVER['SERVER_NAME']);
- Autoload Composer dependencies
-
Certain out of the box wordpress hosts may not let you have control over the
index.php
file which is required to load the composer version of wordpress. As long as you are using WP v4+ you should be fine -
Some hosts may also not allow you to modify
wp-config.php
if this is the case you need to find somewhere you can add the composer autoload script. Or find a new host.
Note: Please submit any issues you are having to the Atom Theme