目录

主题制作开发汇总


WordPress主题制作教程(13):基本模板知识汇总及WordPress主题常用函数大全

基本模板文件

文件名 描述
style.css 主题样式文件
index.php 首页模板文件
header.php 头部模板文件
single.php 单篇文章模板文件
archive.php 存档/分类模板文件
searchform.php 搜索表单模板文件
search.php 搜索模板文件
404.php 404 模板文件
comments.php 留言模板文件
footer.php 底部模板文件
sidebar.php 侧边栏模板文件
page.php 静态页面模板文件
front-page.php 静态首页模板文件
tag.php 标签存档模板文件
category.php 分类存档模板文件
移动端左右滑动查看

头部函数

通常用在主题页眉header.php文件中,下表的是用在<head>中, 此元素包含了所有的头部标签元素。在 <head>元素中你可以插入脚本(scripts), 样式文件(CSS),及各种meta信息。

函数名 描述
<?php site_url(); ?> 站点根链接
<?php wp_title(); ?> 文章或者静态页面标题
<?php bloginfo('name'); ?> 站点名称
<?php bloginfo('description'); ?> 站点描述
<?php get_stylesheet_directory(); ?> 样式文件所在目录
<?php bloginfo('stylesheet_url'); ?> 样式文件链接
<?php bloginfo('pingback_url'); ?> pingback 链接
<?php bloginfo('template_url'); ?> 模板文件所在目录链接
<?php bloginfo('version'); ?> WordPress 版本
<?php bloginfo('atom_url'); ?> atom 链接
<?php bloginfo('rss2_url'); ?> rss2 链接
<?php bloginfo('url'); ?> 网站根链接
<?php bloginfo('html_type'); ?> html 版本
<?php bloginfo('charset'); ?> 字符集
<?php echo get_stylesheet_directory(); ?> 模板文件所在目录路径
移动端左右滑动查看

导航菜单

我们的主题制作教程推荐使用wp_nav_menu导航菜单函数,排序,子分类,css属性,自定义链接,非常强大灵活。

默认导航菜单
<?php wp_nav_menu(); ?>
指定的导航菜单
<?php wp_nav_menu( array('menu' => 'Project Nav' )); ?>
基于分类的导航
<ul id="menu">
<li <?php if(is_home()) { ?> class="current-cat" <?php } ?>>
<a href="<?php bloginfo('home'); ?>">Home</a></li>
<?php wp_list_categories('title_li=&orderby=id');?>
</ul>
基于页面的导航
<ul id="menu">
<li <?php if(is_home()) { ?> class="current-page-item" <?php } ?>>
<a href="<?php bloginfo('home'); ?>">Home</a></li>
<?php wp_list_pages('sort_column=menu_order&depth=1&title_li=');?>
</ul>
移动端左右滑动查看

模板函数

主题制作时,列表页,文章页,单页面,常用的函数见下表,功能见后面的描述

函数名 描述
<?php the_content(); ?> 文章内容
<?php if(have_posts()): ?> 检查是否有文章
<?php while(have_posts()): the_post(); ?> 显示文章
<?php endwhile; ?> 结束循环
<?php endif; ?> 结束判断
<?php get_header(); ?> 头部模板内容
<?php get_sidebar(); ?> 侧边栏模板内容
<?php get_footer(); ?> 底部模板内容
<?php the_time('m-d-y'); ?> 显示时间,格式为:'08-18-07′
<?php comments_popup_link(); ?> 显示到文章留言的链接
<?php the_title(); ?> 文章标题
<?php the_permalink(); ?> 文章链接
<?php the_category(); ?> 文章分类
<?php the_author(); ?> 文章作者
<?php the_ID(); ?> 文章 ID
<?php edit_post_link(); ?> 文章编辑链接
<?php wp_list_bookmarks(); ?> 友情链接列表
<?php comments_template(); ?> 留言模板内容
<?php wp_list_pages(); ?> 所有页面列表
<?php wp_list_categories(); ?> 所有分类列表
<?php next_post_link('%link'); ?> 下一篇文章链接
<?php previous_post_list('%link'); ?> 上一篇文章链接
<?php get_calendar(); ?> 显示文章日历
<?php wp_get_archives(); ?> 存档链接列表
<?php posts_nav_link(); ?> 上一篇和下一篇文章链接
<?php rewind_posts(); ?> 重回开头开始第二个循环
移动端左右滑动查看

