Documentation-based practice example; check the controls in your installed Oxygen version.
What it does and when to use it
Repeat a reusable item design for a collection of WordPress posts. This example focuses on one achievable outcome rather than listing every possible setting.
Before you start
Start with a test page and the data or assets described in the example. The values below are starting points, not universal design defaults.
Worked example: A six-item latest-guides grid
Scenario: A six-item latest-guides grid. The goal is a useful result on a real project, not a claim that this scenario was a completed client project.
- Create one Component with dynamic post title, excerpt and permalink.
- Select that Component in Post Loop Builder and query the intended category with six posts ordered by date.
- Use a grid that reduces to one column on a narrow screen; add pagination when readers need older entries.
Example text-query arguments
post_type=post&posts_per_page=6&category_name=guides&orderby=date&order=DESCUse these arguments in the supported text-query mode, with your actual category slug. This selects published posts in a normal public query; preview the resulting set before styling it.
Expected result
You should have a six-item latest-guides grid. Verify the result on the frontend using the same content or object described in the steps. A correct builder preview alone does not establish that links, data or interactions work for visitors.
Troubleshooting
If every card links to the same post, replace the hardcoded URL in the Component with the current loop item's permalink. On an archive, preserve its intended main-query context.
Checks before publishing
Use the main query on archive templates. Enable pagination for larger lists. The documented native filter bar and pagination cannot be enabled together.
- Compare desktop and narrow-screen layouts using actual content.
- Follow every destination and operate interactive controls with a keyboard where applicable.
- Check an empty or unavailable-data state when the element depends on a provider.
Official reference and version notes
Official Post Loop Builder reference provides the current provider information. This is independent, AI-assisted documentation on Benjamin Olsen’s website; examples are clearly identified as practice recipes.
The native references were checked against the site’s Oxygen 6.2.0-beta.9 installation and public documentation. Individual recipes should still be validated in your project.