Learn icon indicating copy to clipboard operation
Learn copied to clipboard

How to use the Query Loop Block - Lesson Plan

Open courtneyr-dev opened this issue 2 years ago • 10 comments

https://wordpress.org/support/article/query-loop-block/

Topic Description

Write a description of the topic here.

Related Resources

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

Guidelines

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

Development Checklist:

  • [ ] 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 example lesson walk-through
  • [ ] Draft lesson plan
  • [ ] Copy edit
  • [ ] Style guide review
  • [ ] Instructional Review
  • [ ] Final review
  • [ ] Publish
  • [ ] Announce to the Training team
  • [ ] Announce to lesson plan creator
  • [ ] Announce to marketing
  • [ ] Gather feedback from lesson plan users about the quality

Repo Structure and Lesson Plan Template

Please remove all blockquote comments such as this before publishing.

Description

A short paragraph explaining what is covered in the lesson plan. This should be text that can be copied and used in a meetup or workshop description.

Objectives

After completing this lesson, participants will be able to:

  • Objective 1
  • Objective 2

It’s required that you include a bulleted list of objective(s) for each lesson plan. Objectives should be worded as actions that the participant can do once they’ve finished. See Bloom's Taxonomy of Action Verbs (PDF) as a reference. Avoid using words like "know," "understand," "be introduced to," etc. There should be one assement item for each objective (see below).

Target Audience

Who is this lesson intended for? What interests/skills would they bring? Put an "x" in the brackets for all that apply.

  • [ ] Users / Content Writers
  • [ ] Designers
  • [ ] Developers
  • [ ] Speakers
  • [ ] Organizers
  • [ ] Kids

Experience Level

How much experience would a participant need to get the most from this lesson? Put an "x" in the brackets for all that apply.

  • [ ] Beginner
  • [ ] Intermediate
  • [ ] Advanced

Type of Instruction

Which strategies will be used for this lesson plan? Put an "x" in the brackets for all that apply.

  • [ ] Demonstration
  • [ ] Discussion
  • [ ] Exercises
  • [ ] Feedback
  • [ ] Lecture (Presentation)
  • [ ] Slides
  • [ ] Show & Tell
  • [ ] Tutorial

Time Estimate (Duration)

How long will it take to present this lesson? Put an "x" in the brackets for the one that applies.

  • [ ] 1 hour or less
  • [ ] 2-4 hours (half-day)
  • [ ] 5-8 hours (full-day)
  • [ ] 2 days
  • [ ] 3 days or more

Prerequisite Skills

Participants will get the most from this lesson if they have familiarity with:

  • Skill 1
  • Skill 2

For example:

  • Experience with HTML and CSS
  • Completed the Basic WordPress Concepts lesson

Readiness Questions

  • Question 1
  • Question 2

A list of questions for participants to see if they have the background and skills necessary to learn and understand the lesson.

For example:

  • Do you want to makes changes to your theme yourself?
  • Do you know how to write CSS?

Slides

Change the /repo-name/ in the link to match the URL name of this repo.

  • Slides (files included in this repo)

Materials Needed

  • Item 1
  • Item 2

A list of files, resources, equipment, or other materials the presenter will need for the lesson.

For example:

  • A local install of WordPress
  • The files for the TwentySixteen theme

Notes for the Presenter

  • Note 1
  • Note 2

A list of any handy tips or other information for the presenter.

For example:

  • Participants may need to download the TwentySixteen theme before beginning
  • What to do if there’s no projector or internet available
  • What to do if a participant doesn’t have the necessary set up
  • How to handle different opinions about the topic

Lesson Outline

  • First do this
  • Then move on to this
  • Finish with this

The plan for the lesson. Outline form works well.

For example:

  • Talk about what a theme is
  • Demonstrate how to install and activate a theme
  • Practice exercises to have participants find and install a theme on their own site

Exercises

Exercise name

Short description of what the exercise does and what skills or knowledge it reinforces.

  • Short point or step of the exercise
  • And another one

These are short or specific activities that help participants practice certain components of the lesson. They should not be fully scripted exercises, but rather something that participants could do on their own. For example, you can create an exercise based on one step of the Example Lesson.

Assessment

There should be one assement item (or more) for each objective listed above. Each assessment item should support an objective; there should be none that don't.

Write out the question.

  1. Option
  2. Option
  3. Option
  4. Option

Answer: 3. Correct answer

A few questions to ask participants to evaluate their retention of the material presented. They should be a measure of whether the objectives were reached. Consider having a question for each objective.

Additional Resources

  • Resource 1
  • Resource 2

An optional section which can contain a list of resources that the presenter can use to get more information on the topic.

For example:

  • Link to information on the Codex
  • Theme Review Team's Handbook

Example Lesson

An example of how the lesson plan can be implemented. Written in script form as one possible way an presenter might use this lesson plan at an event, with screenshots and instructions if necessary.

Section Heading for Example Lesson

You will likely need to break the Example Lesson down into multiple sections.

Lesson Wrap Up

Follow with the Exercises and Assessment outlined above.

courtneyr-dev avatar Mar 02 '22 17:03 courtneyr-dev

Hi, @westnz are you also working on the lesson plan?

azhiya avatar Mar 30 '22 19:03 azhiya

Hey @azhiya! Sarah is working on this and has shared the Google draft doc with the Training team.

westnz avatar Mar 31 '22 06:03 westnz

@wparase I'm still unable to assign you to a GitHub issue.

azhiya avatar Mar 31 '22 10:03 azhiya

Here is the link to Sarah's draft copy of the lesson plan

westnz avatar Mar 31 '22 12:03 westnz

Please review for https://github.com/WordPress/Documentation-Issue-Tracker/issues/283

azhiya avatar Apr 20 '22 10:04 azhiya

Please see https://github.com/WordPress/gutenberg/pull/38997

courtneyr-dev avatar May 22 '22 01:05 courtneyr-dev

https://github.com/WordPress/gutenberg/pull/38063

courtneyr-dev avatar May 22 '22 18:05 courtneyr-dev

https://github.com/WordPress/gutenberg/pull/38024

courtneyr-dev avatar May 22 '22 18:05 courtneyr-dev

Paused; the majority of this lesson plan is done in Google Docs, this just needs to be moved to Learn. If someone is interested in moving this across the finish line, please ping @arasae in the #training channel. Otherwise, I will get to this as my priorities allow.

wparasae avatar Aug 02 '22 16:08 wparasae

That's great @wparasae. If you've got no takers, I can work on moving it across.

azhiya avatar Aug 05 '22 09:08 azhiya

patterns with the Query Loop, which reflects the intended post type, and the tools panel has been adopted to better consolidate the number of filters shown by default. Finally, folks who extend the Query Loop can also use an allowedControls property to determine what filters appear in variations to refine the UI based on their unique variation.

Visuals: parent filter video, tools panel video.

Code examples: video exploring registering a variation and including specific patterns with JS for registering a Query Loop variation and PHP for registering a pattern can be used with the variation.

Adoption approach: opt-in.

Key Make Posts/GitHub/Trac Issue(s):

Pass extra query args in REST API call for an accurate preview for extenders. Add parents filter for querying pages. Add a filter to build_query_vars_from_query_block. UX: Add filters with ToolsPanel to better organize the experience of working with filter options. UX: Honor intended post type when previewing patterns and when replacing them with patterns for a more intuitive and predictable experience. Add allowedControls in block variations for better extensibility, which allows extenders to determine which controls show up for variations. Draft of documentation for extending the query loop through variations.

courtneyr-dev avatar Oct 05 '22 10:10 courtneyr-dev

Due to a transition, I have removed myself from this issue to allow someone else to work on this. :) If I find time to work on this in the next two weeks, I will comment below and happily reassign myself to this issue.

wparasae avatar Aug 15 '23 16:08 wparasae

WP 6.4 Visuals: YouTube video explaining improved pagination feature. Adoption approach: Key Make Posts/GitHub/Trac Issue(s): Query block: Client-side pagination (53812), make mid size parameter settable for Query Pagination block. (#51216), Query block: Start prefetching on first click to next/previous. (54781)

courtneyr-dev avatar Oct 11 '23 19:10 courtneyr-dev