## them.es WordPress Blocks

**them.es WordPress Blocks** is a WordPress "Gutenberg" blocks boilerplate which can be included in a theme.

## What's included?

- Gutenberg blocks configuration tested in WordPress v5.1+
- NPM configuration
- ESNext
- Support for Editor color palettes
- Support for a category where all custom blocks can be organized
- A simple "Hello world" block implementation is included
- Optional: Easily add more blocks

## Setup

- Prerequisites: [Node.js](https://nodejs.org) (NPM) needs to be installed on your system
- [Download](https://github.com/them-es/wordpress-blocks-starter/archive/master.zip) the source code of this repository to a new directory (e.g. `/blocks`) in your WordPress theme
- Add the following code snippet to `functions.php` in your theme

```
$theme_blocks = __DIR__ . '/blocks/index.php';
if ( is_readable( $theme_blocks ) ) :
	require_once $theme_blocks;
endif;
```

- Open `/blocks` in Terminal and install the required Node.js dependencies
- `$ npm install`
- A simple `Hello world` block implementation is included to get you started. More examples can be found in the official [Gutenberg examples repository](https://github.com/WordPress/gutenberg-examples)
- You can easily include additional blocks by duplicating `/src/block#` and referencing the new block(s) in `/src/index.js`
- Run the **`start`** script
- `$ npm run start`
- Develop the block(s) by modifying `/src/block#/index.js` - the official [Gutenberg Handbook](https://wordpress.org/gutenberg/handbook/designers-developers/developers/tutorials/block-tutorial/writing-your-first-block-type) may help you learn how to build blocks
- When you're done run the **`build`** script to create a minified version of your blocks
- `$ npm run build`
- Now you can test the block(s) in the WordPress Editor

## Technology

- [WordPress Scripts](https://github.com/WordPress/gutenberg/tree/master/packages/scripts), [GPLv2+](https://github.com/WordPress/gutenberg/blob/master/packages/scripts/package.json)
- [Gutenberg](https://wordpress.org/gutenberg/handbook/designers-developers/developers), [GPLv2+](https://github.com/WordPress/gutenberg/blob/master/LICENSE.md)

## Copyright & License

Code and Documentation © [them.es](https://them.es)

Code released under [GPLv2+](https://www.gnu.org/licenses/gpl-2.0.html)