get_page_children() │ WP 1.5.1

Збирає дочірні сторінки із переданого масиву сторінок. Обробляються всі рівні вкладеності.

Функція працює як фільтр і робить ніяких запитів до БД. Фільтрує масив з другого параметра: знаходить у ньому всі дочірні сторінки до вказаного $page_id . При фільтрації враховуються всі рівні вкладеності.

Хуків немає.

Повертає

Массив. Масив об’єктів WP_Post.

Використання

get_page_children ($ page_id, $ pages);

$page_id (число) (обов’язковий): ID сторінки, дочірні до якої потрібно отримати.
$pages (масив) (обов’язковий): Список об’єктів постів, за якими проходитиме пошук дочірніх сторінок.

Приклади

#1 Приклад використання функції:

// Отримуємо всі сторінки, якими буде проходити пошук.
$all_pages = (new WP_Query() )->query( [
	'post_type' => 'page',
	'posts_per_page' => -1
]);

// сторінка, дочірні якої потрібно отримати
$ about_id = 7;

// залишимо лише дочірні до Portfolio
$about_childrens = get_page_children( $about_id, $all_pages );

// Спростимо висновок
foreach( $about_childrens as & $page ){
	unset(
		$page->post_content,
		$page->post_date_gmt,
		$page->post_password,
		$page->post_modified_gmt,
		$page->post_content_filtered,
		$page->post_mime_type
	);
}

// результат
print_r($about_childrens);

Отримаємо:

Array
(
	[0] => WP_Post Object
		(
			[ID] => 10124
			[post_author] => 12
			[post_date] => 2018-05-19 08:11:19
			[post_title] => Політика конфіденційності
			[post_excerpt] =>
			[post_status] => publish
			[comment_status] => closed
			[ping_status] => closed
			[post_name] => privacy-policy
			[to_ping] =>
			[pinged] =>
			[post_modified] => 2018-09-12 05:28:35
			[post_parent] => 7
			[guid] => /about/privacy-policy
			[menu_order] => 3
			[post_type] => page
			[comment_count] => 0
			[filter] => raw
		)

	[1] => WP_Post Object
		(
			[ID] => 9976
			[post_author] => 12
			[post_date] => 2018-05-05 01:01:09
			[post_title] => Активні користувачі
			[post_excerpt] =>
			[post_status] => publish
			[comment_status] => closed
			[ping_status] => open
			[post_name] => best-users
			[to_ping] =>
			[pinged] =>
			[post_modified] => 2018-05-05 02:04:25
			[post_parent] => 7
			[guid] => /about/best-users
			[menu_order] => 2
			[post_type] => page
			[comment_count] => 0
			[filter] => raw
		)

	[2] => WP_Post Object
		(
			[ID] => 3591
			[post_author] => 12
			[post_date] => 2013-10-30 19:26:40
			[post_title] => Про передрук
			[post_excerpt] =>
			[post_status] => publish
			[comment_status] => closed
			[ping_status] => open
			[post_name] => o-perepechatke
			[to_ping] =>
			[pinged] =>
			[post_modified] => 2018-05-05 02:32:15
			[post_parent] => 7
			[guid] => /about/o-perepechatke
			[menu_order] => 4
			[post_type] => page
			[comment_count] => 0
			[filter] => raw
		)

	[3] => WP_Post Object
		(
			[ID] => 25
			[post_author] => 12
			[post_date] => 2010-04-05 04:24:04
			[post_title] => Контакти
			[post_excerpt] =>
			[post_status] => publish
			[comment_status] => closed
			[ping_status] => open
			[post_name] => contacts
			[to_ping] =>
			[pinged] =>
			[post_modified] => 2018-05-05 02:34:09
			[post_parent] => 7
			[guid] => /about/contacts
			[menu_order] => 1
			[post_type] => page
			[comment_count] => 0
			[filter] => raw
		)

)

список змін

З версії 1.5.1

Введено.

Код `get_page_children() get page children` ^{WP 6.0.2}

wp-includes/post.php

function get_page_children( $page_id, $pages ) {
	// Build a hash of ID -> children.
	$children = array();
	foreach ((array) $pages as $page) {
		$children[ (int) $page->post_parent ][] = $page;
	}

	$page_list = array();

	// Start the search by looking at immediate children.
	if ( isset( $children[ $page_id ] ) ) {
		// Будь-який start at end of stack in order to preserve original `$pages` order.
		$to_look = array_reverse($children[$page_id]);

		while ($ to_look) {
			$ p = array_pop ($ to_look);
			$page_list[] = $p;
			if ( isset( $children[ $p->ID ] ) ) {
				foreach ( array_reverse( $children[ $p->ID ] ) as $child ) {
					// Append to the $to_look stack to descend the tree.
					$to_look[] = $child;
				}
			}
		}
	}

	return $page_list;
}

get_page_children() │ WP 1.5.1

Повертає

Використання

Приклади

#1 Приклад використання функції:

список змін

Код get_page_children() get page children WP 6.0.2

Зв’язані функції

Сторінки

Залишити відповідь Скасувати коментар

Код `get_page_children() get page children` ^{WP 6.0.2}