Skip to content

Group: Add allowedBlocks attribute and pass it to innerBlockProps - #49128

Merged
Mamaduka merged 3 commits into
WordPress:trunkfrom
sque89:fix/group-not-supporting-allowed-blocks
Apr 20, 2023
Merged

Mamaduka merged 3 commits into
WordPress:trunkfrom
sque89:fix/group-not-supporting-allowed-blocks

Conversation

@sque89

@sque89 sque89 commented Mar 16, 2023 •

Copy link
Copy Markdown
Contributor

What?

Adding the allowedBlocks attribute to the core/group block and pass it into the innerBlockProps to be considered by the InnerBlocks component

Why?

Being able to constraint the allowedBlocks for a group from an InnerBlocks template is crucial to provide a convenient yet failsafe editing environment

How?

By adding support of the allowedBlocks attribute to the core/group block a theme and/or block developer can then constraint the allowed blocks for the group

Testing Instructions

Positive Test

  1. Create a custom block which makes use of a InnerBlocks component
  2. define a template for InnerBlocks which includes a group
  3. set the allowedBlocks attribute of this group to 'core/paragraph'
  4. check that in the editor, only paragraph blocks can be added as inner blocks to the group

Negative Test

  1. add a group block directly to a post
  2. check that all blocks can be inserted as inner blocks

Testing Instructions for Keyboard

Screenshots or screencast

@github-actions github-actions Bot added the First-time Contributor Pull request opened by a first-time contributor to Gutenberg repository label Mar 16, 2023
@github-actions

Copy link
Copy Markdown

👋 Thanks for your first Pull Request and for helping build the future of Gutenberg and WordPress, @sque89! In case you missed it, we'd love to have you join us in our Slack community, where we hold regularly weekly meetings open to anyone to coordinate with each other.

If you want to learn more about WordPress development in general, check out the Core Handbook full of helpful information.

@sque89
sque89 force-pushed the fix/group-not-supporting-allowed-blocks branch from 304ad9a to 5e8b1f4 Compare March 16, 2023 09:51
@Mamaduka Mamaduka added [Type] Enhancement A suggestion for improvement. [Block] Group Affects the Group Block (and row, stack and grid variants) labels Mar 16, 2023
@sque89

sque89 commented Mar 23, 2023

Copy link
Copy Markdown
Contributor Author

Any news on this PR? Do i have to do something to get it reviewed? Just to be sure i am not missing something. Thanks!

@carolinan

carolinan commented Mar 27, 2023 •

Copy link
Copy Markdown
Contributor

This is quiet a large and time consuming step 1 in order to test the PR:

Create a custom block which makes use of a InnerBlocks component

Can you link to a premade plugin that does this?

@sque89

sque89 commented Mar 27, 2023

Copy link
Copy Markdown
Contributor Author

@carolinan thanks for reaching out. I don't have one in the plugin store but here i am attaching one as a zip file. It includes a block "Test" which has the proper configuration to test the positive scenario above (it only allows the core/paragraph block to be added inside the group of it).

test-fix-group-not-supporting-allowed-blocks.zip

@sque89

sque89 commented Mar 31, 2023

Copy link
Copy Markdown
Contributor Author

@carolinan sorry i don't want to stress on this too much, but it would help a lot in our current project. Do you think this can be merged soon? Thanks a lot.

@carolinan

Copy link
Copy Markdown
Contributor

In my brief testing, the pull request works in the sense that with the plugin, the test block displays the templated heading and paragraph, and only allows inserting new paragraphs.

I am not sure this is the correct solution or if the expectation is that developers should be able to add this via a filter.
I would like to see a few more reviews.

The PR needs to be rebased and the conflict needs to be solved.

@fabiankaegy fabiankaegy left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this is a great addition, and the mechanism is correct. Usually, we wouldn't want to change the allowed block list within the group globally. But only on a per-instance basis. Like in a pattern, only text, lists, and buttons should be allowed to be inserted.

But of course I will leave the final approach up to someone that is closer to the codebase

@fabiankaegy
fabiankaegy requested review from Mamaduka and gziolo March 31, 2023 14:49
@sque89

sque89 commented Apr 11, 2023

Copy link
Copy Markdown
Contributor Author

@Mamaduka @gziolo very sorry to notify you again. But since this is a very small change which is reviewed in a matter of few minutes i guess and since it is quite important for our project, i was hoping the review could happen soon?

Would very much appreciate it. Thanks a lot!

@Mamaduka

