Skip to content
This repository has been archived by the owner on Nov 14, 2024. It is now read-only.

Latest commit

 

History

History
103 lines (68 loc) · 3.42 KB

README.md

File metadata and controls

103 lines (68 loc) · 3.42 KB
Raw

Tonik — Wordpress Theme Boilerplate

The develop branch tracks boilerplate development and it's not a stable code. If you want a stable version, use the master branch or one of the latest releases.

Boilerplate aims to be compatible with a large range of PHP versions, however, still have modern tooling for developing a theme.

What's inside?

The front-end builder was borrowed from our html-frontend-boilerplate project.

Requirements

Boilerplate follows a WordPress minimal requirements. Make sure you have these dependences installed before moving on:

  • PHP >= 5.2.4

Theme uses NPM as a front-end dependency manager. Make sure your development machine has installed following dependencies:

Installation

WordPress themes lives in the wp-content/themes folder. This is where we have to fetch our fresh starter files.

# Go to the `themes` directory of your WordPress installation.
$ cd wp-content/themes

Create project via composer create-project composer command.

$ composer create-project tonik/wordpress-theme-boilerplate <theme-name>

You can also directly download or clone the repository to the wp-content/themes directory.

# Clone repository to the <theme-name> folder.
$ git clone -b master [email protected]:tonik/wordpress-theme-boilerplate.git <theme-name>

Development

A Gulp task runner is used to compile and optimize theme's scripts, stylesheets, and images.

Resolving front-end dependencies

Before being able to build theme you have to resolve required dependencies.

# @ wp-content/themes/<theme-name>

# Install node dependencies.
$ npm install

Now you have all the packages necessary to run the build process and start developing your theme.

Building a Theme

There are a few available commands which help you to build the theme for different environments:

# @ wp-content/themes/<theme-name>

# Compiles unminified and unoptimized theme assets with source maps.
$ npm run development

# Alias for `development` command.
$ npm run dev

# Compiles minified and optimized theme assets without source maps.
$ npm run production

# Alias for `production` command.
$ npm run prod

# Builds assets for development, runs watcher (recompiles on change)
# and BroswerSync (refreshes browser).
$ npm run watch

Contributing

Great that you are considering supporting the project. You have a lot of ways to help us grow. We appreciate all contributions, even the smallest.

  • Report an issue
  • Propose a feature
  • Send a pull request
  • Star project on the GitHub
  • Tell about project around your community

License

The Tonik WordPress Theme Boilerplate is licensed under the MIT license.