WP DryDock

Local WordPress Development with Docker.

Documentation: https://docs.wpdrydock.com/

Why?

• ~5 Minute Setup.
• Uses Dotenv for environment variable management.
• Uses PSR-4 Autoloader to encapsulate functionality.
• Keeps content separate from core
• Keeps functionality separate from theme.
• Uses Laravel Mix as a wrapper for Webpack to compile styles and scripts.

Quick Start

Setup

• Download and install Docker
• Clone this repository to your working directory.
• Copy ./.env.dev to ./.env
• From your project root, run docker compose up -d
• From your project root, run docker exec -ti wpdd-php bash
• This logs you in to the php container at: /var/www/html
• From /var/www/html run ./buildfresh.sh Windows Note
• In a browser, visit http://localhost
• Configure WordPress
• Activate the Keel theme.
• Develop.

Development Workflow

• From your project root, run docker exec -ti wpdd-php bash to log in to the PHP container.
• From /var/www/html, run npm run watch to watch & compile scripts & styles.
• To log out of the PHP container type exit
• To shut down Docker services, from your project root, run docker-compose down

Coding Standards

PSR-2

Gitflow Workflow

• This project uses the Gitflow Workflow.

Versioning

Semver
Given a version number MAJOR.MINOR.PATCH, increment the:

• MAJOR version when you make incompatible API changes,
• MINOR version when you add functionality in a backwards-compatible manner, and
• PATCH version when you make backwards-compatible bug fixes.

buildfresh.sh Error on Windows Host

If you encounter an error while running ./buildfresh.sh:

• Open buildfresh.sh in a text editor
• Change the file's line endings to LF.
• Re-run ./buildfresh.sh
• If error persists:
• From: /var/www/html run chmod +x ./buildfresh.sh

License

GNU GPL v3.0 or Later

Changelog

Version 1.1.0

• Add Open Graph Support

Version 1.0.0 —

• Falling Into Infinity.