WordPress.org

Plugin API/Filter Reference/found posts

Description

This filter hook allows developers to adjust the number of posts that WordPress's WP_Query class reports finding when it runs a query.

This hook is especially useful when developing custom pagination. For instance, if you are declaring a custom offset value in your queries, WordPress will NOT deduct the offset from the the $wp_query->found_posts parameter (so if you have 45 usable posts after an offset of 10, WordPress will still give found_posts a value of 55).

Related

• Class: WP_Query - Detailed overview of the WP_Query class
• Class: $wpdb - Overview of using the $wpdb object
• Function: get_query_var()
• Function: query_posts() - Make additional custom queries
• Function: get_posts() - A specialized function that returns an array of posts
• Function: get_pages() - A specialized function that returns an array of pages
• Function: have posts() - A conditional that determines if the query returned any posts
• Function: the_post() - Used to automatically set up the loop after a query
• Function: rewind_posts() - Resets the current loop
• Function: setup_postdata() - Setup query data for individual results within a loop
• Function: wp_reset_postdata() - Restores the previous query (usually after a loop-within-a-loop)
• Function: wp_reset_query()
• Function: is_main_query() - Ensures the query being changed is only the main query
• Action Hook: pre_get_posts - Modify WordPress queries before they are executed
• Filter Hook: found_posts - Modify the WP_Query object's found_posts value
• Tutorial: Displaying Posts Using a Custom Select Query
• Tutorial: Making Advanced Taxonomy Queries
• Tutorial: Making Custom Queries using Offset and Pagination

• Home Page
• WordPress Lessons
• Getting Started
• Working with WordPress
• Design and Layout
• Advanced Topics
• Troubleshooting
• Developer Docs
• About WordPress

Codex Resources

• Community portal
• Current events
• Recent changes
• Random page
• Help