Lesson: WP-CLI Intro

I'm raising this issue to create a WP-CLI intro video tutorial to complement the course as discussed in #632

Topic Description

An introduction to WP-CLI - the WordPress command line tool

See the outline document

Objectives

• Gain an initial understanding of what WP-CLI is and why it is powerful and worth learning more about.
• Equally: understand if WP-CLI is NOT something that the trainee would want to learn more about.
• Know how to install WP-CLI (on various different platforms - bear in mind some tools like Local and DevKinsta come with WP-* CLI and many hosting environments have it pre-installed too).
• Understand some of the most useful, time-saving features of WP-CLI.
• Know at least three commands that can be used immediately.
• Understand that you can develop your own CLI commands (but not HOW to develop them other than by referencing the handbook).
• Understand how to get help from WP-CLI, both on the command line and in the documentation.
• Know where to go to find out more.

Things specifically NOT to include (with rationale):

• That you can contribute to the WP-CLI project and how to do so (because a beginner will not have the skills or knowledge required).
• Security (people may have questions about this but it should remain out of scope).

Pre-requisites

• I can use the command line/terminal/shell on my computer or server (or am willing to learn!)
• I either:
  • Have WordPress installed locally on my own computer OR
  • Have WordPress on a host that allows me to SSH to the server.
  • I understand some basic WordPress administration concepts such as posts, users, and plugins.

Related Resources

Links to related content on Learn, HelpHub, DevHub, GitHub Gutenberg Issues, DevNotes, etc.

• https://make.wordpress.org/cli/handbook/
• https://wp-cli.org/
• https://wordpress.tv/?s=wp-cli

Guidelines

Review the [team guidelines] (https://make.wordpress.org/training/handbook/guidelines/)

Tutorial Development Checklist

• Vetted by instructional designers for content idea
• Provide feedback of the idea
• Gather links to Support and Developer Docs
• Consider any MarComms (marketing communications) resources and link to those
• Review any related material on Learn
• Define several SEO keywords to use in the article and where they should be prominently used
• Description and Objectives finalized
• Create an outline of the workshop
• Tutorial submitted to the team for Q/A review https://blog.wordpress.tv/submission-guidelines/ & https://make.wordpress.org/training/2021/08/17/proposal-brand-guidelines-for-learn-wordpress-content/
• Tutorial submitted to WPTV https://wordpress.tv/submit-video/
• Tutorial published on WPTV
• Tutorial is captioned https://make.wordpress.org/training/handbook/workshops/workshop-subtitles-and-transcripts/
• Tutorial created on Learn.WordPress.org
• Tutorial post is reviewed for grammar, spelling, etc.
• Tutorial published on Learn.WordPress.org
• Tutorial announced to training team
• Tutorial announced to creator
• Tutorial announced to Marketing Team for promotion
• Gather feedback from workshop viewers/participants

Start with the linked outline document, then review the WP-CLI handbook and the tutorial development checklist. Define the lesson around the stated objectives and exclusions, then complete review, captioning, and publication on WordPress.tv and Learn.WordPress.org.