X-post: Updating the Coding standards for modern PHP

X-comment from +make.wordpress.org/core: Comment on Updating the Coding standards for modern PHP

Block-Based Themes Meeting Notes

This post summarizes the latest bi-weekly 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 Theme meeting, held in the #themereview 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/., on Wednesday, 18 March, 2020, 16:00 UTC. These meetings coordinate collaboration in the development evolution of the 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/ project as related to development of Block-Based Themes geared to support Full Site Editing. Moderated by @jffng.

New Gutenberg 7.7 User 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.

It’s lighter and tighter. Feedback and iteration are on-going, but huge kudos to the design team for this evolution.

Block Patterns 

The first patterns are live in Gutenberg 7.7, and can be accessed in their own sidebarSidebar A sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme. panel:

Screen Shot 2020 03 16 at 11 56 35 AM

Lighter DOM 

This should make blocks easier to style moving forward because the markup in the editor mirrors the front-end  PR 19910 and PR 20658

Block Alignments

Supporting block alignment is a challenge for theme authors today. There is a proposal around re-thinking how block alignments are composed PR 20650  making it possible to write a theme that actually supports all the varieties of block alignments.

Full Site Editing UI

Review the following items and add comments:

PR 20478 Explores how users may select and preview templates and template parts.

Issue 20477 Shows how adjusting global styles could affect multiple page templates at a glance. 

Issue 20476 Mockups for seeing which page templates use a single template part

Block Based Themes Glossary

Theme authors need a glossary of terms as they begin creating block-based and Gutenberg enabled themes. A beginning list is here and should be crossed referenced with the existing glossary. An alignment of terms across teams can help in the understanding of theme development. Additionally, defining different types of themes like “Classic Theme”, “Block Enabled Theme” and “Block-Based Theme” would be a good differentiation to make for users when selecting themes from the repo. Currently, the only tag is “Block Editor Styles” which is the description / tag for themes that have support for the block editor. The Next step after building out the glossary will be to add a page to the Theme Handbook.

Open Floor

Dynamic URLs
Creating dynamic URLs within static templates Issues 20966 . It’s suggested that static templates are already being processed 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. in order to combine the template and the template-parts. Local theme data could be parsed via an already established templating mechanism. 

Wanted Features
Part of the many folks hope for Gutenberg is that it becomes easier to create visually stunning, unique websites. For that to become a reality, the editor needs to provide more and better tools for design. For example:

  • finer grain controls on letter-spacing Issue 20796 
  • support for free rotating text and other blocks Issue 20926 

What features and tools would you want to see introduced? Which ones would you want to avoid? Why? There is a label created for this in Gutenberg called Design Tools and the team is encouraged to add their thoughts.

@kjellr mentions prototype tools for

  • Ability to adjust corner radius for buttons/images/etc.
  • Ability to set a site-wide grid, align items to it.
  • It would be cool to be able to draw simple shapes, and place blocks inside them — ovals, rectangles, etc. 

Additional items discussed include:

  • font control. 
  • background colors. 
  • standardization of controls across blocks. 
  • blocks that encourage more free-form layouts would be helpful. I don’t always want to design to the table-like grid that Gutenberg effectively imposes. It makes block-based themes look too similar.
  • a text and media block style where the text overlaps the image https://github.com/WordPress/gutenberg/issues/20193.
  • a “freeform” layout block that let users drag internal blocks within a fine grid would help create overlapping blocks too.
  • blocks inside table cells.
  • Global Styles should be extensibleExtensible This is the ability to add additional functionality to the code. Plugins extend the WordPress core software. by themes and plugins Issue 20449,
    Issue 19611 and PR 19611.

@aristath notes tickets for adding dozens of new options, border-radiuses, line-height, letter-spacing, word-spacing, font-family a bunch of others that don’t make sense for day-to-day use. Gutenberg is steering away from the “Decisions, not Options” philosophy and that is a really, really bad thing. More options is not the same as more freedom. @kjellr points out that doesn’t necessarily mean that the editor shouldn’t support them, but at the very least, they just need to be handled in a way that won’t get in the way of most users.

