January 2022 Sprint

The Training team is using the Sprint method to determine what we are working on and to determine our timeframe for delivery.

What is a Sprint?

Sprints are fixed length events of one month or less to create consistency. A new Sprint starts immediately after the conclusion of the previous Sprint.


Sprint Goals

Learn Content

We are currently using TrelloTrello Project management system using the concepts of boards and cards to organize tasks in a sane way. This is what the make.wordpress.com/marketing team uses for example: https://trello.com/b/8UGHVBu8/wp-marketing. to manage and keep track of the status of each piece of content on Learn (lesson plans, video workshops and courses). Every piece of content has its own Trello card. The Trello lists represent our Development Workflow, each list contains a card that explains how to use that list.

Types of themes:

  • 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. theme: a theme made for FSE using 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. templates and 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., allowing one to manage all parts of their site with blocks.
  • Universal theme: a theme that works with both 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. and the Site Editor.
  • Hybrid theme: a classic theme that adopts a feature(s) of FSE, like theme.json or the template editor.
  • Classic theme: a theme built with 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. templates, functions.php, and more that does not work with Site Editor.

See FSE Program: Answers from Round Three of Questions for information about the types of themes.

Please keep this in mind when creating and revising content for Learn WordPress.

If you are updating content now before 5.9 ships, please check out 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 #meta created for us, it’s like a pull request inside the WP editor

How we use the RevisionsRevisions The WordPress revisions system stores a record of each saved draft or published update. The revision system allows you to see what changes were made in each revision by dragging a slider (or using the Next/Previous buttons). The display indicates what has changed in each revision. Extended plugin on LearnWP

WordPress 5.9 Revisions Needed:

1. Pick a topic, any topic! Let us know in the comments or drop us a message in the #training Slack channel

2. Get access, if you don’t have it already, to learn.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/. Ask in the #training 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/. channel.

3. Watch the ‘How we use the Revisions Extended Plugin’ video above.

4. Make the revisions on the site using the video as a guide. Set the date to January 25, 2022.

5. Ask the team to review it. Drop us a message in the #training Slack channel.

6. A member of the team will review and publish the changes.

If you get stuck, just drop us a message in Slack.

TopicLesson PlanWorkshop
Anatomy of a Theme
Backing up your siteMove images off GitHubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/ repo
Build a Sitemap for a siteThis should be compared to sitemaps already in coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress.
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/. for classic themesThis should mention classic themes

Choosing a ThemeShould clarify the 4 types of themes
Should clarify the 4 types of themes https://learn.wordpress.org/workshop/how-to-choose-install-a-theme/
Classic Editor Content Editor OverviewSome of the images are not coming across https://learn.wordpress.org/lesson-plan/content-editor-overview/
Rename to Classic Theme Menuhttps://learn.wordpress.org/lesson-plan/managing-menus/
Creating a block patternhttps://learn.wordpress.org/lesson-plan/how-to-create-and-register-a-block-pattern/ @courane01

Reviewed by @azhiyadev
Rename from Regsitering or include both terms https://learn.wordpress.org/workshop/registering-block-patterns/
Customizer TaglineCapitalize the P, describe that customizer isn’t in FSE

Describe how to modify taglines in FSE https://learn.wordpress.org/workshop/customizer-taglines
Glossary Creation WorkshopThis doesn’t follow the lesson plan formats
How to use WordPress Block PatternsUpdate to include Featured patterns, wordpress.org/patterns & https://github.com/WordPress/gutenberg/pull/35773 https://learn.wordpress.org/lesson-plan/how-to-use-wordpress-block-patterns/
Update to include wordpress.org/patterns & https://github.com/WordPress/gutenberg/pull/35773
Intro to common pluginsreview what plugins are common/popular now, remove mentions of Codex
Intro to CSSCSS CSS is an acronym for cascading style sheets. This is what controls the design or look and feel of a site. Review how to do this in block themes
Include how to do this in block themes – are there areas of CSS that exceed FSE to include
Introduction to the CustomizerMention that this is for Classic and Hybrid themes
Mention that this is for Classic and Hybrid themes
Managing WidgetsWidgets without customizer in block based themes
managing widgets in classic themes needed
Setting up a dev environmentNeeds to follow lesson plan and workshop formats
Setting a static front pageStatic Front Page A WordPress website can have a dynamic blog-like front page, or a “static front page” which is used to show customized content. Typically this is the first page you see when you visit a site url, like wordpress.org for example. – duplicated in new content clarify how to do this in FSE https://learn.wordpress.org/lesson-plan/setting-a-static-page-as-your-homepage/
Style Guide Creation WorkshopThis doesn’t follow lesson plan formatting
Template HierarchyRevise for FSE inclusion
The LoopLoop The Loop is PHP code used by WordPress to display posts. Using The Loop, WordPress processes each post to be displayed on the current page, and formats it according to how it matches specified criteria within The Loop tags. Any HTML or PHP code in the Loop will be processed on each post. https://codex.wordpress.org/The_Loop.consider diagraming this in light of the query loop block
Theme TroubleshootingThis will need to be updated to reflect when we have a new lesson plan created about using the styles.
Troubleshooting basicsupdate to include Site Health, plugin and native to core

https://learn.wordpress.org/workshop/wordpress-troubleshooting-basics-part-1/ AND https://learn.wordpress.org/workshop/wordpress-troubleshooting-basics-part-2-troubleshooting-with-logs/
W3 total cachebroken images, follow lesson plan format
Webfontskeep an eye on https://make.wordpress.org/core/2021/09/28/implementing-a-webfonts-api-in-wordpress-core/
What Are Google XML SitemapsI think we should go with Site Kit as that is maintained by Google, and revise the whole article
What Is A ThemeInclude types of themes, see above
What is Contact Form 7adhere to lesson plan format AND import images from GitHub
What Is Wordfence Security
What Is Yoast SEOupdate this to follow lesson plan format
What to include in functions.phpReview for FSE
What you can do with WordPressRemove references to WordPress.comWordPress.com An online implementation of WordPress code that lets you immediately access a new WordPress environment to publish your content. WordPress.com is a private company owned by Automattic that hosts the largest multisite in the world. This is arguably the best place to start blogging if you have never touched WordPress before. https://wordpress.com/
WidgetWidget A WordPress Widget is a small block that performs a specific function. You can add these widgets in sidebars also known as widget-ready areas on your web page. WordPress widgets were originally created to provide a simple and easy-to-use way of giving design and structure control of the WordPress theme to the user. AreasThis needs to be updated for also including block based themes
List of lesson plans and workshops that need to be revised for 5.9

WordPress 5.9 New Content Needed:

1. Pick a topic, any topic! Let us know in the comments or drop us a message in the #training Slack channel

2. Get access, if you don’t have it already, to learn.wordpress.org. Ask in the #training Slack channel.

If you need help creating content, we’ve got some great workshops videos ready for you to learn how to do this:

* Lesson plan about lesson plans and workshops about lesson plans

* Workshop about workshops

If you get stuck, just drop us a message in Slack.

TopicLesson PlanWorkshop
Block Navigation MenuNavigation Menu A theme feature introduced with Version 3.0. WordPress includes an easy to use mechanism for giving various control options to get users to click from one place to another on a site.https://learn.wordpress.org/lesson-plan/how-to-create-a-menu-with-the-navigation-block/

Reviewed by @jeffr0

Block Theme Comment Block
Block Theme Template Hierarchy
Build a site using a block theme (Twenty Twenty Two)
Child theme for block themes@arasae
How to set site icons and logo (without Customizer)
Difference between reusable blocks, block pattern, templates, template partshttps://learn.wordpress.org/lesson-plan/difference-between-reusable-blocks-block-pattern-templates-template-parts/ @webtechpooja

