Make WordPress Core

Opened 4 years ago

Closed 4 years ago

#49926 closed enhancement (fixed)

Editor: Introduce WP_Block class

Reported by: aduth's profile aduth Owned by: gziolo's profile gziolo
Milestone: 5.5 Priority: normal
Severity: normal Version:
Component: Editor Keywords: has-patch has-unit-tests dev-feedback
Focuses: Cc:


Related: #48104

The Gutenberg project is currently exploring the introduction of a new block context feature. As part of this effort and in order to make this context available as part of the existing render_callback function signature of block settings, in Gutenberg#21467 a new WP_Block class was introduced to serve the purpose of providing a first-class interface for plugins to interact with an instance of a block from within their own render callbacks.

Like in the browser client, this is intended to be distinct from the block value which is produced directly from the parser, and which is otherwise made available through existing low-level filters `render_block_data` and `render_block`.

See related discussion:

Proposed tasks:

  • Introduce new WP_Block class (see implementation from Gutenberg#21467 for initial reference)
  • render_block constructs WP_Block and largely defers to the implementation of a WP_Block::render (see implementation from Gutenberg#21467 for initial reference)
  • Consolidate WP_Block_Type::render and WP_Block::render (the former can likely pass-through to the latter)

Note: `render_block` and serialize_block currently receive $block in the parsed array form. While I remarked differently on the original pull request, I don't know that these actually need to change, since it seems rather sensible that these would except to receive blocks in their parsed forms. If one has access to a WP_Block instance and needs to create its rendered representation, the instance's render function can be used directly.

Feedback welcome: While the above can be considered a proposal of tasks, this is all very much subject to change.

Change History (9)

This ticket was mentioned in Slack in #core-php by aduth. View the logs.

4 years ago

#2 @aduth
4 years ago

Related: #49927

#3 @aduth
4 years ago

There have been a few iterations to block context in Gutenberg after the pull request referenced in the original comment.


It's quite likely there will be further iterations to WP_Block in Gutenberg.

The most up-to-date version should be found at:

Up-to-date file history:

#4 @gziolo
4 years ago

  • Keywords has-patch added
  • Milestone changed from Awaiting Review to 5.5

#5 @gziolo
4 years ago

  • Keywords has-patch removed

This ticket was mentioned in PR #351 on WordPress/wordpress-develop by gziolo.

4 years ago

  • Keywords has-patch has-unit-tests added

Trac ticket:

This PR ports the most up-to-date version of the WP_Block class added to Gutenberg:

It also adds a corresponding unit tests.

There is a follow-up backport necessary to wire this class when using new block context features as tracked in

#7 @gziolo
4 years ago

  • Keywords dev-feedback added

TimothyBJacobs commented on PR #351:

4 years ago

I think this needs @since comments on all the classes, methods, and properties not just for the file.

#9 @gziolo
4 years ago

  • Owner set to gziolo
  • Resolution set to fixed
  • Status changed from new to closed

In 48159:

Editor: Introduce WP_Block and WP_Block_List classes

Backports functionality added in Gutenberg in the following PRs:

It's a few ideas related to block rendering and the provided block value, which is particularly impactful for work around block context.

Props aduth, TimothyBJacobs, noisysocks, epiqueras, youknowriad, talldanwp, zebulan.
Fixes #49926.

Note: See TracTickets for help on using tickets.