¿Cómo limitar el número de entradas que obtiene WP_Query?

Ok, supongamos que tienes un tipo de entrada llamado 'blog_posts' y quieres obtener 5 entradas de ese tipo. Esto es lo que necesitas hacer

$args = array(
        'post_type' => 'blog_posts',
        'posts_per_page' => '5',
);


$query = new WP_Query($args);

La consulta anterior devolverá 5 entradas del tipo 'blog_posts'. Si no es un tipo de entrada personalizado, entonces simplemente reemplaza así 'post_type' => 'posts', si quieres obtener todas las entradas entonces reemplaza así 'posts_per_page' => '-1',, para más detalles consulta WP Query

Sé que @user1750063 ha mencionado el código pero prueba esto

$args = array (
    'post_type'              => 'custom_post', // tipo de publicación personalizada
    'nopaging'               => false,         // paginación activada
    'posts_per_page'         => '5',           // 5 publicaciones por página
    'order'                  => 'DESC',        // orden descendente
    'orderby'                => 'ID',          // ordenar por ID
);

$query = new WP_Query( $args );

if ( $query->have_posts() ) {
    while ( $query->have_posts() ) {
        $query->the_post();
        // mostrar contenido
    }
} else {
    // mostrar cuando no se encuentran publicaciones
}

wp_reset_postdata();     // Restaurar los datos originales de la publicación

Después de la conversación con @Pieter Goosen en los comentarios de la pregunta, creo que puedo responder la pregunta y explicar mi error.

La clave es que found_posts me estaba confundiendo. Pensé que ese número eran los posts recuperados pero no es así. Es el número de posts que coinciden con el criterio. Es como si WP_Query tuviera 2 partes: una para encontrar (todos) los posts, y otra para obtener el contenido, cuando verifica los parámetros de pagination. Así que tenemos la propiedad $post_count que es el número de posts obtenidos (el Codex dice El número de posts que se están mostrando), que por supuesto es igual al número en el parámetro posts_per_page, y el número de elementos en la propiedad del array $posts.

Así que WP_Query no está haciendo ningún trabajo innecesario, como yo pensaba ^^

¡Espero que esto ayude a otros!