wordpress模板标签调用之列表list
本文最后更新于 976 天前,其中的信息可能已经有所发展或是发生改变。

wp_list_authors()

wp_list_authors(string/array $args = '');

显示出网站作者列表,可以是单个参数也可以是数组,我仅列出一些常用的参数供参考

orderby 依据什么来排序,默认以name来排序,可用值如下
  nicename         昵称
  email            邮箱地址
  url              网址
  registered       注册
  user_nicename    用户昵称
  user_email       用户邮箱
  user_registered  用户注册
  name             用户名
  display_name     显示的名称
  post_count       发布的文章数量
  ID               作者id
  meta_value       作者个人说明
  user_login       登录

order    排序方式,默认升序排序ASC
  ASC              顺序排序
  DESC             倒序排序

number   最大作者数量,默认全部作者

echo     控制是输出结果还是返回结果,默认true输出结果

style    如果参数值为list,则被包含在li标签中,否则作者以逗号分隔

html     是以html形式输出还是以纯文本输出,默认true以html形式输出

使用案例

下面的函数,基本上都照着这样写就可以,两种方法都ok

wp_list_authors(array(
  'orderby' => 'ID',
  'order'   => 'DESC',
  'number'  => 3,
  'echo'    => true,
  'style'   => 'list',
  'html'    => 'true'
));
wp_list_authors('orderby=id&order=desc&number=3&echo=true&style=list&html=true');

wp_list_categories()

wp_list_categories(string/array $args = '');

显示分类目录的html列表,常用参数

current_category     填写指定分类目录的id或者id数组,默认0。给指定的分类添加样式current-cat类
                     'current_category' => '1,2'

include              指定特定的分类,只显示给定的分类。可以是分类id的数组,也可以逗号分隔多个id
                     'include' => '1,2'

exclude              排除分类目录,可以是分类id的数组,也可以逗号分隔多个id,使用的时候include必须为空
                     'exclude' => '1,2'

exclude_tree         同上,连同指定id的子分类也一起排除
                     'exclude_tree' => '1'

hide_title_if_empty  分类目录下无子分类,是否隐藏。默认不隐藏,值1、0对应true和false,都可以使用
                     'hide_title_if_empty' => 'true'

hide_empty           是否隐藏没有文章的分类,值1、0对应true和false,都可以使用
                     'hide_empty' => 'true'

style                列表样式,默认li标签。设置为0时,以a标签显示
                     'style' => 'list'

showcount            是否显示文章数量,值1、0对应true和false,都可以使用
                     'showcount' => '1'

use_desc_for_title   是否显示title属性,值1、0对应true和false,都可以使用
                     'use_desc_for_title' => '1'

child_of             指定一个分类,显示该分类的子分类。默认为0包含所有分类
                     'child_of' => '1'

taxonomy             指定一个分类法,可用于自定义分类。默认category
                     'taxonomy' => 'category'

depth                分类的深度,默认是0所有分类。-1所有分类在同一层级;1只显示顶级分类;n只显示第n层级的分类
                     'depth' => '2'

title_li             设置列表的标题,默认为Categories。为空时,不显示。
                     'title_li' => '<h2>' . __( '分类1' ) . '</h2>'

wp_list_pages()

wp_list_pages(array|string $args = '');

显示页面列表,li标签包裹,常用参数

child_of             同wp_list_categories()
depth                同wp_list_categories()
include              同wp_list_categories()
exclude              同wp_list_categories()
exclude_tree         同wp_list_categories()
title_li             同wp_list_categories()

authors              指定作者id或者id数组,或以逗号分隔。输出该作者的页面,默认为空指定所有作者
                     'authors' => '1'

post_type            输出指定的页面类型。默认为page
                     'post_type' => 'page'

post_status          输出指定页面的状态。默认为publish发布
                     'post_status' => 'publish'

show_date            输出指定页面的日期。为空时,隐藏日期;modified为修改日期;publish为发布日期
                     'show_date' => 'publish'

item_spacing         是否保留列表中的空白文本。默认preserve保留;discard丢弃
                     'item_spacing' => 'discard'

自动添加的class类名

.page_item‎ 列表中,每个页面的对应项会添加这个类名

.page-item-ID 列表中,每个页面的对应项会添加这个类名,ID就是页面的id
.current_page_item 列表中,当前页面的对应项会添加这个类名

.current_page_parent 列表中,当前页面的父级页面会添加这个类名

.current_page_ancestor 列表中,当前页面的顶级页面会添加这个类名

wp_page_menu()

wp_page_menu(array|string $args = array());

跟上面的wp_list_pages()很相似,输出页面的列表。但是是以div包裹,可以定义类名等

include              同wp_list_pages()
exclude              同wp_list_pages()
exclude_tree         同wp_list_pages()
item_spacing         同wp_list_pages()


menu_id              指定特定页面的id,默认为空
                     'menu_id' => '12'

menu_class           指定包含页面列表的标签的class类名,默认为class="menu"
                     'menu_class' => 'active'

container            指定包含页面列表的标签,默认为"div"。
                     'container' => 'ul'

show_home            是否显示首页链接,默认为不显示。值1、0对应true和false,都可以使用
                     'show_home' => '1'

before               div容器内,包裹列表的标签。默认为"<ul>"
                     'before' => '<ul>'

after                div容器内,包裹列表的结束标签。默认为"</ul>"
                     'after' => '</ul>'

wp_dropdown_pages()

wp_dropdown_pages(array|string $args = '');

输出页面列表,并以下来列表来显示页面列表以<select>包裹,暂时用不到这个。待更新…

wp_dropdown_categories()

wp_dropdown_categories(array|string $args = '');

输出分类列表,并以下拉形式来显示列表以<select>包裹。下拉形式的分类列表,应该用的不多。暂时用不到这个。待更新…

wp_list_bookmarks()

wp_list_bookmarks(string|array $args = '');

这个函数是使用wordpress自带的链接管理,一般用来输出友情链接的。不过现在的版本,wordpress都是默认关闭这个功能的,所以不研究它了。现行办法是在菜单管理中新增自定义菜单作为友情链接

wp_list_comments()

wp_list_comments(string|array $args = array()WP_Comment[] $comments = null);

输出评论列表,个人一般都是做的企业网站。暂时用不到这个。待更新…

wp_get_archives()

wp_get_archives(string|array $args = '');

用于输出文章归档列表,博客类网站用的比较多。暂时用不到这个。待更新…

wp_dropdown_users

wp_dropdown_users(array|string $args = '');

用于用户列表。暂时用不到这个。待更新…

文章原文:https://www.luojiasan.com/category/wordpress/771.html
文章来源:https://www.luojiasan.com
[声明]本站内容除特别声明外,均属站长手写原创内容。
1、本站所有原创文章、图片等资料,如需转载使用,必须附上来源出处及链接方式;
2、若本站侵犯到您的权益或任何版权问题,请立即告知本站,我们将及时删除并致以最深的歉意!
3、本站转载文章版权归原作者所有,内容为作者个人观点,本站只提供参考并不构成任何投资及应用建议。任何本站转载文章链接及得到的资讯、产品、服务,本站概不负责,亦不负任何法律责任。
暂无评论

发送评论 编辑评论


				
上一篇
下一篇