wordpress / latest / hooks / post_limits.html

apply_filters_ref_array( 'post_limits', string $limits, WP_Query $query )

Filters the LIMIT clause of the query.

Parameters

$limits string
The LIMIT clause of the query.
$query WP_Query
The WP_Query instance (passed by reference).

More Information

  • This filter applies to the LIMIT clause of the query before the query is sent to the database, allowing you to define a new query LIMIT.
  • You can return null to remove the LIMIT clause from the query, allowing you to return all results. However, this will set $wp_query->found_posts to 0.
  • On some server environments, the LIMIT will be applied to all queries on the page. This results in menu items and widgets also being limited to the defined number. To only limit the number of posts on a page use the action hook pre_get_posts.

Source

File: wp-includes/class-wp-query.php. View all references

$limits = apply_filters_ref_array( 'post_limits', array( $limits, &$this ) );

Used By

Used By Description

Changelog

Version Description
2.1.0 Introduced.

© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/hooks/post_limits