Submitting your theme to WordPress.org

[jonathanbossenger]

Details

• Content type (Online Workshop, Lesson, Course, Tutorial, or Lesson Plan): Lesson
• Content title: Submitting your theme to WordPress.org
• Topic description: An overview of the process of creating a theme archive and uploading it to WordPress.org.
• Audience (User, Developer, Designer, Contributor, etc.): Developer
• Experience Level (Beginner, Intermediate, Advanced, Any):

Learning Objectives

• Describe the process required to submit a theme to the WordPress.org theme directory

Related Resources and Other Notes

Automation Code

//lesson

[github-actions]

Lesson Development Checklist

• Gather any relevant links to Support, Docs, or related material
• Description and Objectives finalized
• Lesson created and announced to the team for review
• Lesson reviewed
• Lesson video submitted and published to WPTV
• Lesson created on Learn.WordPress.org
• Lesson video published to YouTube
• Lesson on Learn.WordPress.org updated with YouTube video
• Lesson published to Learn.WordPress.org

[jonathanbossenger]

Script: https://github.com/jonathanbossenger/wp-content/blob/main/theme-developer-learning-pathway/08-publishing-themes/04-submitting-your-theme.md

[jonathanbossenger]

Video for review: https://drive.google.com/file/d/1g2gxG85m3mZrm-bXxHBbhaGkS0HLF9Gq/view?usp=sharing

[ironnysh]

Hi @jonathanbossenger, the linked video is for #2509 (updating your theme).

[jonathanbossenger]

Ah, sorry about that @ironnysh, correct video is uploaded (new link added above).

[ironnysh]

Tutorial/Lessons Review Checklist

• Learning outcomes/objectives are clear.
• Technical concepts introduced in the content are accurate.
• The speed of demonstrations are easy to follow.
• The narration audio matches what is shown visually.
• Spelling and grammar are correct.
• Sound quality is consistent throughout the video.
• Brand Usage Guidelines and Promotional Guidelines are being followed.
• Media assets are all in the public domain (CC0).

Love the hands-on walkthrough of the process—very helpful, @jonathanbossenger.

Maybe it's just me, but in the section titled A note on the theme name, there's a slightly confusing reference to two “theme directories”: one is the local folder and the other is the official WordPress Theme Directory :-)
How about calling the local “folder” instead of “directory”?

At 1:47, the slide shows the soon-to-be-old design of the submission page. It’s probably safe to replace it with the upcoming design that’s supposed to launch soon: https://wordpress.org/themes/upload/?new-theme=1.

[jonathanbossenger]

Maybe it's just me, but in the section titled A note on the theme name, there's a slightly confusing reference to two “theme directories”: one is the local folder, and the other is the official WordPress Theme Directory :-)
How about calling the local “folder” instead of “directory”?

Soooooooo...

On any operating system a directory and a folder are two different things. However, because graphical user interfaces have historically used a folder icon to represent directories visually, we've become used to calling them folders. However, they are all actually directories, something I am reminded of every time I use the cd (change directory) command in the terminal. I tend to be strict about calling them that, even though I sometimes revert to calling them folders out of habit.

(Yes, I know, I'm being overly pedantic about this; insert appropriate meme here.)

I get your point, however, and will try to think of a better way to relay this information.

[ironnysh]

On any operating system a directory and a folder are two different things.

Ooh, TIL!

I'm being overly pedantic about this

Not at all. I am ;-)

[jonathanbossenger]

I've decided to revert to calling it a Folder for this lesson, just because it gets too confusing. Also, both VS Code and all operating systems I currently use use the word "Folder" in the window manager UI.

[jonathanbossenger]

Updated video

04.Submitting.your.theme.to.WordPress.org.mp4

[jonathanbossenger]

https://wordpress.tv/2024/07/17/submitting-your-theme-to-wordpress-org/

[jonathanbossenger]

https://youtu.be/vSNFU1usCOw

[jonathanbossenger]

https://learn.wordpress.org/lesson/submitting-your-theme-to-wordpress-org/

[jonathanbossenger]

//publish