说明:
This is a simple function for creating multiple loops. It retrieves a list of latest posts or posts matching criteria.
Note that although the parameters are similar to get_pages, several have different names or take slightly different values (see get_pages).
用法
- <?php = get_posts( ); ?>
默认用法:
- <?php = (
- \’numberposts\’ => 5,
- \’offset\’ => 0,
- \’category\’ => ,
- \’orderby\’ => \’post_date\’,
- \’order\’ => \’DESC\’,
- \’\’ => ,
- \’exclude\’ => ,
- \’meta_key\’ => ,
- \’meta_value\’ => ,
- \’post_type\’ => \’post\’,
- \’post_mime_type\’ => ,
- \’post_parent\’ => ,
- \’post_status\’ => \’publish\’ ); ?>
参数:
get_posts() makes use of the WP_Query class to fetch posts. See the parameters section of the WP_Query documentation for a list of parameters that this function accepts.
Note: get_posts uses \'suppress_filters\' => true as default, while query_posts() applies filters by default, this can be confusing when using query-modifying plugins, like WPML.
返回值
- (array)
- List of post objects. Check get_post() return values.
例子
Posts list with offset
If you have your blog configured to show just one post on the front page, but also want to list links to the previous five posts in category ID 1, you can use this:
- <ul>
- <?php
- ;
- = ( \’numberposts\’ => 5, \’offset\’=> 1, \’category\’ => 1 );
- = get_posts( );
- ( ) : setup_postdata(); ?>
- <li><a href=><?php the_title(); ?></a></li>
- <?php ; ?>
- </ul>
Note: With use of the offset, the above query should be used only on a category that has more than one post in it, otherwise there\’ll be no output.
Reset after Postlists with offset
If you need after the loop, the post you had before joining the foreach, you can use this:
- <ul>
- <?php
- ;
- = ;
- = ( \’numberposts\’ => 5, \’offset\’=> 1, \’category\’ => 1 );
- = get_posts( );
- ( ) : setup_postdata(); ?>
- <li><a href=><?php the_title(); ?></a></li>
- <?php ; ?>
- <?php = ; ?>
- </ul>
Access all post data
Some post-related data is not available to get_posts by default, such as post content through the_content(), or the numeric ID. This is resolved by calling an internal function setup_postdata(), with the $post array as its argument:
- <?php
- = ( \’numberposts\’ => 3 );
- = get_posts( );
- ( ) : setup_postdata(); ?>
- <h2><a href=><?php the_title(); ?></a></h2>
- <?php the_content(); ?>
- <?php ; ?>
To access a post\’s ID or content without calling setup_postdata(), or in fact any post-specific data (data retained in the posts table), you can use $post->COLUMN, where COLUMN is the table column name for the data. So $post->ID holds the ID, $post->post_content the content, and so on. To display or print this data on your page use the PHP echo command, like so:
- <?php ->ID; ?>
Latest posts ordered by title To show the last ten posts sorted alphabetically in ascending order, the following will display their post date, title and excerpt
- <?php
- = ( \’numberposts\’ => 10, \’order\’=> \’ASC\’, \’orderby\’ => \’title\’ );
- = get_posts( );
- ( ) : setup_postdata(); ?>
- <div>
- <?php the_date(); ?>
- <br />
- <?php the_title(); ?>
- <?php the_excerpt(); ?>
- </div>
- <?php ; ?>
Random posts
Display a list of 5 posts selected randomly by using the MySQL RAND() function for the orderby parameter value:
- <ul>
- <?php
- = ( \’numberposts\’ => 5, \’orderby\’ => \’rand\’ );
- = get_posts( );
- ( ) : ?>
- <li><a href=><?php the_title(); ?></a></li>
- <?php ; ?>
- </ul>
Show all attachments
Do this outside any Loops in your template.
- <?php
- = ( \’post_type\’ => \’attachment\’, \’numberposts\’ => -1, \’post_status\’ => null, \’post_parent\’ => null );
- = get_posts( );
- () {
- ( ) {
- setup_postdata();
- the_title();
- the_attachment_link(->ID, false);
- the_excerpt();
- }
- }
- ?>
Show attachments for the current post
Do this inside The Loop (where $post->ID is available).
- <?php
- = ( \’post_type\’ => \’attachment\’, \’numberposts\’ => -1, \’post_status\’ => null, \’post_parent\’ => ->ID );
- = get_posts();
- () {
- ( ) {
- apply_filters( \’the_title\’ , ->post_title );
- the_attachment_link( ->ID , false );
- }
- }
- ?>
Get a post by its slug
Allows you to get a post ID by post slug. The caller_get_posts argument excludes sticky posts from this custom query.
- <?php
- = \’my_slag\’;
- =(
- \’name\’ => ,
- \’post_type\’ => \’post\’,
- \’post_status\’ => \’publish\’,
- \’showposts\’ => 1,
- \’caller_get_posts\’=> 1
- );
- = get_posts();
- ( ) {
- \’ID on the first post found \’.[0]->ID;
- }
- ?>
代码源自WordPress官方Codex
暂无评论内容