主循环

主循环结构适用于列表页,文章页,单页面,对于我们开发者来说,太方便,提高效率

基本循环
<?php if(have_posts()) { ?>
<?php while(have_posts()) { ?>
<?php the_post(); ?>
<?php // custom post content code for title, excerpt and featured image ?>
<?php } // end while ?>
<?php } // end if ?>
移动端左右滑动查看

其他函数

函数名 描述
/%postname%/ 自定义固定链接
<?php include(TEMPLATEPATH . '/x'); ?> 从模板文件夹加载文件
<?php the_search_query(); ?> 搜索表单返回的值
<?php _e('Message'); ?> 返回翻译之后的文本
<?php wp_register(); ?> 注册链接
<?php wp_loginout(); ?> 登录/登出链接
<!–nextpage–> 将文章那个内容分页
<!–more–> 截断文章内容,并创建到全文的链接
<?php wp_meta(); ?> 管理元链接
<?php timer_start(); ?> 开始计时 (header.php)
<?php timer_stop(1); ?> 停止计时 (footer.php)
<?php echo get_num_queries(); ?> 显示生成当前页面所需的查询数
移动端左右滑动查看

页面判断函数

函 数 名 称 用  法 说 明
is_home() <?php if(is_home())?> true 为首页,false 为第二页 判断是否为第一页
is_paged() <?php if(is_paged())?> 当页面为第二页时,?paged=2
is_single() <?php if(is_single())?>
<?php if(is_single(2))?>文章 id
<?php if(is_single('标题'))?>文章标题
是否为文章单一页面,如要针对特定文章时,可在()中加入文章的 ID 参数,或标题文字
is_page() <?php if(is_page())?>
<?php if(is_page(2))?>分页 id
<?php if(is_page('标题'))?>分页标题
是否为分页,与单一页面用法相同,在()中可再针对个別的分页 ID 与标题作判断
is_category() <?php if(is_category())?>
<?php if(is_category(2))?>分类 id
<?php if(is_category('标题'))?>分类标题
<?php if(is_category(array(6,7)))?>分类 id 为 6、7
<?php if(is_category(array(6,7,'minwt')))?>分类 id 为 6、7 或 minwt
是否为分类,()中可输入分类 ID 与名称,再个別作判断
is_archive() <?php if(is_archive())?> 是否为存档页面
is_search() <?php if(is_search())?> 是否为搜索面
is_404 <?php if(is_404())?> 是否为找不到画面 404
is_tag() <?php if(is_tag())?> 是否为标签页面
is_date() <?php if(is_date())?> 是否为日期存档页面
is_year() <?php if(is_year())?> 是否为年份存档页面
is_month() <?php if(is_month())?> 是否为月份存档页面
is_day() <?php if(is_day())?> 是否为天存档页面
移动端左右滑动查看

评论函数

wp_list_comments() 用于读取wordpress文章或者页面评论数据的函数
comments_template() 加载评论模板,
get_comments() 可以获取整站的评论,在设置相关参数后,还可以获取指定文章、指定用户、指定评论ID或指定邮箱的评论
comment_form() 构建评论表单
移动端左右滑动查看

特色图-缩略图函数

has_post_thumbnail() 判断当前文章是否有缩略图
the_post_thumbnail() 直接输出特色图像,是包括IMG标签
the_post_thumbnail_url() 直接输出获取特色图像的地址,可指定参数
get_the_post_thumbnail_url() 获取特色图像的地址
移动端左右滑动查看

掌握以上函数,可以制作出自己的主题。更多WordPress开发教程请看WordPress专栏


写笔记

咨询

您的电子邮箱地址不会被公开。 必填项已用*标注