Add block pattern management

[justintadlock]

@annezazu reached out to see what I thought of integrating my Block Pattern Builder plugin into Create Block Theme. One of the pain points being that the pattern creation process was a bit too manual for non-technical users.

BPB was originally built as a proof of concept of a pattern manager that I'd envisioned core WP eventually handling. The current release is not 100% up to date with the current Patterns API features, but I've been working locally to update it.

I'm happy to start on the process of a PR if this is desirable for the plugin.

If so, I imagine one thing that would need to change is prefixes. Names/prefixes:

• Patterns: bpb/pattern-name
• CPT: bpb_pattern
• Taxonomy: bpb_pattern_category
• Role capabilities: bpb_cap_name

Any thoughts on naming/prefixing for those things?

---

Potential features:

• Allow user-created patterns to be exported with a theme
• Allow deleting theme patterns via the Editor; or allow theme patterns to be excluded from the theme export

[matiasbenedetto]

I haven't used this plugin before, and I'm curious about the differences with this recently launched plugin for managing patterns.

Will integrating your plugin add any new features different from the other plugin?

[justintadlock]

Block Pattern Builder was primarily built for users and hasn't been updated in a bit for newer Pattern API features. In and of itself, it wouldn't add any new features.

Pattern Manager was built primarily for developers as part of their workflow. It'd be an obvious choice to integrate into Create Block Theme.

[annezazu]

I'll ask the folks behind the other plugin too about possible integration in case there are a few ways forward here. Ultimately, just want to see what we can do in the short term to make patterns easier and easier to create and manage.

[ndiego]

Now that 6.3 includes the ability for users to create both synced and standard patterns from within the Editor, it would be great to revisit this issue. Creating standard patterns in the Editor and then exporting them directly to the theme, much like templates and template parts, would be amazing.

cc @mikachan 😉

[annezazu]

Bringing in feedback from the FSE Hallway Hangout last week as this continues to come up as as a pain point and borderline deterrent currently. Specifically, here are the notes:

We discussed the potential and power of patterns alongside the overall pain points in managing/maintaining them. Mike talked about the early days before you could create them in the interface and how cumbersome the process was (had to create in the page, export the content, put it into a file, figure out the image, etc). Maintaining patterns is immense still: have to manually put in a file, translate the strings again, change the image tags, etc.

We talked about incorporating this more into the Create block theme plugin folks, some of whom were on the call, and they haven’t had the bandwidth to add it in yet. However, it’s clear that this is a part of the UI that isn’t covered well anywhere right now and definitely needs attention.

“If you were to tell this to a new user for distribution, they would say no way.” - Mike McAllister.

As work is underway to consider what to tackle next, I hope this can be taken into consideration!

[justintadlock]

Just some other thoughts, which I also shared in the above-linked Hallway Hangout:

My Block Pattern Builder plugin wouldn't be ideal for what theme authors would need. It was built specifically for pattern management for end-users and saves patterns in the database. Of course, this feature is now a part of core WP.

What's needed is a way to write patterns to disk---files in the theme's /patterns folder---since the ultimate goal would be to make a distributable theme.

[carolinan]

I am not sure I understand the goal, let me try to summarize

1. We want to be able to create patterns via the pattern creation interface:

• Whether that is in the Site Editor or the "classic" admin screen

2. When exporting the theme, the pattern that is saved in the database should create files inside the themes patterns folder

• Text strings should be translation ready
• Media file path should be updated and media saved inside the theme folder

Wouldn't this be doable in a similar way as when template changes are exported from the database?
Without looking at the code in the plugin, media files are already moved and the code that includes the media path is already turned into a pattern file, correct?

[carolinan]

I think we must consider the long term. I believe the plan is to make template parts synced patterns.
Right now template parts are in a strange "limbo" as they often only contain a single pattern. In those cases, the template part is only used because it is synced, because there is no easy way for themes to register synced patterns.

[mikachan]

@aaronrobertshaw @glendaviesnz 👋 I know you've been working a lot with patterns in Gutenberg and for WP 6.4. Are there any existing plans around exporting patterns as part of the theme export? We want to explore this as part of Create Block Theme, but it would be good to know if there are any other plans within Gutenberg before we start. Thanks!

[georgestephanis]

Also acknowledging parallels with a discussion I was having with @scruffian yesterday about the importance of importing block patterns (possibly from a directory) to enable composite themes where folks can have a block theme and ad-hoc import home page (or other) templates (as block patterns) or the like from a directory -- enabling export as well would be the flip side of enabling migrations from staging to production sites -- and then the export could enable packaging it up to upload to a directory.

The other thing I was discussing was that it would likely require the block that embeds patterns may need to start referring to the pattern by slug instead of by post_id -- as slug can be consistent cross-site, but if exported/imported, post_id wouldn't be. That feels like an important shift as well.

Finally, if it's useful and semi-related to this area, something we cobbled together a bit ago as fork of another plugin to track usage of reusable block patterns: https://github.com/a8cteam51/Reusable-Block-Count -- which is a very basic ~100 line plugin.

[glendaviesnz]

@aaronrobertshaw @glendaviesnz 👋 I know you've been working a lot with patterns in Gutenberg and for WP 6.4. Are there any existing plans around exporting patterns as part of the theme export?

There is an open issue here about patterns breaking theme export, but we currently have no plans to pick this up as we will be focused on partial syncing for 6.5, so feel free to pick this up.

This issue here will probably be related, as this work will most likely involve adding a slug to the synced patterns, as the current id can't be reused between themes.