Gutenberg + Themes: Week of August 9, 2021

Hello! This is the 60th weekly roundup of theme-related discussions, fixes, and developments in 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/.  

As always, please weigh in on the tickets below — your feedback is crucial and appreciated. 

Issues / Discussions & PRs

  • Themes: 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 should have a way to set a default headerHeader The header of your site is typically the first thing people will experience. The masthead or header art located across the top of your page is part of the look and feel of your website. It can influence a visitor’s opinion about your content and you/ your organization’s brand. It may also look different on different screen sizes. and footer that maps to traditional header.php and footer.php in terms of backwards compatible loading #33989
  • Themes: Site Editor should be available for child themes if the appropriate index.htmlHTML HTML is an acronym for Hyper Text Markup Language. It is a markup language that is used in the development of web pages and websites. file exists in the parent #33959
  • Themes: Create a CSSCSS CSS is an acronym for cascading style sheets. This is what controls the design or look and feel of a site. Library|Framework from SASS 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. Library for theme developers #33806
  • Themes: Unable to set margin on headers using 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. #33795
  • Themes: A theme.json from child themeChild theme A Child Theme is a customized theme based upon a Parent Theme. It’s considered best practice to create a child theme if you want to modify the CSS of your theme. https://developer.wordpress.org/themes/advanced-topics/child-themes/. is not merged with the one in parent theme #33512
  • Themes: Improve the way we handle custom units and how we interact with themes config. #33470
  • Themes: Backend vs frontend discrepancy using alignment (left/right) if theme.json is active #33385
  • Themes: Add block spacing gap config to theme.json and add support for this CSS variable to the “flow/default” layout. #33812
  • Themes: Using a shortcodeShortcode A shortcode is a placeholder used within a WordPress post, page, or widget to insert a form or function generated by a plugin in a specific location on your site. block inside a Group block – Using alignment to make the shortcode block wider. #33886
  • FSE: Fascinating Behaviors – Prepping themes/functionality for transition to FSE from 5.8 as a base. #33942
  • FSE: Site editor: fix for how CSS Custom Properties are generated #33932
  • Global Styles: Display font families from theme, coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress., and user in font family picker #33889
  • Global Styles: Color Block Support: Switch to ToolsPanel for displaying 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. #33889
  • Global Styles: Use Global Styles or theme.json to style individual blocks #33977
  • Global Styles: Using “layout” in theme.json adds margin-left and -right: auto with !important to full width elements #33956
  • Global Styles: Query pagination: Styles from theme.json are being overwritten by default block styles #33871
  • Global Styles: allow merging custom block settings with global settings. #33805
  • Global Styles: Theme.json styling for image gets unexpected results for background and border #33794
  • Global Styles: Unable to apply padding through theme.json on rss block #33791
  • Global Styles: Duotone 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.: Allow theme.json to set default filters for blocks #33642

Merged/Fixed/Announced

  • FSE: Implement a settings object filter #33737 
  • Global Styles: Site editor: fix presets for blocks with multiple selectors #33951
  • Global Styles: Remove the experimental prefix and rename theme.json files #33925
  • Global Styles: No longer read from experimental-theme.json #33904
  • Global Styles: Add slashes back to the Theme JSON #33919
  • Global Styles: Fix Global Styles transient key clash #33844

Overview Issues

  • Global Styles: Design Tools Overview #33447

General Resources:

Thanks to @mikachan for compiling this week’s update.

#gutenberg-themes-roundup

Themes Team Meeting Notes – August 10, 2021

Thank you to all the participants and contributors. New participants are always welcome. 

Meeting location: #themereview channel on the WordPress 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/.

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

  1. Facilitator: @kafleg
  2. Notetaker: @Benachi

Here is this week’s meeting agenda. Thank you @kafleg for preparing the agendas. 

Firstly, yesterday marks @poena last day as a team representative for the Themes Team. Thank you for all your contributions for more than 10 years!

1. Weekly updates

The themes team published weekly updates about tickets and HelpScout emails. See this week’s updates here in the past 7 days,

  • 338 tickets were opened
  • 363 tickets were closed:
  • 338 tickets were made live. 
  • 41 new Themes were made live.
  • 297 Theme updates were made live.
  • 1 more were approved but are waiting to be made live.
  • 25 tickets were not approved.
  • 0 tickets were closed-newer-version-uploaded.

