Uso da função
Veja abaixo, exemplos para o uso do get_posts().Como você pode ver, é passado um parâmetro chamado "$args", dentro da função. Essa variável, é um array composto com vários outros parâmetros utilizados para filtrar os itens retornados.
<?php
$args = array (
'posts_per_page' => 5,
'offset' => 0,
'category' => '',
'category_name' => '',
'orderby' => 'date',
'order' => 'DESC',
'include' => '',
'exclude' => '',
'meta_key' => '',
'meta_value' => '',
'post_type' => 'post',
'post_mime_type' => '',
'post_parent' => '',
'author' => '',
'author_name' => '',
'post_status' => 'publish',
'suppress_filters' => true
);
'posts_per_page' => 5,
'offset' => 0,
'category' => '',
'category_name' => '',
'orderby' => 'date',
'order' => 'DESC',
'include' => '',
'exclude' => '',
'meta_key' => '',
'meta_value' => '',
'post_type' => 'post',
'post_mime_type' => '',
'post_parent' => '',
'author' => '',
'author_name' => '',
'post_status' => 'publish',
'suppress_filters' => true
);
$posts = get_posts($ args);
?>
<?php
global $post;
$args = array( 'posts_per_page' => 5, 'offset'=> 1, 'category' => 1 );
$myposts = get_posts( $args );
foreach ( $myposts as $post ) : setup_postdata( $post ); ?>
<li>
<a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>
</li>
<?php endforeach;
wp_reset_postdata();
?>
Parâmetros da função get_posts()
order: Use o valor "ASC" para ordem crescente e "DESC" para ordem decrescente. Associe esse parâmetro ao próximo.orderby: Classifica a ordem de retorno dos posts. A configuração padrão é a ordem alfabética pelo título do item.
Valores para o parâmetro orderby:
- id - Ordem pelo ID
- author - Ordem por autor.
- title - Ordem por título.
- date - Ordem por data.
- modified - Ordem pela data da última modificação.
- parent - Ordem pela página pai. Deve ser passado o ID da página.
- rand - Ordem aleatória.
- comment_count - Ordem pelo número de comentários.
- menu_order - Ordena pelo campo "Order" na caixa "Edit Page Attributes", mas pode ser usado para qualquer tipo de postagem com valores para 'menu_order'.
- meta_key - Você pode passar o nome de algum campo personalizado e utilizar os dois próximos parâmetros para ordenar por esse campo.
- meta_value - Aqui você pode definir um valor específico para o campo "meta_key".
- meta_value_num - Ordena o campo passado em "meta_key" por ordem numérica.
posts_per_page: Quantidade de posts retornados para cada página, deve ser usado junto com o parâmetro "page".
page: Número da página para os posts. Por exemplo, se você possuir 15 posts e o posts_per_page estiver definido em 5, na página 1 irá aparecer os 5 primeiros posts retornados, na página 2, os próximos 5 e assim por diante.
category: Você filtrar os posts pelo ID de determinada categoria.
category_name: Semelhante ao anterior, porém, aqui você passa o nome da categoria e não o ID.
include: Pode ser passado um Array de ID's dos posts para que eles seja incluídos no retorno
exclude: Pode ser passado um Array de ID's dos posts para que eles seja excluídos do retorno
post_type: Defini o tipo de post que vai ser retornado. Tem o valor padrão 'post'. Ex: attachmentm, page etc.
