New directory names for block-based (FSE) themes

TL;DR:
As of the currently available WordPress 5.9 BetaBeta A pre-release of software that is given out to a large group of users to trial under real conditions. Beta versions have gone through alpha testing in-house and are generally fairly close in look, feel and function to the final product; however, design changes often occur as part of the process. 1 release the directory names in blockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience.-based (FSEFSE Short for Full Site Editing, a project for the Gutenberg plugin and the editor where a full page layout is created using only blocks.) themes are changing. The name for the directory containing template files will be templates, and the name for the directory containing template part files will be parts.

WordPress 5.9 will be released on 25 January 2022 (see the current release schedule here) and marks the arrival of block-based themes, also known as full-site editing (FSE).

Developers who have already experimented with creating block-based themes during the run-up to the release of 5.9 should note that the directory names for templates and template parts are being changed.

Previously the names for the directories containing template files and template part files were:

  • block-templates
  • block-template-parts

With the release of 5.9 these will instead be:

  • templates
  • parts

This change is detailed in PR #36647. The documentation in the Block Theme Overview and Create a block theme pages has been updated to reflect this.

The rationale behind this change is that it creates a cleaner and clearer directory naming paradigm that will simplify the addition of further directories in the future, such as styles and patterns , should they be needed.

For more insight into the rationale underlying this change please see issues #34550 and #36548.

This change is backwards compatible and the old names will still continue to work, but note that the old and new directory names are mutually exclusive and cannot be combined. You cannot call one directory block-templates and the other parts, for example.

This change is already implemented in the currently available Beta 1 release of WordPress 5.9.

#block-based-themes, #theme-documentation

Block themes meeting Notes — Nov 3

Location: #themereview, the full transcript begins here.

Facilitated by @mikachan

GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/ + Themes Updates

Themes team representative nominations

Friday, November 5 2021 is the deadline to nominate themes team representatives. You can read more and nominate someone here: https://make.wordpress.org/themes/2021/10/27/nominations-call-for-the-themes-team-representatives/

Open Floor

There was a nice conversation around Full Site editing, designing block themes, and sharing resources beginning here: https://wordpress.slack.com/archives/C02RP4Y3K/p1635956395106000

Some questions that were asked:

  • Can you create Gutenberg theme from scratch without templates?
  • How can I design my theme if I create all the default folders and files?
  • Can I use CSSCSS CSS is an acronym for cascading style sheets. This is what controls the design or look and feel of a site. in the editor?
  • With FSE, is there a need to build custom themes the old way?
  • Do ACF work with FSE?

Thanks everyone for participating, please comment if there’s something you would like to add.

#block-based-meeting, #block-based-themes

Block-based Meeting Notes — July 7

Important: this meeting will now occur once a month, rather than bi-monthly. The calendar and make pages have been updated accordingly, thanks @kafleg @kjellr.

Meeting location #themereview make slackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/..

Facilitated by @scruffian

Full transcript starting here: https://wordpress.slack.com/archives/C02RP4Y3K/p1625670047176500

GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/ + Theme Updates

11.0.0 was released, here are some relevant highlights:

  • PR that allows left/right/centre alignments inside “use default layout” containers
  • PR that allows blockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. templates to be filtered, it could be useful for more advanced theming
  • PR  customize Global Styles…
  • Color palettes in Global Styles discussion: https://github.com/WordPress/gutenberg/issues/29568
  • Trying a few approaches to internationalization within a “pattern block” or as a standalone block.

Open Floor

  • Please join or check out the Hallway Hangout at 5pm UTC today (July 7) focused on exploring the Thrive theme with theme.json test: https://make.wordpress.org/test/2021/06/24/call-for-testing-thrive-with-theme-json/
  • There is a patch to add support for the new block-templates functionality to twenty twenty-one: https://core.trac.wordpress.org/ticket/53564. It could use additional reviews.
  • There was consensus among the group that since TT1 Blocks has been mostly stable, bi-monthly meetings are not as useful. We will shift to monthly meetings instead!

Please comment below if you have anything to add or a question about the above 🙂 Thank you!

#block-based-meeting, #block-based-themes

Block-based Theme Meeting Notes — June 16, 2021

You can find the full meeting transcript on Slack (login required)

Meeting coordinator: @kjellr
Notes kept by @ashiquzzaman

GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/ Updates:

  1. theme.jsonJSON JSON, or JavaScript Object Notation, is a minimal, readable format for structuring data. It is used primarily to transmit data between a server and web application, as an alternative to XML. no longer fails silently if you miss a comma: https://github.com/WordPress/gutenberg/pull/3240
  2. On FSEFSE Short for Full Site Editing, a project for the Gutenberg plugin and the editor where a full page layout is created using only blocks. adoption and “universal” themes, this issue has gained some additional traction this week: https://github.com/WordPress/gutenberg/pull/31235. This filterFilter Filters are one of the two types of Hooks https://codex.wordpress.org/Plugin_API/Hooks. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output. would allow themes with blockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. templates to opt in or out of using the full-site editor. This would allow universal themes to support the customizerCustomizer Tool built into WordPress core that hooks into most modern themes. You can use it to preview and modify many of your site’s appearance settings. while FSE is under development (even with the Gutenberg pluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party installed), and then gracefully enable the full-site editor when it’s ready.
  3. A call to attention on how block themes look in 5.8 (without the Gutenberg plugin active). Today, some block themes have implemented fallbacks or messages about requiring the plugin. But it varies per theme. From the discussion, it sounds like themes might get better built-in messaging like that for the 5.8 release. You can follow along with that or weigh in here: https://core.trac.wordpress.org/ticket/53410

Open Floor/ Q&A:

@scruffian highlighted the process on how authors are using Global Styles (especially – colors) as a mechanism for customizing their site. If you have a color that is used extensively in your site and then you want to change it, the only way to do so is to update that color in every place it’s used, which is quite laborious.

@onemaggie voiced the same concern with fonts, if a theme uses two fonts through multiple blocks, the user needs to go block by block if they want to change both

@aristath highlighted an update from GutenbergLand: theme.css files now also have the ability to be “lazy-loaded” when a block gets rendered, and there’s a PR to allow adding multiple stylesheets per-block. https://github.com/WordPress/gutenberg/pull/32510

#block-based-meeting, #block-based-themes

Block-based Meeting Notes — May 19, 2021

You can find the full meeting transcript on Slack (login required)

Meeting coordinator: @jffng
Notes kept by @ashiquzzaman
Time: Wednesday, 19 May 2021, 21:00 GMT+6
Channel: #themereview

GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/ + Themes Updates:

The feature freeze for Gutenberg 10.7 is today

  • You can now remove the experimental prefix from your theme.jsonJSON JSON, or JavaScript Object Notation, is a minimal, readable format for structuring data. It is used primarily to transmit data between a server and web application, as an alternative to XML. files: https://github.com/WordPress/gutenberg/pull/29981

A fallback was added so it’s not going to break if you still have the experimental-theme.json file name.

  • There is on-going discussion and work about how the theme color palette and coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. color palette interact and are surfaced to users. Very interesting reading and progress: https://github.com/WordPress/gutenberg/pull/31669

In the Full Site Editing project, the template resolution logic was simplified for its inclusion in core: https://github.com/WordPress/gutenberg/pull/31604

TT1 Block Updates

@poena highlighted that the theme needs to be tested and packaged for release to .org . It becomes more difficult to do the call for testing in the FSEFSE Short for Full Site Editing, a project for the Gutenberg plugin and the editor where a full page layout is created using only blocks. outreach program without the updated theme on .org. She is also working on removing the theme blocker. All the TT1 reupload to the theme directory can be tracked here – https://github.com/WordPress/theme-experiments/issues/264

Discussion: continue the Universal Themes conversation from last week’s hangout:

The global styles UIUI UI is an acronym for User Interface - the layout of the page the user interacts with. Think ‘how are they doing that’ and less about what they are doing. will not be in 5.8. As 5.8 is a minimum viable productMinimum Viable Product "A minimum viable product (MVP) is a product with just enough features to satisfy early customers, and to provide feedback for future product development." - WikiPedia.
@Grogou how can users configure global styles? @poena replied – Per block, per template, with reusable blocks, and patterns. or, why not let the theme author offer the templates that work well with the theme.

There are some ongoing experiments to see what else can be done (via CustomizerCustomizer Tool built into WordPress core that hooks into most modern themes. You can use it to preview and modify many of your site’s appearance settings.) but nothing concrete that can’t already be done via PHPPHP PHP (recursive acronym for PHP: Hypertext Preprocessor) is a widely-used open source general-purpose scripting language that is especially suited for web development and can be embedded into HTML. http://php.net/manual/en/intro-whatis.php. template pages.

So a mix (using theme.json to build a ‘base style’ with php template pages to execute logic from configuration options set in a classic way via Customizer) is the straightest line for 5.8 without the Gutenberg PluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party where Global Styles UI can be leveraged in the FSE.

@aristath mentioned that a lot of concern regarding feature parity between the customizer and the site-editor.
The fact that something can be edited in the site-editor doesn’t necessarily mean that it should also be editable from the customizer.
It is possible to expose all global-styles options in the customizer and save them the way that global-styles get saved, the customizer has the architecture to support that. But someone has to write that bridge, and tbh it’s just not a priority or necessity for anyone at this stage.

@scruffian shared an example of how to change Global Styles in the Customizer: https://github.com/Automattic/themes/pull/3856

@aristath is working on a package that will allow legacy themes to use theme.json : https://github.com/WPTT/theme-json-parser, Being able to use the theme.json file is one step closer to block themes and should allow theme authors to remove a lot of CSSCSS CSS is an acronym for cascading style sheets. This is what controls the design or look and feel of a site..

#block-based-meeting, #block-based-themes