Number of reviewers: 4

2. Requirement changes 

The theme requirements have been updated!

The changes were made after the theme review rep had the zoom discussion with the theme authors. The updated requirement page is here

The zoom meeting notes can be found here. Thank you @peona@kafleg, and all participants for facilitating the updates. 

3. Open floor 

There were no discussions regards to theme development at today’s meeting. 

#meeting, #meeting-notes, #themes-team

Meeting Notes | Themes Team and Theme Authors Regarding Requirements Change

Date: 28th June 2021

Purpose: This meeting was called to discuss the proposed requirements changes for themes. 

Meeting Video: WordPress.Tv

Attendees Themes Team:

  1. Ganga Kafle (@kafleg)
  2. Carolina Nymark (@poena)

Attendees Theme Authors:

  1. Shiva Shanker Bhatta
  2. Ashish Shrestha
  3. Theme Ansar
  4. Yam Chhetri 
  5. Ankit Dubey 
  6. Umesh Ghimire 
  7. Prashant 
  8. Quamruz Zaman

Meeting Overview: 

On July 20, the team published a Request for feedback on requirement changes.

In the post, Carolina mentioned that the themes team was going to do a Zoom meeting with theme authors, and asked participants to sign up.

The meeting started with an introduction. We increase the meeting time to 90 minutes. We did not cover all agenda items.

Attendees Questions and Concerns

The attendees were very interested in the future of themes, how to add support for 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. to existing themes, and migrating custom widgets.

  • One of the attendees, Umesh Ghimire asked about making a hybrid theme (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. + FSE). 
  • Shiva asked how to add full site editing support to existing themes.
    • Carolina replied that this is complex but that you can start adding partial support by adding a theme.json file to enable the Template Editing feature. Carolina added that she personally only recommends this for new themes because it can take time to update the existing CSSCSS CSS is an acronym for cascading style sheets. This is what controls the design or look and feel of a site..
  • Will existing themes be required to convert to FSE? No.
  • Is there a future date when only FSE themes will be supported in the theme directory? No.

Discussion on proposed Requirements Changes

The themes team wants to know the theme authors’ opinions of the proposed requirements changes.

Most of the theme authors agreed and they didn’t find anything additional to remove from the requirements.

One of the proposals included allowing theme authors to use custom blocks in themes. We discussed how to migrate existing custom widgets to 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. patterns or blocks without breaking the website on the theme switch.

Further exploration and tests are needed to see if we can find a way to allow custom blocks in themes, no conclusion was reached at the current time.

Carolina recommended theme authors to use block patterns and block styles, but also to provide examples of converted widgets that we can test with.

Another proposal came up in the discussions for updating the theme page in the theme directory to make it more like the 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 directory.

During the meeting, we went over a few guidelines one by one:

Single Themes Rule

Only submit one theme at a time.

@kafleg brought up trying to remove the single theme rule. Once theme reviews are automated, there will not be a queue, and then the rule has no purpose.

The participants preferred to keep the rule for now.

AccessibilityAccessibility Accessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility) Requirements 

Theme authors are fine with the current requirement and agree that it’s good to have these features in themes.

License of images

Participants brought up that it is difficult to find images that are GPLGPL GPL is an acronym for GNU Public License. It is the standard license WordPress uses for Open Source licensing https://wordpress.org/about/license/. The GPL is a ‘copyleft’ license https://www.gnu.org/licenses/copyleft.en.html. This means that derivative work can only be distributed under the same license terms. This is in distinction to permissive free software licenses, of which the BSD license and the MIT License are widely used examples. compatible and asked what licenses were allowed and if Unsplash images could be allowed.

@poena mentioned that there will be a new image service on WordPress.orgWordPress.org The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https://wordpress.org/ where theme authors can download compatible images.

@kafleg mentioned that if anyone knows of image providers with compatible images, please share the links so that the team can add them to the list of recommended resources.

There was an additional question about images in the demo content. The themes team does not check the images that are used in external content. Theme authors are recommended to discuss possible implications with their own legal team before using and sharing any images that they have purchased or downloaded.

License of Icons 

