wp_list_pages() │ WP 1.5.0

Майте на увазі, що теги ul також будуть видалені і їх потрібно вказувати окремо:

<ul>
	<?php wp_list_pages('title_li='); ?>
</ul>

Змінимо заголовок на “Поети”, обернемо його в HTML тег <h2> і виведемо у списку тільки постійні сторінки з ID 9, 5 та 23:

<ul>
	<?php wp_list_pages('include=5,9,23&title_li=<h2>' . __('Poetry') . '</h2>' ); ?>
</ul>

Відсортуємо список відповідно до порядкових номерів, вказаних на сторінці редагування “постійних сторінок”:

<ul>
	<?php wp_list_pages('sort_column=menu_order'); ?>
</ul>

Виведемо список відсортований за датою створення “постійної сторінки” та покажемо дату поряд з кожним посиланням:

<ul>
	<?php wp_list_pages('sort_column=post_date&show_date=created'); ?>
</ul>

Використовуючи параметр exclude , виключимо сторінки з ID 17,38:

<ul>
	<?php wp_list_pages('exclude=17,38' ); ?>
</ul>

Використовуючи параметр include , створимо список лише зі сторінок з ID 35, 7, 26 та 13:

<ul>
	<?php wp_list_pages('include=7,13,26,35&title_li=<h2>' . __('Pages') . '</h2>' ); ?>
</ul>

Використовуючи наступний приклад, можна вивести в сайдбарі (або ще десь) список дочірніх сторінок (підсторінок), постійної сторінки на який ви зараз знаходитесь. Для цього скористаємося параметром child_of та перевіркою чи існують взагалі дочірні сторінки для поточної (спробуємо отримати дочірні сторінки в змінну $children, якщо вийде, виведемо список):

<?php
$children = wp_list_pages( 'title_li=&child_of=' . $post->ID . '&echo=0' );

if($children) {
	?>
	<ul>
		<?php echo $children; ?>
	</ul>
	<?php
}
?>

Підемо далі і виведемо список дочірніх сторінок і зробимо так, щоб цей список залишався, коли ми зайдемо на одну з таких дочірніх сторінок (тобто для дочірніх сторінок, вийде список однорівневих сторінок):

<?php
if( $post->post_parent ){
	$children = wp_list_pages( "title_li=&child_of=" . $post->post_parent . "&echo=0" );
}
else {
	$children = wp_list_pages( "title_li=&child_of=" . $post->ID . "&echo=0" );
}

if($children) {
	?>
	<ul>
		<?php echo $children; ?>
	</ul>
	<?php
}
?>

Альтернативний варіант попереднього прикладу.

Цей приклад також можна використовувати у сайдбарі, він виводитиме:

• коли ви перебуваєте на головній сторінці, будуть показані всі “постійні сторінки” верхнього рівня;

• коли ви знаходитесь на “постійній сторінці” верхнього рівня, яка не має дочірніх сторінок, будуть показані ті самі “постійні сторінки” верхнього рівня;

• коли ви знаходитесь на “постійній сторінці” верхнього рівня, яка має дочірні сторінки, будуть показані ці дочірні сторінки та їх дочірні сторінки;

• коли ви знаходитесь на дочірній сторінці “постійної сторінки” верхнього рівня (на сторінці другого рівня), будуть показані дочірні сторінки “постійної сторінки” верхнього рівня (тобто дочірні сторінки батьківської).

$output = wp_list_pages( 'echo=0&depth=1&title_li=<h2>Top level pages</h2>' );

if( is_page() ){
	$page = $post->ID;

	if( $post->post_parent ){
		$page = $post->post_parent;
	}

	$children = wp_list_pages( 'echo=0&child_of=' . $page . '&title_li=' );

	if($children) {
		$output = wp_list_pages( 'echo=0&child_of=' . $page . '&title_li=<h2>Child Pages</h2>' );
	}
}

echo $output;

Список дочірніх сторінок, який буде показаний, тільки якщо “постійна сторінка” має дочірні сторінки. Дочірні сторінки будуть показані як на батьківській постійній сторінці так і на самих дочірніх сторінках. Відмінністю від попереднього прикладу є наявність назви батьківської “постійної сторінки” в заголовку списку:

<?php
if( $post->post_parent ){
	$children = wp_list_pages( "title_li=&child_of=" . $post->post_parent . "&echo=0" );
	$titlenamer = get_the_title($post->post_parent);
}

else {
	$children = wp_list_pages( "title_li=&child_of=" . $post->ID . "&echo=0" );
	$titlenamer = get_the_title($post->ID);
}

if($children) {
	?>

	<h2> <?php echo $titlenamer; ?> </h2>
	<ul>
		<?php echo $children; ?>
	</ul>

	<?php
}
?>

Цей приклад показує, як отримати всі дочірні сторінки, на сторінках будь-якого рівня вкладеності:

<?php
if( ! $post->post_parent ){
	// Отримаємо дочірні сторінки, для "постійної сторінки" верхнього рівня
	$children = wp_list_pages( "title_li=&child_of=" . $post->ID . "&echo=0" );
}
else {
	// Отримаємо дочірні сторінки, якщо ми перебуваємо на дочірній сторінці першого рівня.
	//$children = wp_list_pages("title_li=&child_of=".$post->post_parent."&echo=0");

	if( $post->ancestors ){
		// тепер отримаємо ID першої сторінки (старшої)
		// wp збирає ID у зворотному порядку, тому "перша" сторінки буде останньою
		$ancestors = end($post->ancestors);
		$children = wp_list_pages( "title_li=&child_of=" . $ancestors . "&echo=0" );
		// все, тепер у нас завжди буде список зі всіх дочірніх сторінок,
		// якому рівні вкладеності ми не перебували.
	}
}

if($children) {
	?>
	<ul>
		<?php echo $children; ?>
	</ul>
	<?php
}
?>

Так як немає можливості вказати wp_list_pages виводити дерево (усі рівні вкладеності) сторінок певної сторінки (наприклад, сторінки з ID 93), то для такого трюку ми можемо скористатися функцією get_pages():

<?php
// Використовуємо wp_list_pages, щоб показати батьківську та всі дочірні сторінки
// (включаючи всі вкладені у них)
$pages = get_pages( 'child_of=93');
$parent = 25;
if( $pages ){
	$pageids = [];

	foreach( $pages as $page ){
		$pageids[] = $page->ID;
	}

	wp_list_pages([
		'title_li' => 'Дерево батьківської сторінки: ' . $parent,
		'include' => $parent . ','. implode( ',', $pageids ),
	]);
}
?>

За промовчанням wp_list_pages() створює список такої конструкції:

<li class="pagenav">Сторінки
	<ul>
		<li class="page_item page-item-4"></li>
		<li class="page_item page-item-5"></li>
		...
	</ul>
</li>

Якщо ми приберемо заголовок, поставивши порожній параметр title_li=, то вигляд стане таким:

<li class="page_item page-item-4"></li>
<li class="page_item page-item-5"></li>
...

Інакше можна написати так:

<li class="pagenav">
Сторінки [title_li]
  <ul>
	<!-- Список починається від сюди, якщо параметр 'title_li' порожній -->
	<li class="page-item-2 page_item current_page_ancestor current_page_parent">
	  [Батько поточної сторінки]
		  <ul>
			<li class="page-item-21 page_item current_page_item">[поточна сторінка]</li>
		  </ul>
	</li>
	<li class="page-item-3 page_item">[інші сторінки]</li>
  </ul>
</li>

Усі теги li створювані функцією wp_list_pages() позначені CSS класом page_item. Коли у списку з’являється сторінка, на який ви знаходитесь, до li елементу списку додається ще клас current_page_parent.

Таким чином, список можна “розфарбовувати” наступними селекторами CSS:

.pagenav { … } /* головний клас ul тега, який обертає весь список */
.page-item-2 { … } /* елемент, що відноситься до сторінки з ID 2 */
.page_item { … } /* будь-який елемент списку */
.current_page_item { … } /* поточна сторінка */
.current_page_parent { … } /* батьківська сторінка поточної */
.current_page_ancestor { … } /* будь-яка сторінка як або пов'язана з поточною (батько чи дочка.) */

Щоб досягти глобального впливу на елементи списку, використовуйте такі селектори:

.pagenav ul ul,
.pagenav .current_page_item ul ul,
.pagenav .current_page_ancestor ul ul,
.pagenav .current_page_ancestor .current_page_item ul ul,
.pagenav .current_page_ancestor .current_page_ancestor ul ul {
	display: none;
}

.pagenav .current_page_item ul,
.pagenav .current_page_ancestor ul,
.pagenav .current_page_ancestor .current_page_item ul,
.pagenav .current_page_ancestor .current_page_ancestor ul,
.pagenav .current_page_ancestor .current_page_ancestor .current_page_item ul,
.pagenav .current_page_ancestor .current_page_ancestor .current_page_ancestor ul {
	display: block;
}

<?php
// якщо це дочірня сторінка
if( $post->post_parent ){

	// збираємо родинні сторінки
	$relations = get_post_ancestors( $post->ID );

	// Отримуємо дочірні сторінки (якщо є)
	$result = $wpdb->get_results( "SELECT ID FROM wp_posts WHERE post_parent = $post->ID AND post_type='page'" );

	// якщо дочірні сторінки цієї сторінки вийшло
	// отримати об'єднуємо їх із спорідненими
	foreach( $result as $page_id ){
		$relations[] = $page_id->ID;
	}

	// додаємо поточну сторінку до родинних
	$relations[] = $post->ID;

	// робимо список ID розділений комами з родинних, дочірніх та поточної
	$relations_string = implode(",", $relations);

	// отримуємо список за допомогою параметра include
	$sidelinks = wp_list_pages( "title_li=&echo=0&include=" . $relations_string );
}
// якщо це не дочірня сторінка
else {
	// показуємо лише дочірні сторінки один рівень
	$sidelinks = wp_list_pages( "title_li=&echo=0&depth=1&child_of=" . $post->ID );
}

if( $sidelinks ){
	?>
	<h2><?php the_title(); ?></h2>
	<ul>
		<?php // виводимо на екран посилання в тегах <li>
		echo $sidelinks; ?>
	</ul>
	<?php
}
?>

Якщо на сайті створено довільний тип записів з деревоподібною структурою, wp_list_pages() можна використовувати для виведення і таких записів.

В цілому всі вищеописані приклади підійдуть і для цього випадку, єдине потрібно змінювати тип запису, з яким працюватиме функція.

Тип запису вказується в параметрі post_type:

wp_list_pages([
  'post_type'=>'portfolio',
  'title_li'=> __('Portfolio')
]);

<ul>
  <?php wp_list_pages('sort_column=menu_order&title_li='); ?>
</ul>