【说明】
这是一个用于创建多环路的简单标签。用于检索最新的或者匹配条件的文章列表。
注意,虽然参数与get_pages方法类似,但是有几个参数略有不同。
【用法】
<?php $posts_array = get_posts( $args );?>
默认情况下的用法
<?php $args = array('numberposts'=>5,'offset'=>0,'category'=>,'orderby'=>'post_date','order'=>'DESC','include'=>,'exclude'=>,'meta_key'=>,'meta_value'=>,'post_type'=>'post','post_mime_type'=>,'post_parent'=>,'post_status'=>'publish'); $posts_array = get_posts( $args );?>
【示例应用】
获取最初到现在的文章列表
如果在博客首页上只设置显示一篇文章,但同时希望在分类ID 1中显示最近五篇文章的链接,可使用如下代码:
<ul><?php global $post; $myposts = get_posts('numberposts=5&offset=1&category=1');foreach($myposts as $post):?><li><a href="<?php the_permalink();?>"><?php the_title();?></a></li><?php endforeach;?></ul>
注意:使用offset时,以上查询仅适用于含有一篇以上文章的分类,否则无法输出。
获取所有文章资料
默认情况下get_posts无法获取一些文章相关数据,如通过 the_content()获取文章内容或序列ID。调用内部函数setup_postdata(),以$post 数组为其自变量,可以解决这一问题:
<?php $lastposts = get_posts('numberposts=3');foreach($lastposts as $post): setup_postdata($post);?><h2><a href="<?php the_permalink();?>" id="post-<?php the_ID();?>"><?php the_title();?></a></h2><?php the_content();?><?php endforeach;?>
不希望通过调用setup_postdata()来获取文章的ID或内容,或者获取文章的任何相关数据时(数据存留在文章列表中),可以使用$post->COLUMN,COLUMN是文章数据表格的纵列名称。因此$post->ID指明文章ID,$post->post_content指明文章内容,以此类推。如要在页面上显示这些数据,请使用PHP echo命令,如下所示:
<?php echo $post->ID;?>
按标题为最新发表文章排序
以下代码可按字母升序显示最近发表的十篇文章的发布日期、标题和摘要:
<?php $postslist = get_posts('numberposts=10&order=ASC&orderby=title');foreach($postslist as $post): setup_postdata($post);?><div><?php the_date();?><br/><?php the_title();?><?php the_excerpt();?></div><?php endforeach;?>
注意:排序参数在2.6版本中有所修改。此代码适用于新排序格式。详细内容参见参数。
任意文章
用MySQL RAND()函数指定排序参数的值,可以显示出随意选择的五篇文章:
<ul><li><h2>A random selection of my writing</h2><ul><?php $rand_posts = get_posts('numberposts=5&orderby=rand');foreach( $rand_posts as $post ):?><li><a href="<?php the_permalink();?>"><?php the_title();?></a></li><?php endforeach;?></ul></li></ul>
显示所有附件
不用模板中任何循环进行本项操作。
(使用2.5版本后的get_children()函数相对方便。)
<?php $args = array('post_type'=>'attachment','numberposts'=>-1,'post_status'=>null,'post_parent'=>null,// any parent ); $attachments = get_posts($args);if($attachments){foreach($attachments as $post){ setup_postdata($post); the_title(); the_attachment_link($post->ID,false); the_excerpt();}}?>
显示最新文章的附件
在The_Loop($post->ID可用)中进行本类操作。
<?php $args = array('post_type'=>'attachment','numberposts'=>-1,'post_status'=>null,'post_parent'=> $post->ID ); $attachments = get_posts($args);if($attachments){foreach($attachments as $attachment){ echo apply_filters('the_title', $attachment->post_title); the_attachment_link($attachment->ID,false);}}?>
【参数:WordPress 2.6+】
除“WordPress 2.5及更早版本”中列出的参数外,get_posts( )也能运行query_posts( )所操作的参数,目前这两个函数在内部使用相同的数据库查询代码。
注意:2.6版本对一些排序选项做了更改。表格字段前不再含有post_字样。如post_title已被改为title,post_data改为data。
参数:WordPress 2.5及更早版本
$numberposts
(整数)(可选)将要返回的文章数量。将其设为0可在每页上显示最大数量文章数,设为-1可消除限制。
默认值:5
$offset
(整数)(可选)以最新文章为起始位
默认值:0
$category
(整数)(可选)仅显示本分类编号下的文章。将分类编号设为负数(如果是3,设为-3),显示结果不匹配。用逗号将分类编号隔开,或传递编号数组,可指定多个分类编号。
默认值:None
$category_name
(字符)(可选)仅显示本分类名称或分类缩略名下的文章。
默认值:None
$tag
(字符)(可选)仅显示本标签缩略名下的文章。若指定多个用逗号隔开的标签缩略名,则返回结果是:所有文章都与某个标签匹配。若指定多个用空格隔开的标签缩略名,返回结果是:所有文章都与指定标签缩略名匹配。
默认值:None
$orderby
(字符)(可选)按不同值(用空格隔开)为文章排序,包括:
‘author’ —— 按作者数值编号排序
‘category’ —— 按类别数值编号排序
‘content’ —— 按内容排序
‘date’ —— 按创建日期排序
‘ID’ —— 按文章编号排序
‘menu_order’ —— 按菜单顺序排序。仅页面可用。
‘mime_type’ —— 按MIME类型排序。仅附件可用。
‘modified’ —— 按最后修改时间排序。
‘name’ —— 按存根排序。
‘parent’ —— 按父级ID排序
‘password’ —— 按密码排序
‘rand’ —— 任意排序结果
‘status’ —— 按状态排序
‘title’ —— 按标题排序
‘type’ —— 按类型排序
注意:
按编号排序和任意排序自2.5版本起启用。
默认值:post_date
$order
(字符)(可选)如何对$order排序。可能的值为:
‘ASC’ —— 升序 (低到高)
‘DESC’ —— 降序 (高到底)
默认值:DESC
$include
(字符)(可选)希望显示的文章编号,用逗号和/或空格隔开。显示六篇文章时,下列值可能生效:
’45,63,78 94,128,140′
注意:该参数将改写numberposts,offset,category,exclude,meta_key,meta_value,及post_parent参数。
默认值:None
$exclude
(字符)(可选)不希望显示的文章编号,用逗号和/或空格隔开(参见$include参数)。
默认值:None
$meta_key 和$meta_value
(字符)(可选)仅显示含有该关键词和值的元(自定义)字段的文章。两项参数都应定义,否则无法运行。
默认值:None
$post_type
(字符)(可选)希望显示的文章类型。可选项有:
post —— 默认
page
attachment
any —— 任意文章类型
默认值:post
$post-status
(字符)(可选)显示特定状态的文章。可选项有:
publish
private
draft
future
inherit —— 若$post_type设为附件,则此项为默认选项
(blank)—— 所有状态
默认值:publish
$post_parent
(整数)(可选)显示此文章编号下的子文章
默认值:None
$nopaging
(布尔型)(可选)激活或禁用分页功能。如果禁用,$numberposts选项被略过。
默认值:None
http://www.wpnoob.cn/a-52.html
相关推荐
为了让用户能够更好地掌握和利用WordPress,下面我将详细阐述WordPress中常用标签调用代码的具体知识点。 1. 显示日志或页面信息的标签 - `(); ?>`:这个函数用于显示当前日志或页面的标题。 - `(); ?>`:这个...
在WordPress中,自定义文章列表列是一项常见的需求,尤其对于那些希望根据特定字段对文章进行展示和排序的用户来说。在本案例中,我们将探讨如何实现一个自定义的“推荐指数”列,允许用户在文章列表中直观地查看每...
在源代码中,我们可以看到如何通过Android的HttpURLConnection或者Retrofit库来调用这些API,进行登录、获取文章、评论、分类等操作。了解RESTful API的使用是理解和修改此客户端的关键。 三、Android组件和服务 ...
在WordPress中,获取置顶文章列表是一个常见的需求,这通常涉及到对WordPress的查询机制和自定义查询的理解。置顶文章是指被标记为“stickied”的文章,它们会在其他文章之前显示,无论它们的发布日期如何。下面我们...
本文将详细介绍如何在WordPress主题中实现文章列表页码导航的PHP代码实例。 首先,WordPress默认并没有提供直接用于文章列表分页的函数,通常只提供了上一页和下一页的按钮。为了实现完整的分页导航,我们需要...
在WordPress中,获取文章作者与分类信息是构建和定制网站内容展示的...如果你需要进一步了解或实践这些技巧,可以参考相关的WordPress开发教程或文档,例如文中提到的其他相关文章,它们将提供更深入的指导和示例代码。
>`函数,可以显示同一分类下的文章列表。其中,`$num`为分类ID,`$limit`指定显示的文章数量,`$order`可设置文章显示顺序(默认降序)。 3. **模板文件**: - `style.css`:样式表文件,用于定义网站外观。 - `...
在开发wordpress文章页模板的评论模块时一般需要添加文章的评论数,有时候我们在热门推荐的列表时也需要输出文章的评论数。 今天wordpress教程网就为大家介绍如何获取文章页的评论数。方法很简单,以下我们使用$wpdb...
总结起来,这段代码展示了如何在WordPress中自定义一个循环列表,包括指定特定分类、标签,控制每页显示的帖子数量,以及添加分页功能。这对于开发者来说是一个实用的示例,可以根据自己的需求进行调整和扩展,以...
5. **archive.php**:处理分类和日期归档页面,展示按日期或类别组织的文章列表。 6. **searchform.php**:包含搜索表单的HTML结构,允许用户在网站中进行搜索。 7. **search.php**:用于显示搜索结果的页面。 8....
“提取文章内容图片作为缩略图”的功能是这个插件的一大亮点。当用户撰写的文章没有设置自定义的缩略图时,这个功能会自动从文章内容中选取一张图片作为文章的代表缩略图。这样不仅解决了部分用户忘记设置缩略图的...
### WordPress自动获取显示第一张图片 ...通过以上步骤,你就可以轻松地在WordPress网站上实现自动获取并显示文章的第一张图片的功能了。这对于提高网站的用户体验以及减少管理工作量都是非常有帮助的。
在WordPress网站中,为了提供更好的用户体验,我们常常会利用AJAX技术来实现文章列表和评论的分页功能。这样,用户无需手动点击分页按钮,而是可以无刷新地浏览更多的内容,尤其是评论部分,可以避免页面完全重载,...
这个函数允许我们对主查询进行自定义,从而获取不同的文章列表。以下是一个调用最近10篇文章的示例: ```php query_posts('showposts=10&orderby=new'); // showposts=10 表示显示10篇文章,orderby=new 表示按...
* 获取随机文章:使用 `get_posts()` 函数获取随机文章列表。 WordPress 目录文件介绍 WordPress 目录中包含了多个文件和文件夹,包括: * `license.txt`: WordPressGPL 许可证文件。 * `my-hacks.php`: 定义了...
在WordPress开发中,熟练掌握代码调用方法与技巧是至关重要的。这些代码片段可以帮助开发者更加高效地自定义网站,创建独特的用户体验。以下是一些关键的WordPress代码调用及其用途: 1. **样式表文件(style.css)**...
例如,文章列表、编辑器界面等,都使用了Android的LinearLayout、RecyclerView等布局组件。此外,源码还利用了Fragment来管理屏幕的不同部分,实现界面的动态加载和切换。 四、数据存储与同步 本地数据存储方面,...
4. **Index.php**: 这是默认的首页模板,展示博客文章列表。 5. **Single.php**: 用于显示单篇文章的模板。 6. **Archive.php**: 用于显示归档页面,如日期归档或分类归档。 7. **Page.php**: 用于显示独立页面。...
这些模板通常包括登录注册、文章列表、详情页、评论区等功能,以及与WordPress后端数据同步的逻辑代码。 在提供的压缩包文件"weTravel"中,我们可以推测这是一个旅行相关的小程序模板,可能包含了展示旅游景点、...