Theme authors want to know if they can use trademarked icons such as social sharing icons in the theme screenshot.
The recommendation is to avoid them, and if there are take-down requests the theme may need to be temporarily removed until the screenshot is updated.

Updated screenshot requirements

There was a question about if a theme can display a design in the screenshot, that is not possible to create with the theme or with a free downloadable site or starter template.

Carolina replied that the team is loosening the screenshot requirements. That this screenshot in particular was probably missed because it is not possible for a reviewer to test all templates that are offered, especially if plugins need to be installed.

Readme file

There was a question about why the readme file is required and if there needs to be a changelog, or if the changelog can be remote.

-The changelog is not required now, but the plan is to display the readme file content in the theme directory, including the changelog.

Design and Code Copy 

All code and design should be your own or legally yours. Cloning of designs is not acceptable

The theme authors brought up that this requirement is unclear and it is too difficult to know what the themes team considers a design clone.

We discussed different scenarios and agreed that it is difficult to decide when a theme is too similar to another theme and if it brings value to the theme directory.

We talked about how we could make it easier to identify clones and how to report them.

No conclusion was reached on how to improve this requirement.

Anish Shrestha asked how much code theme authors can copy from another theme. We discussed how copying code is allowed as long as the license is respected and credits are included.

Manipulating the WordPress.org theme preview

Theme authors brought up that they were unsure of what this requirement refers to. Because violating this requirement can lead to suspension, it is especially important that the information is easy to understand.

The team will update the wording and add examples. An article about using the theme starter content with the preview will also be published.

Language and translation ready

Some theme authors wanted to remove, and others wanted to keep the translation-ready requirement as mandatory. No change to the requirement is planned.

Theme Check

The current version of the Theme Check plugin only works for parent themes.
Some theme authors were not aware about this limitation in Theme Check and were confused about why it shows more errors in the child themes. 

@kafleg made it clear that the theme check plugin only works for parent themes and not for child themes.


Wrapping up

The themes team wants more trust from theme authors regarding guidelines. The themes team expects quality themes from regular authors. But, authors who submit themes on a regular basis also missed the guidelines. 

We want theme authors to regularly attend meetings, contribute to automation tools (theme check and theme review action), and review themes. 

Carolina brought up that the team needs help with finding ways to remove more requirements. Some requirements are listed because there are limitations in WordPress and the theme directory, and can be removed if those limitations are lifted.

At last, thank you all for attending this zoom call and providing your feedback.

#meeting, #meeting-notes, #themes-team

Themes Team Meeting Agenda for August 10, 2021

Channel: #themereview | Time: Tuesday, August 10 2021, 15:00 UTC

The themes team conducts a meeting on the second and fourth Tuesday of the month.
The meeting takes place in the #themereview channel on the WordPress 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/. and you need an account to participate.

Along with the fixed agendas, we have an open floor at the end where you can ask or share anything related to themes.

We encourage all members and anyone interested to attend.

Meeting agenda

  1. Weekly updates
  2. Requirements change
  3. Open floor

Weekly Updates

Current statistics can be found on: https://themes.trac.wordpress.org/ 

Themes TracTrac Trac is the place where contributors create issues for bugs or feature requests much like GitHub.https://core.trac.wordpress.org/. ticket graph: https://themes.trac.wordpress.org/ticketgraph

Check regular weekly updates here.

Also check,


Requirement changes

The theme requirements page has been updated. You can see it here. Now, all the reviews will be done based on these guidelines.

Thank you all who helped directly or indirectly to make it happen.


Open floor

We will discuss everything related to themes. Attendees can ask or share themes-related things.

Please comment in the comment box below if you have anything to bring up during the open floor.

#guidelines, #meeting, #themes-team

Summary of the request for feedback on requirement changes

At the end of July, the team published a request for feedback on proposed requirement changes.
We received feedback on how to improve the presentation and two suggestions for the removal of requirements.

The two requirements suggested for removal were:

  • The Theme URI and Author URI must not be the same.
  • Themes can use any language for text but only use one language.

There were no objections to these additional proposals, and the team will move forward with the requirement changes.

Please allow some time for us to update the relevant handbook pages and the automated theme review tools.

You can read all the replies to the post here:

#themereview, #themes-team