loop – How does WP generate the default $query in WP_Query based on the URL?


It happens in 3 main stages:

  1. The URL is parsed by WP::parse_request() this is done by matching the URL to WordPress’s rewrite rules. You can see those rules in the rewrite_rules option in the wp_options table, or use a plugin
    like Rewrite Rules Inspector to browse them. This results in parameters for WP_Query.
  2. The parsed parameters are passed as arguments to the ‘main’ global instance of WP_Query, which queries the database for posts. The Loop is for looping through the posts returned by this query.
  3. Based on the arguments passed to the WP_Query instance various properties such as is_single or is_archive are set on the query object by WP_Query::parse_query(), and based on those properties wp-includes/template-loader.php will load a template file from your theme. How templates are chose, i.e. the template hierarchy, is visualised here.

For most day-to-day development only step 3 is really relevant, and it should be fairly obvious from the URL what posts are going to be loaded:

  • /my-page The page with the my-page slug.
  • /category/my-category Posts in the my-category category.
  • /2020/03/01 Posts from March 1st 2020.
  • ?s=my+search+term Posts matching the search query “my search term”.

You can usually infer all these URLs based on what the View links for various types of content in the admin area point to.

When you register custom post types and taxonomies there will be a rewrite argument that lets you define what the URL to an archive of those posts will be. Refer to the documentation for how those work.

The important thing to note is that by default, apart from the 404 template, all URLs created by WordPress will load either a single post, or a list of posts.

GaslightToken 5 months 2022-07-13T12:23:35-05:00 0 Answers 0 views 0

Leave an answer