Download the PHP package enpii/wp-site-enpii-boilerplate without Composer

Introduction

This is the modern WordPress setup for shared-host development.

• It uses Apache for Docker to make your development simple and it would be consistent for deployment to shared-host (mostly use Apache)
• It includes task runner based on webpack to allow theme, plugins assets compiling
• It also includes phpcs and phpcbf to ensure the the codestyle of the project

Initialize

• Create the project (stable version)

  • Use development version (branch master)

  in case you want to specify the branch (e.g. branch develop)

• Ensure that you have the .env file, if it doesn't exists, you can copy from the example file

• Then use the appropriate env variables for you working environment, remember to check the SALTS section to use correct ones.

Development

• Update the dependencies

Deploy with Docker

• Start all containers

then the website would be available at http://127.0.0.1:19080/ (the port 19080 can be edited in .env file but you need to down and up the containers again)

• Update composer with Docker

• Run phpcs

or

to fix the codestyle issue

• Run wp-app artisan

or

Running wp-cli

• With Docker

• On local machine, stay on the project root

Working with GIT

• You can put your own plugins, themes, mu-plugins to corresponding folders. Then if you use git, you can add these things to your repository by:

  • Update the ./wp-content/.gitignore to allow your plugins, mu-plugins, themes

  • e.g. you have a plugin called hello-world, you need to add this

  • Then you can git add <your-plugin-folder> to the repo
• To ensure the Git hook runs automatically on the server at the post-commit stage—executing phpcbf to fix PHP CodeSniffer (PHPCS) errors, running phpstan for verification, and staging modified files—contributors need to clone the repository and set up the core.hooksPath configuration. If core.hooksPath isn’t already configured, make sure it is set up by running:

Compiling assets (CSS, JS)

• This repo consists of a sample plugin Demoda and a sample theme Appeara Alpha, it has the webpack configs to compile plugin and theme CSS and JS

To install dependencies

Compile plugin assets

or to watch and compile

Similar to the theme with

and watch