Copy link
Copy Markdown
Member

Hi, @sque89

I just returned from a little break and am still catching up with notifications. I'll try to review/test the PR properly this week.

Meanwhile, let's resolve the failing static analysis check @carolinan suggested. If you have ESLint or Prettier add-on enabled in your code editor, they should handle similar issues automatically on save. See: https://developer.wordpress.org/block-editor/contributors/code/getting-started-with-code-contribution/#eslint

Current error:

[2] /home/runner/work/gutenberg/gutenberg/packages/block-library/src/group/edit.js
[2]   93:9  error  Replace `·tagName:·TagName·=·'div',·templateLock,·allowedBlocks,·layout·=·{}·` with `⏎↹↹tagName:·TagName·=·'div',⏎↹↹templateLock,⏎↹↹allowedBlocks,⏎↹↹layout·=·{},⏎↹`  prettier/prettier

@gziolo

gziolo commented Apr 12, 2023

Copy link
Copy Markdown
Member

I see a similar approach used with the Cover and Columns blocks, so it should be fine if it works the same way. It'd be great to find out why there isn't a more general way available that all blocks with inner blocks could benefit from.

@gziolo

gziolo commented Apr 12, 2023 •

Copy link
Copy Markdown
Member

I just returned from a little break and am still catching up with notifications. I'll try to review/test the PR properly this week.

@Mamaduka, it seems like it is close conceptually with block locking. Do you think it could become one day one of the options that you can set with UI when creating block patterns? Does it make sense to implement it similarly, as it works internally for block locking?

@gziolo

gziolo commented Apr 18, 2023

Copy link
Copy Markdown
Member

I'm linking for reference an old issue #15682 where it wasn't possible to filter the list of allowed blocks. If we come up with a general solution here, we would gain options to address that limitation.

@sque89

sque89 commented Apr 18, 2023

Copy link
Copy Markdown
Contributor Author

Hi @Mamaduka so sorry to tag you here again, but since this change would help us so much in our current project, i just wanted to ask if you had the time to review this change and if i can support you in any way to go on with this. Thanks a lot for your time.

@Mamaduka Mamaduka changed the title group block: add allowedBlocks attribute and pass it to innerBlockProps Group: Add allowedBlocks attribute and pass it to innerBlockProps Apr 20, 2023

@Mamaduka Mamaduka left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you, @sque89. The changes here work as expected!

@gziolo, UI should be done when there's a "native" flow/screen for pattern creation. I also commented on the issue you've referenced regarding the general implementation.

@carolinan, you can also provide the allowedBlocks attribute to any Group block for testing. Here's the markup I used for my tests:

<!-- wp:group {"allowedBlocks":["core/paragraph","core/heading","core/image"],"layout":{"type":"flex","orientation":"vertical"}} -->
<div class="wp-block-group"></div>
<!-- /wp:group -->

Screenshot

CleanShot 2023-04-20 at 13 44 24

@Mamaduka
Mamaduka merged commit 646f2e8 into WordPress:trunk Apr 20, 2023
@github-actions

Copy link
Copy Markdown

Congratulations on your first merged pull request, @sque89! We'd like to credit you for your contribution in the post announcing the next WordPress release, but we can't find a WordPress.org profile associated with your GitHub account. When you have a moment, visit the following URL and click "link your GitHub account" under "GitHub Username" to link your accounts:

https://profiles.wordpress.org/me/profile/edit/

And if you don't have a WordPress.org account, you can create one on this page:

https://login.wordpress.org/register

Kudos!

@desrosj

desrosj commented Aug 1, 2023

Copy link
Copy Markdown
Member

@sque89 If you have a moment, could you connect your GitHub account to your wordpress.org one? This change is slated to be included in the upcoming WordPress 6.3 release on August 8th, and it would be great if we could give you attribution by mentioning you on the credits screen. You can find more details on how contributions are tracked and how connecting GitHub accounts helps in this post on the Make WordPress Core blog.

@sque89

sque89 commented Aug 1, 2023

Copy link
Copy Markdown
Contributor Author

@desrosj thanks for reaching out. My Github wordpress account should be connected now.

@desrosj

desrosj commented Aug 1, 2023

Copy link
Copy Markdown
Member

Great! Just confirmed. Thanks again for your contribution!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

[Block] Group Affects the Group Block (and row, stack and grid variants) First-time Contributor Pull request opened by a first-time contributor to Gutenberg repository [Type] Enhancement A suggestion for improvement.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants