Create the Lesson on Learn.WordPress.org

The next step is to add the draft lesson 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/. When you are ready to add the Lesson, log in to Learn.WordPress.org, and navigate to the dashboard. If you don’t have permission to do this, pingPing The act of sending a very small amount of data to an end point. Ping is used in computer science to illicit a response from a target server to test it’s connection. Ping is also a term used by Slack users to @ someone or send them a direct message (DM). Users might say something along the lines of “Ping me when the meeting starts.” the @tt-admins group in the #training channel in 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/..

If you are adding the Lesson to a course, Navigate to Sensei -> Courses

Click on the course you are adding the Lesson to, to edit the course landing page. Add a thumbnail image as the course’s featured imageFeatured image A featured image is the main image used on your blog archive page and is pulled when the post or page is shared on social media. The image can be used to display in widget areas on your site or in a summary list of posts., following this guide.

Find the correct module, and add your Lesson to the module. 

If the module does not exist, use the Sensei Add Module or Lesson button to add the module. Make sure to use the same module title from the 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/ issue.

To add a Lesson, click on the last Lesson in the module list, and then click on the Add Lesson option, which appears below it. If this is a new module, you can click on the Add Lesson option. 

Give the Lesson a title, and then click on the Save to edit Lesson button in the 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. toolbar. Once the Lesson is saved, click on the Edit Lesson button in the block toolbar to edit the newly created Lesson. 

If this is a new Lesson, choose the Default Lesson Layout during the Lesson creation wizard.

If you are adding a stand-alone Lesson, navigate to Sensei -> Lessons, and click on the New Lesson button. 

In the Lesson creation wizard, give your Lesson a title, and select the Default Lesson Layout

When creating a new Lesson, give your Lesson the title from the GitHub issue and add the Lesson transcript/script below the video. 

When adding the text content, make sure to break up the text into logical sections using H2 headers. Also, consider adding screenshots or image hotspots to highlight relevant content from the video.

For each Lesson, also:

  • Thumbnails – Upload the thumbnail image you created as the Lesson’s featured image.
  • Levels – Select the experience level on individual Lessons so it appears on the Lesson “cards” that appear on the homepage and archives. (Eventually, this might be pulled out of the parent course, but for now this box has to be checked off manually on each lesson that’s part of a course.)
  • Featured lessons – Check this box if you’d like to Feature a lesson in one of the six slots on the homepage.
  • ExcerptExcerpt An excerpt is the description of the blog post or page that will by default show on the blog archive page, in search results (SERPs), and on social media. With an SEO plugin, the excerpt may also be in that plugin’s metabox. – Write a short manual excerpt for each course and Lesson, maximum 16 words. This will appear on the Lesson “cards” on the homepage and archives. Check to make sure the excerpt is short enough and doesn’t get cut off.

Notice block

If you want to call attention to something within a lesson, use the Notice block, which has a special design to make it stand out.

Screenshot: Notice block

Keep in mind that the Callout block is deprecated, so it should no longer be used. If you’re updating a lesson and noticed a Callout block, copy it into a Notice block instead.

Last updated: