Installation


First time installation

Create your local WordPress installation

First of all, you should prepare the development environment. I may suggest the following:

đź’ˇ

I suggest you also use PHP Monitor, a lightweight, native Mac menu bar app that works best when accompanied by Laravel Valet (but it also works without it).

To start developing a WP Bones plugin, you must have a copy of WordPress files. You can download the latest WordPress release from wordpress.org.

Create your plugin

To create your WP Bones plugin, you can use one of our ready-made boilerplate templates available on GitHub. You can choose one of the following:

  • WPKirk Boilerplate - this is the base template, without examples inside, recommended for experienced users.
  • WPKirk Complete Demo - this is the template with several examples inside, recommended for beginners.
⚠️

The WPKirk Complete Demo requires PHP version 8.2+ or higher due to the illuminate/database package.

For both, you can choose to create your repository on GitHub using the available templates or clone the repository directly to your computer.

By using the GitHub template

On GitHub, you can create a new repository using the WPKirk Boilerplate by clicking on the “Use this template” button on the repository page.

Create a new plugin from template

Clone from GitHub

You may also clone the repository using either the Git command line or the GitHub for Mac application. Change the directory to the wp-content/plugins folder of your local WordPress installation.

cd wp-content/plugins

The complete demo

git clone -b main https://github.com/wpbones/WPKirk.git <your plugin folder>

The simple boilerplate

git clone -b main https://github.com/wpbones/WPKirk-Boilerplate.git <your plugin folder>
⚠️

If you have cloned the repository instead of using the GitHub template, you should remove the .git folder before creating your own Git repository. So run

rm -rf .git

Install the necessary packages to compile the assets

From within your plugin folder, run:

npm install

Take a look at the Assets section to learn more.

Check the installation

Next, from inside your plugin folder, try to run:

php bones

You should see:

WP Bones CLI

Install

Finally, install the WP Bones Framework inside the plugin:

php bones install

đź‘Ź Awesome! You are ready to start developing your first WP Bones plugin.