Investigate and document use of reusable blocks in Gutenberg

[benlk]

• Is the Group block available in Core yet?
• Can the Group block be made reusable? (yes)
• How can the reusable block be edited?

[benlk]

Released in 5.5: https://github.com/WordPress/gutenberg/releases/tag/v5.5.0
Current Gutenberg version is 5.8: https://github.com/WordPress/gutenberg/releases

WP 5.2 is up to Gutenberg 5.4: https://make.wordpress.org/core/2019/04/16/wordpress-5-2-field-guide/

[benlk]

Reusable blocks are not documented in WordPress's user handbook (https://wordpress.org/support/article/wordpress-editor/) or developer docs (https://developer.wordpress.org/block-editor/), so we should think about submitting any documentation we create for INN's users here to WordPress.org: WordPress/gutenberg#11210

[benlk]

If we're going to want to rely on reusable blocks, we may want to add a sidebar link directly to the list of reusable blocks, as described in WordPress/gutenberg#15549 (comment):

add_action( 'admin_menu', 'linked_url' );
function linked_url() {
    add_menu_page( 'linked_url', 'Reusable Blocks', 'read', 'edit.php?post_type=wp_block', '', 'dashicons-editor-table', 22 );
}

add_action( 'admin_menu' , 'linkedurl_function' );
function linkedurl_function() {
    global $menu;
    $menu[1][2] = "/wp-admin/edit.php?post_type=wp_block";
}

[benlk]

I expect that reused content will last for several paragraphs. There's no interface to make multiple content blocks reusable in a coherent chunk, so we'll have to make those chunks of content into a single block somehow. That means we'll need a container block, which is what the Group block is.

To get the Group block, we'll need to install the Gutenberg plugin on staging, at least until the next major WordPress release.

@MirandaEcho / @kaylima what documentation do you think we'll need for our users?

That I can foresee:

• what is a reusable block?
• how do I create one?
• how do I convert existing content to a reusable block?
• how do I see a list of existing reusable blocks? (three-dot menu, block inserter, https://learn-inn-org.inndev.staging.wpengine.com/wp-admin/edit.php?post_type=wp_block)
• how do I add a reusable block to a post or page?

[benlk]

On hold until after the training meeting.

[annezazu]

Noting that I just worked on and published this doc: https://wordpress.org/support/article/reusable-blocks/ Closing the loop just in case it's helpful :)