CC WordPress 2016

Changes

• WordPress is now handled by composer. composer.json contains the exact version of WP we're using.

See http://getcomposer.org/ for installation details.

• Some times composer update will not give any results, in which case composer remove wordpress && composer require wordpress will fix the problem.

Set-up

There are some handy setup scripts in the scripts directory. On a fresh Ubuntu 12.04 LTS server, you should only need to run scripts/bootstrap.sh, which calls other scripts to set most things up. See below for some details on the other scripts.

Note that one of the scripts is run with sudo. If you don't have sudo enabled for this user, then you'll need to run the scripts manually.

Regardless of how you run the setup scripts, you'll still need to manually configure a few things:

1. Edit docroot/wp-config-local.php and fill in values as needed by WordPress.
2. Set up SSL keys in /etc/ssl/private. If there isn't a key for the hostname being set-up, then the Apache config will not include an SSL virtual host. Simply re-run the setup script if you add a key.
3. If desired, load DB data from another WordPress install (see below)

Editing the Apache config

If you need to edit the Apache config, the files are:

• apache.conf: CC Apache config in macro form.
• /etc/apache2/httpd.conf: Includes the apache.conf file in this checkout.
• /etc/apache2/sites-available/: Virtual host definition which uses a macro defined in apache.conf to pull in a lot of rules and settings. This file gets overwritten by the setup script, so if you edit it, do not run it again.

Loading DB data

If you want to import DB data from another WordPress install, use the mysqldump / mysql utilities to create a backup and restore it here:

# on the source machine:
mysqldump -u root dbname | gzip > backup.sql.gz

# ... copy (eg. with scp) ...

# then on this machine:
zcat backup.sql.gz | mysql -u root -p dbname

Bootstrap scripts (details)

Note that the scripts/bootstrap.sh script calls these for you. But if something goes wrong / you want to know more:

• scripts/bootstrap_server_ubuntu.sh: Will configure an Ubuntu 12 server (install packages, set up apache, set up mysql). Should be run as root.

• scripts/bootstrap_checkout.sh: Sets up this checkout by downloading git submodules, creating a virtual Python environment, etc. Should be run as this user (does not touch system files).

Happy hacking!

Thanks

• Our thanks to BigV and BrowserStack for their donation of tools and services.

Support

Problems? Write to us at [email protected] or send us a pull request...

Updated: April 2016.