Reviewed by @arasae @rkohilakis @west7 @courane01 @azhiyadev
Gallery Blockhttps://learn.wordpress.org/wp-admin/post.php?post=12915&action=edit
Managing widgets in block themes needed
Searching Openverse
Searching and submitting to the photo directory
Creating a front page in block themes@kemmy99
Styling your site with global styleshttps://learn.wordpress.org/lesson-plan/how-to-style-your-site-with-global-styles/
Reviewed by @aurooba and @lesleysim
Submitting a block pattern to the directory
Submitting photos to the photo directory
Template Tourrevise
Using list viewhttps://learn.wordpress.org/?p=11915&post_type=lesson-plan&preview_id=11915&preview=true

Reviewed by @aurooba and @lesleysim
Using theme.json with classic themes
Using widgets in block themes
Using WordPress in other languagesNeeds to reflect the language switcher update https://make.wordpress.org/core/2021/12/20/introducing-new-language-switcher-on-the-login-screen-in-wp-5-9/

What is flex layout and how to configure with block themes
Query loop
Featured patterns
Dimensions in featured images
How to edit a template parthttps://learn.wordpress.org/wp-admin/post.php?post=12640&action=edit
How to create a template parthttps://learn.wordpress.org/wp-admin/post.php?post=12636&action=edit
How to use the template part focus modehttps://learn.wordpress.org/wp-admin/post.php?post=12666&action=edit
How to Build Low-Code Block Patternshttps://learn.wordpress.org/lesson-plan/how-to-build-low-code-block-patterns/

Reviewed by @azhiyadev
List of lesson plans and workshops that need to be created for 5.9

Courses Needed


  1. Contributor courses


  1. User Facing Full Site Editing (FSE) – Part 1 @rkohilakis
  2. User FSE – Part 2 @west7

Learn Functionality

These are our high priority items. If you are interested in helping out, please let us know in the #meta-learn Slack channel.

Visit GitHub for a complete list of open issues.

  1. Style a print-friendly style sheet (transcripts and lesson plans)
  2. Integrate speaker feedback tool
  3. Google Slides block for Lesson Plans The team is carrying out an audit of the Slides Plugin to ascertain the level of maintenance required and amount of work needed to fix the bug @binarygary @alexstine @danilong
  4. Updates to handle course, lesson & quiz flows
  5. Automatically recognize contributions on Profiles
  6. Fix quiz button styling to match other buttons
  7. Learner recognition on WordPress.org profile
  8. Use consistent templates and styles across post types
  9. Styling for the Details Summary block
  10. Modify workshop archive ordering

Training Team

Administrative tasks for the team, some of these are ongoing.

  1. Publish Learn roadmap
    1. Learn content roadmap Trello board
    2. Learn functionality Trello board
    3. Learn Team members Trello board
  2. Fix 404 errors on Learn
  3. HelpScout rotation
  4. Meeting notetakers rotation

Upcoming Meetings

You are welcome to join the team at any time! If you are new to the Training Team, please introduce yourself in the #training channel before the meeting (or anytime!) and feel free to join us in the meeting and participate as you are able.

Training Team Mission

The WordPress training team helps people learn to use, extend, and contribute to WordPress through synchronous and asynchronous learning as well as downloadable lesson plans for instructors to use in live environments, via learn.wordpress.org.

Getting Involved

Everyone is welcome and encouraged to join in, comment on posts, and participate in meetings and on projects. Here’s what you need to know to get started.

  1. Getting Involved:- https://make.wordpress.org/training/handbook/getting-started/
  2. About The Team:- https://make.wordpress.org/training/handbook/about/ 
  3. Our Team Blog:- https://make.wordpress.org/training/ 
  4. Our Content Roadmap:- https://trello.com/b/BsfzszRM/wordpress-training-team-lesson-plan-development 
  5. What We Are Currently Working On This Month:- https://make.wordpress.org/training/category/sprint/
  6. Learn WordPress Roadmap:- https://trello.com/b/rK1tztAA/learn-wordpress 
  7. Learn WordPress Issues Log:- https://github.com/WordPress/learn
  8. Our Lesson Plans:- https://learn.wordpress.org/lesson-plans/
  9. Our YouTube Channel:- https://www.youtube.com/channel/UCnxqNA0WORZXWurEP6cNV6w 
  10. Learn Website:- https://learn.wordpress.org/

#learn-wordpress, #training-team