Block Areas

August 20, 2019

Block Areas Plugin

Introduces a simple method for defining block areas to use the block editor outside of the post content.

Introduces a simple method for defining block areas to use the block editor outside of the post content.

This is an experimental plugin that explores basic usage of Gutenberg blocks outside of the content bubble, on a sitewide level.

In the long term it will likely eliminate itself once WordPress core and Gutenberg will have completed the next phase of advancing to the sitewide level. The plugin exists as a baseline to have an easy way for experimenting with similar functionality already today.

Usage

After activating the plugin, you can create and edit block areas under Appearance > Block Areas. There should be two block areas already, header and footer.

Block areas are identified by their unique slug. Since header and footer are expected to exist, make sure not to delete them.

In order to print a specific block area, for example in your theme, use block_areas()->render( $slug ) (e.g. block_areas()->render( 'header' )).

You can also explicitly add theme support, specifying which block area slugs your theme relies on (e.g. add_theme_support( 'block-areas', 'header', 'footer' )).

Installation

  1. Upload the entire block-areas folder to the /wp-content/plugins/ directory or download it through the WordPress backend.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.

Screenshots

  1. Block areas admin screen

    Block areas admin screen

FAQ

Where should I submit my support request?

For regular support requests, please use the wordpress.org support forums. If you have a technical issue with the plugin where you already have more insight on how to fix it, you can also open an issue on Github instead.

How can I contribute to the plugin?

If you have some ideas to improve the plugin or to solve a bug, feel free to raise an issue or submit a pull request in the Github repository for the plugin. Please stick to the contributing guidelines.

You can also contribute to the plugin by translating it. Simply visit translate.wordpress.org to get started.

Changelog

0.2.0

  • Allow themes to explicitly add block-areas theme support and specify which areas they use.

0.1.0

  • Initial release

Details

  • Version: 0.2.0
  • Active installations: 70
  • WordPress Version: 5.0
  • Tested up to: 5.2.21
  • PHP Version: 7.0

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars