文件名 | 描述 |
style.css | 主题样式文件 |
index.php | 首页模板文件 |
header.php | 头部模板文件 |
single.php | 单篇文章模板文件 |
archive.php | 存档/分类模板文件 |
search.php | 搜索模板文件 |
404.php | 404 模板文件 |
comments.php | 留言模板文件 |
footer.php | 底部模板文件 |
sidebar.php | 侧边栏模板文件 |
page.php | 静态页面模板文件 |
tag.php | 标签存档模板文件 |
category.php | 分类存档模板文件 |
头部函数
函数名 | 描述 | 实例 |
<?php echo site_url(); ?> | 站点根链接 | https://www.jiaxiangz.com |
<?php bloginfo('name'); ?> | 站点名称 | 网站名称 |
<?php bloginfo('description'); ?> | 站点描述 | 这是一个网站描述 |
"<?php echo get_theme_file_uri() . '/images/favicon.gif'; ?> | 引用主题目录(例如模板中引用css、js、图片等) | https://www.nongyejing.com/wp-content/themes/images/favicon.gif |
<?php bloginfo('stylesheet_url'); ?> | 样式文件链接地址 | |
<?php echo get_stylesheet_directory(); ?> | 模板文件所在目录路径 | ***/wp-content/themes/2kss |
<?php bloginfo('template_url'); ?> | 模板文件所在目录链接地址 | https://www.jiaxiangz.com/wp-content/themes/kss |
<?php bloginfo('version'); ?> | WordPress 版本 | 5.2.11 |
<?php bloginfo('url'); ?> | 网站根链接 | https://www.jiaxiangz.com |
<?php wp_title(); ?--> | 特定内容页(Post/Page)的标题 |
导航菜单
默认导航菜单 | 实例 |
<?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 the_category(’, ‘) ?> | 特定内容页(Post/Page)所属Category |
主循环
基本循环 | |
<?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(); ?> | 显示生成当前页面所需的查询数 |
与模板相关的其他 函数:
<!--?php _e(’Message’); ?--> : 输出相应信息
<!--?php wp_register(); ?--> : 显示注册链接
<!--?php wp_loginout(); ?--> : 显示登录/注销链接
<!--–next page–--> : 将当前内容分页
<!--–more–--> : 将当前内容截断,以不在主页/目录页显示全部内容
<!--?php timer_stop(1); ?--> : 网页加载时间(秒)
<!--?php echo get_num_queries(); ?--> : 网页加载查询量
常用的wordpress模板结构及页面函数调用参数
模板常用的PHP函数及命令
<?php the_tags(); ?> ; 调用文章标签
<?php get_header(); ?> : 调用Header.php
<?php get_sidebar(); ?> : 调用Sidebar.php
<?php get_footer(); ?> : 调用Footer.php
<?php the_content(); ?> : 显示内容(Post/Page)
<?php if(have_posts()) : ?> : 检查是否存在Post/Page
<?php while(have_posts()) : the_post(); ?> : 如果存在Post/Page则予以显示
<?php endwhile; ?> : While 结束
<?php endif; ?> : If 结束
<?php the_time(’字符串’) ?> : 显示时间,时间格式由“字符串”参数决定
<?php comments_popup_link(); ?> : 正文中的留言链接。如果使用 comments_popup_script() ,则留言会在新窗口中打开
<?php the_title(); ?> : 内容页(Post/Page)标题
<?php the_permalink() ?> : 内容页(Post/Page) Url
<?php the_category(’, ‘) ?> : 特定内容页(Post/Page)所属Category
<?php the_author(); ?> : 作者
<?php the_ID(); ?> : 特定内容页(Post/Page) ID
<?php edit_post_link(); ?> : 如果用户已登录并具有权限,显示编辑链接
<?php get_links_list(); ?> : 显示Blogroll中的链接
<?php comments_template(); ?> : 调用留言/回复模板
<?php wp_list_pages(); ?> : 显示Page列表
<?php wp_list_categories(); ?> : 显示Categories列表
<?php next_post_link(’ %link ‘); ?> : 下一篇文章链接
<?php previous_post_link(’%link’); ?> : 上一篇文章链接
<?php get_calendar(); ?> : 日历
<?php wp_get_archives() ?> : 显示内容存档
<?php posts_nav_link(); ?> : 导航,显示上一篇/下一篇文章链接
<?php include(TEMPLATEPATH . ‘/文件名’); ?> : 嵌入其他文件,可为定制的模板或其他类型文件
基本条件判断Tag
is_home() : 是否为主页
is_single() : 是否为内容页(Post)
is_page() : 是否为内容页(Page)
is_category() : 是否为Category/Archive页
is_tag() : 是否为Tag存档页
is_date() : 是否为指定日期存档页
is_year() : 是否为指定年份存档页
is_month() : 是否为指定月份存档页
is_day() : 是否为指定日存档页
is_time() : 是否为指定时间存档页
is_archive() : 是否为存档页
is_search() : 是否为搜索结果页
is_404() : 是否为 “HTTP 404: Not Found” 错误页
is_paged() : 主页/Category/Archive页是否以多页显示
Header部分常用到的PHP函数
<?php bloginfo(’name’); ?> : 博客名称(Title)
<?php bloginfo(’stylesheet_url’); ?> : CSS文件路径
<?php bloginfo(’pingback_url’); ?> : PingBack Url
<?php bloginfo(’template_url’); ?> : 模板文件路径
<?php bloginfo(’version’); ?> : WordPress版本
<?php bloginfo(’atom_url’); ?> : Atom Url
<?php bloginfo(’rss2_url’); ?> : RSS 2.o Url
<?php bloginfo(’url’); ?> : 博客 Url
<?php bloginfo(’html_type’); ?> : 博客网页Html类型
<?php bloginfo(’charset’); ?> : 博客网页编码
<?php bloginfo(’description’); ?> : 博客描述
<?php wp_title(); ?> : 特定内容页(Post/Page)的标题
与模板相关的其他函数
<?php _e(’Message’); ?> : 输出相应信息
<?php wp_register(); ?> : 显示注册链接
<?php wp_loginout(); ?> : 显示登录/注销链接
<!–next page–> : 将当前内容分页
<!–more–> : 将当前内容截断,以不在主页/目录页显示全部内容
<?php timer_stop(1); ?> : 网页加载时间(秒)
<?php echo get_num_queries(); ?> : 网页加载查询量