Skip to content

get_pages

fevereiro 23, 2010

Muito cuidado, pois com páginas usa get_pages, e com este dito cujo, os parâmetros são bem diferentes em relação aos posts

REFERÊNCIA: http://codex.wordpress.org/Function_Reference/get_pages

Description

This function is used to get a list of all the pages that are defined in the blog. Essentially get_pages gives you an array of the pages, and that array is not tree-like. See the template tag, wp_list_pages(), for the output of page titles in a tree-like fashion.

Usage

<?php get_pages('arguments'); ?>

Default Usage

<?php $args = array(
'child_of' => 0,
'sort_order' => 'ASC',
'sort_column' => 'post_title',
'hierarchical' => 1,
'exclude' => ,
'include' => ,
'meta_key' => ,
'meta_value' => ,
'authors' => ,
'parent' => -1,
'exclude_tree' => ,
'number' => ,
'offset' => 0 ); ?>

Parameters

sort_column
(string) Sorts the list of Pages in a number of different ways. The default setting is sort alphabetically by Page title.

  • 'post_title' – Sort Pages alphabetically (by title) – default
  • 'menu_order' – Sort Pages by Page Order. N.B. Note the difference between Page Order and Page ID. The Page ID is a unique number assigned by WordPress to every post or page. The Page Order can be set by the user in the Write>Pages administrative panel.
  • 'post_date' – Sort by creation time.
  • 'post_modified' – Sort by time last modified.
  • 'ID' – Sort by numeric Page ID.
  • 'post_author' – Sort by the Page author’s numeric ID.
  • 'post_name' – Sort alphabetically by Post slug.
Note: The sort_column parameter can be used to sort the list of Pages by the descriptor of any field in the wp_post table of the WordPress database. Some useful examples are listed here.
sort_order
(string) Change the sort order of the list of Pages (either ascending or descending). The default is ascending. Valid values:

  • 'asc' – Sort from lowest to highest (Default).
  • 'desc' – Sort from highest to lowest.
exclude
(string) Define a comma-separated list of Page IDs to be excluded from the list (example: 'exclude=3,7,31'). There is no default value.
include
(string) Only include certain Pages in the list generated by get_pages. Like exclude, this parameter takes a comma-separated list of Page IDs. There is no default value.
child_of
(integer) Displays the sub-pages of a single Page only; uses the ID for a Page as the value. Defaults to 0 (displays all Pages). Note that the child_of parameter will also fetch “grandchildren” of the given ID, not just direct descendants.

  • 0 – default, no child_of restriction
parent
(integer) Displays those pages that have this ID as a parent. Defaults to -1 (displays all Pages regardless of parent). Note that this can be used to limit the ‘depth’ of the child_of parameter, so only one generation of descendants might be retrieved. You must use this in conjuction with the child_of parameter. Feed it the same ID.

  • -1 – default, no parent restriction
  • 0 – returns all top level pages
exclude_tree
(integer) The opposite of ‘child_of’, ‘exclude_tree’ will remove all children of a given ID from the results. Useful for hiding all children of a given page. Can also be used to hide grandchildren in conjunction with a ‘child_of’ value. This parameter was available at Version 2.7.
hierarchical
(boolean) Display sub-Pages in an indented manner below their parent or list the Pages inline. The default is true (display sub-Pages indented below the parent list item). Valid values:

  • 1 (true) – default
  • 0 (false)
meta_key
(string) Only include the Pages that have this Custom Field Key (use in conjunction with the meta_value field).
meta_value
(string) Only include the Pages that have this Custom Field Value (use in conjunction with the meta_key field).
authors
(string) Only include the Pages written by the given author(s)
number
(integer) Sets the number of Pages to display. This causes the SQL LIMIT value to be defined. Default to no LIMIT. This parameter was added with Version 2.8.
offset
(integer) Then number of Pages to pass over (or displace) before collecting the set of Pages. Default is no OFFSET. This parameter was added with Version 2.8.

Return

(Array)
An array containing all the Pages matching the request

Example

Displaying pages in dropdown list

In this example a dropdown list with all the pages. Note how you can grab the link for the page with a simple call to the function get_page_link passing the ID of the page.

<select name="page-dropdown"
 onchange='document.location.href=this.options[this.selectedIndex].value;'> 
 <option value="">
<?php echo attribute_escape(__('Select page')); ?></option> 
 <?php 
  $pages = get_pages(); 
  foreach ($pages as $pagg) {
  	$option = '<option value="'.get_page_link($pagg->ID).'">';
	$option .= $pagg->post_title;
	$option .= '</option>';
	echo $option;
  }
 ?>
</select>

Displaying Child pages of the current page in post format

<?php
	$pages = get_pages('child_of='.$post->ID.'&sort_column=post_date&sort_order=desc');
	$count = 0;
	foreach($pages as $page)
	{		
		$content = $page->post_content;
		if(!$content)
			continue;
		if($count >= 2)
			break;
		$count++;	
		$content = apply_filters('the_content', $content);
	?>
		<h2><a href="<?php echo get_page_link($page->ID) ?>"><?php echo $page->post_title ?></a></h2>
		<div><?php echo $content ?></div>
	<?php
	}	
?>
Anúncios
One Comment leave one →
  1. julho 25, 2011 1:59 pm

    Eu estou fazendo um box que pega todos os posts, mas, ele só não vai precisar mostrar 3 posts, eu fiz o teste com o ‘exclude’ => 89, mas quando vou adicionar os outros dois codigos de cada post, ele não funciona.
    O exclude é só funciona para um post só?

Deixe um comentário

Preencha os seus dados abaixo ou clique em um ícone para log in:

Logotipo do WordPress.com

Você está comentando utilizando sua conta WordPress.com. Sair / Alterar )

Imagem do Twitter

Você está comentando utilizando sua conta Twitter. Sair / Alterar )

Foto do Facebook

Você está comentando utilizando sua conta Facebook. Sair / Alterar )

Foto do Google+

Você está comentando utilizando sua conta Google+. Sair / Alterar )

Conectando a %s

%d blogueiros gostam disto: