Skip to content
This repository has been archived by the owner on Aug 31, 2021. It is now read-only.

nhobi/Start-Here

Repository files navigation

Start-Here WordPress Theme

A simple WordPress theme boilerplate. Uses a lot of BlankSlate's base code but adds code indentation, a gruntfile, and some other goodness.

Stuff It Has

  • Prebuilt gruntfile.js which uses grunt-contrib-less, grunt-postcss (with autoprefixer), and grunt-contrib-watch
  • A bower.json file that contains popular front-end packages
  • Pre-registered ACF options page
  • Hook for adding a responsive container (with class .video-container) around WordPress' sweet automatic WYSIWYG video embeds
  • Some basic LESS code organization

System Requirements

  • NPM (Node.js)
  • Grunt.js command line utility npm install -g grunt-cli
  • Bower command line utility npm install -g bower

Setup

  1. Using your favorite editor, run a find-and-replace, replacing 'Start-Here' and 'starthere' for whatever you want to name your custom theme.
  2. Assuming the requirements are met, open your terminal, cd into the theme directory and run npm install (you'll only have to do this once per project). After all your NPM packages have been installed, run bower install to install front-end dependencies.
  3. Run grunt.
  4. Develop the crap out of your custom theme.

Notes

  • Only the most common templates in the template hierarchy have been left in the root of the theme. All other templates are stored in _partials/themes. Nothing magical here; to start using one of the templates in _partials/themes, simply copy it to the root.
  • It's best not to modify functions.php. Instead, add a new file in _partials/functions and load it using _partials/functions/_loader.php.
  • When adding a new functions file, the naming convention is <action/filter name>.php. If there is no action or filter, the naming convention is <function name>.php. If you have multiple functions in a given file with no actions or filters, the naming convention is shame_<whatever you want>.php (go make a plugin).

About

A simple WordPress theme boilerplate.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published