Bolts WP

1.0.1

Bolts WP is your new favourite developer theme (at least for WordPress) - tough enough to power (and easily maintain) websites of any shape and size, yet so simple that you can become a power user within a day. It focuses on removing complexity and streamlining development without creating a whole new workflow. Its not trying to recreate the wheel, just make it rounder.

Bolts WP has a modern workflow and many of the build tools you´ve come to love and expect, out of the box:

Webpack for bundling and task running
Babel for transpiling and polyfilling ES6+
Sass with Autoprefixer, CSSNano and MQPacker for styles
ESLint, Stylelint and Prettier for linting and code formatting
Bolts front-end library

As for the PHP, Bolts WP is component oriented and features helpers to keep your code as DRY as possible. Just use the component() function, pass in your data and never write any markup in your page templates again.

The theme also features a lot of handy functions and cleaning defaults, removing bloat and filling WP's blatant gaps, making the workflow more normalized and easy to use.

Installation
Build scripts
- For development
- For production

Installation

Run git clone in your themes directory to install the theme
Run npm install to install all npm packages

Build scripts

For development

npm run dev bundles a unminified development version of the theme
npm run watch bundles a development version every time a SCSS or JS file changes

For production

npm run build bundles a production ready theme.

PHP Defaults

Bolts WP features a couple of defaults used both during the init, but also by some of our functions. They are all configurable with define(), that should be done in functions.php.

Name	Type	Default Value
`BOLTS_WP_DEFAULT_MENU_LOCATION`	Bool	`false`

Content functions

get_page_ids_by_template( $template )

Return an array of page ids that match the specified template

get_page_id_by_template( $template )

Return the first page id that matches a template

is_template( $template, $post_id = false )

Return whether the current (or specified) post matches a template

is_post_type( $post_type, $post = false )

Determine if a post has a specific post type

get_title( $post_id = false, $filtered = false )

Return the title of a post

get_content( $post_id = false, $filtered = false )

Return the content of a post

get_excerpt( $post_id = false, $words = false, $more = false )

Return the excerpt for a post (manual or automatically generated)

get_author( $post_id = false, $field = 'display_name' )

Return author information from a post (defaults to display name)

get_date( $post_id = false, $format = false )

Return formatted date from a post

get_featured_image( $post_id = false, $size = 'full', $fallback = false )

Return the URI for the featured image of a post

get_media( $attachment_id, $size = 'full', $fallback = false )

Return the path to an attachment in the media library

Theme functions

component( $file, $args = false )

Include a template part from the components folder, with optional arguments

get_theme_dir()

Return the current theme directory

get_theme_uri()

Return the current theme directory URI

get_asset( $asset, $fallback = false )

Return the path to a theme asset file

get_svg( $asset, $fallback = false )

Return .svg file parsed for inline use

create_post_type( $slug, $singular, $plural, $icon = null, $custom_args = false )

create_taxonomy( $slug, $singular, $plural, $post_type = 'post', $custom_args = false )

layout_items($items, $item_class = false)

Used in layout components. Loop through the layout items and output components from their data, if a class and a class suffix is present wrap the component in a div.

get_menu_object($location = false)

Return an object with the full menu structure for a menu location

pocketsize/bolts-wp