For development, you have to install Docker and docker-compose.
On Mac OS X you can install Docker for Mac which comes bundled with docker-compose. Requirements include Yosemite 10.10.3+ or newer.
- Download and open the dmg from Docker Desktop for Mac
- This requires you to make a login with Docker Hub, which somewhat controversial
Or if you use homebrew
brew install docker
If you're on MAC OS X or Linux, you have to add yourself to the docker group in order to run docker commands without root privileges. Running docker commands with root privileges will cause hard-to-debug errors to crop up. To add yourself to the docker group, run sudo usermod -aG docker <YOUR USERNAME>.
Clone this repository and run docker-compose up -d to run it locally. (If you encounter a TLS Handshake timeout, try running docker logout as disccused in this issue). This will create two Docker containers, one for MySQL database, another for Cloyne
blog. You should see them running through docker ps. Wait for around 10
seconds for all internal container processes to start correctly and open IP as
returned by boot2docker ip, or open 127.0.0.1 on Linux, in your browser and
you should see Wordpress installation wizard. Initially database is empty and
you have to configure your local version of Cloyne blog. Probably you should
configure it similar to deployed Cloyne blog is so that you can test things.
Script runs Cloyne blog in a way that it maps plugins and themes directories
directly into the container. This means you can just work directly on them and
just reload in the browser. Once you are satisfied with your changes, you commit
and push to GitHub.
See also: cloyne/servers for how to update the version on the website.
Plugins are stored in plugins directory. You can add plugins you want there.
But the best way is that you add plugin through as a git
submodule. For example:
git submodule add https://github.com/benhuson/wp-mailfrom.git plugins/wp-mailfrom-ii
Navigate to this repository (docker-blog) in your terminal. Then, run the following commands:
git submodule update --init --recursivegit submodule update --remote
In the plugins folder, you will find a folder for each WordPress plugin. Inside each one, will be a php file named after the plugin. For example, for the Redirection plugin, you can find the following file: plugins/redirection/redirection.php.
In the top few lines of this file, you should be able to find the plugin version number. Verify that it has increased to the desired version. When you are satisfied, commit the changes.
Most changes you will do by modifying theme. Simply modify necessary PHP or CSS files and this is it. Have in mind that sometimes it is better to create a placeholder in the template which can later on be filled through Wordpress web admin interface instead of hard-coding the code change you want.
To upgrade the theme, start by upgrading cloyne/wordpress. This will update the twentythirteen theme. We want to apply all the updates from that to themes/cloyne in this repository. One way to do this is to simply copy the twentythirteen folder over the cloyne folder:
cp PATH_TO_DOCKER-WORDPRESS/docker-wordpress/wordpress/wp-content/themes/twentythirteen/* themes/cloyne -Rf
and then go through with git add -p to skim the changes and add the ones in
files Cloyne hasn't changed. The files with Cloyne-specific changes are
footer.php, functions.php, header.php, and style.css.
To upgrade the version of wordpress, see cloyne/docker-wordpress
If you click the first page and forget the password go back to the terminal and close the processes by typing docker-compose down. Then type git reset --hard to reset the directories and try the process again. Note: this resets everything in the local working copy.