The next meeting will be 1 April, 2020 at 16:00 UTC.

Block-based Themes Meeting Agenda for March 18

Below is the agenda for this week’s Block-based Themes meeting.

Time: Wednesday, March 18th 2020, 16:00 UTC
Channel: #themereview

Agenda

  • Welcome
  • Status updates for 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 Theme efforts 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/:
    • New Gutenberg 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. Updates
    • Block Patterns are live
    • Lighter Block DOM
    • Full-site Editing UI Updates
  • Discussion topic: what design tools would you like to see in the editor to achieve more expressive designs?
  • General Q&A

If you have any questions you’d like to see raised at this week’s meeting, or any topics or demos you’d like to see in future meetings, please share below.

@itsjusteileen has volunteered to take notes 🙂

X-post: Documentation License

X-comment from +make.wordpress.org/docs: Comment on Documentation License

Meeting notes, Tuesday 10 March 2020

Today we held a meeting with the proposed agenda. The recap of the meeting is below and you can read the meeting transcript in the slack archives (a Slack account is required).

Weekly Updates

  • In the past seven days
    • 246 tickets were opened
    • 251 tickets were closed:
    • 237 tickets were made live.
      • 10 new Themes were made live.
      • 227 Theme updates were made live.
    • 7 more were approved but are waiting to be made live.
    • 14 tickets were not-approved.
    • 0 ticket was closed-newer-version-uploaded.

We thank to all the reviewers, keep doing a great job 🎉

Other updates

We have received two submissions for the experimental themes call, but so far these don’t fall under experimental themes. If you have an interesting theme please comment on that post.

Also, feel free to experiment with the theme experiments and the full site editing feature. Your feedback is really valued.

The welcome box was changed to be more in line with other welcome boxes on the make sites. It now contains more crucial information for first-time contributors. Our team reps Carolina and Ana helped with that.

Announcing the new team representative

A new/old team representative was announced today. It’s @acosmin. He has helped us with maintaining the tracTrac Trac is the place where contributors create issues for bugs or feature requests much like GitHub.https://core.trac.wordpress.org/. queue and tracking down people who are trying to play the system by having multiple accounts.
He knows his way around 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/, and will keep helping us keep the queue in check (and hopefully help make it shorter as well 😄).

Welcome aboard!

Opening up a place for theme author collaborations

Recent outbreak of COVID-19 caused some job problems, especially in Italy. A proposal was that there could exist a place where theme authors could collaborate on certain WordPress related work.

WordPress already has a jobs site so this could be possibly used to add a section where .org developers could offer their services as well as seek for possible jobs.

@franchidesign will create a proposal of what this would look like, why and how it could be implemented. Then the team reps will try to talk with people in charge of the jobs site, to see what we can do about this.

The remedial program

There is an initiative described in detail on the slack channel by @Carike, to introduce a remedial program for theme authors who have issues with understanding the requirements.
The idea is that the reps could enroll theme authors in a module that would help them understand certain requirements, like 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. compatibility, if they see issues in their themes during the review.

For this to be implemented we’d need help from the metaMeta Meta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress. team in setting the site up for these modules, and we’d need to have a way to enroll authors from the admin interface.

The first thing that needs to be done is opening a meta ticket so that we know what can be done.

Open floor

@kjellr called on people to test 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/ PRs and the TwentyTwenty theme experiment aimed at Global Styles:

https://github.com/WordPress/gutenberg/pull/20530
https://github.com/WordPress/theme-experiments/pull/26

They are a great way to see how Global Styles might work in the future.

We encourage people to test these things out. Giving feedback for these issues is very valuable to the developers, and is an important way of contributing.

And finally, a reminder that tomorrow at 17:00 UTC, there will be a triage meeting. We’ll go through the input needed issues for the WPThemeReview coding standards.

#meeting, #meeting-notes, #trt