Яка різниця між posts_per_page та numberposts у WordPress

Цей пост написаний як для себе, так і для тих, хто колись замислювався — у чому ж різниця між параметром “numberposts” та “posts_per_page”, які передаються у функцію get_posts як аргументи.
Сам я іноді згадую, у чому відмінність, і в різних місцях використовую то один, то інший варіант.

Але в чому ж, власне, різниця? Для цього подивимось у код функції WordPress “get_posts” (на щастя, вона досить коротка):

function get_posts( $args = null ) {
	$defaults = array(
		'numberposts' => 5,
		'category' => 0, 'orderby' => 'date',
		'order' => 'DESC', 'include' => array(),
		'exclude' => array(), 'meta_key' => '',
		'meta_value' =>'', 'post_type' => 'post',
		'suppress_filters' => true
	);
	$r = wp_parse_args( $args, $defaults );
	if ( empty( $r['post_status'] ) )
		$r['post_status'] = ( 'attachment' == $r['post_type'] ) ? 'inherit' : 'publish';
	if ( ! empty($r['numberposts']) && empty($r['posts_per_page']) )
		$r['posts_per_page'] = $r['numberposts'];
	if ( ! empty($r['category']) )
		$r['cat'] = $r['category'];
	if ( ! empty($r['include']) ) {
		$incposts = wp_parse_id_list( $r['include'] );
		$r['posts_per_page'] = count($incposts);  // only the number of posts included
		$r['post__in'] = $incposts;
	} elseif ( ! empty($r['exclude']) )
		$r['post__not_in'] = wp_parse_id_list( $r['exclude'] );

	$r['ignore_sticky_posts'] = true;
	$r['no_found_rows'] = true;

	$get_posts = new WP_Query;
	return $get_posts->query($r);
}

Як бачимо, ключ “numberposts” — це лише обгортка над “posts_per_page”:

if ( ! empty($r['numberposts']) && empty($r['posts_per_page']) )
	$r['posts_per_page'] = $r['numberposts'];

Але давайте ще звернемося до об'єкта “WP_Query” і пошукаємо в ньому залежність від параметра “numberposts”.
Зайшли? Подивились? Правильно — згадок про numberposts немає. Але використовується posts_per_page.

З усього вищесказаного можна зробити висновок, що “numberposts” був введений лише для зручності. А використовувати “numberposts” чи “posts_per_page” — це справа особистих вподобань.