WordPress 常用模板函数速查表

2023-04-15 09:57:28 浏览数 (1)

如果你是一个 WordPress 主题作者,你肯定会经常到 WordPress 的 Codex 去搜索一些常用的模板函数,每次查询的话,有点麻烦,所以为了方便查询,制作了这个 WordPress 常用模板函数速查表。

这个速查表列出你制作主题时候常用的函数,你可以直接复制到你的主题中使用,并且大部分函数都链接到了其 Codex 页面以便了解更多详细使用。

基本模板文件

文件名

描述

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

分类存档模板文件

头部函数

函数名

描述

链接

<?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'); ?>

字符集

链接

导航菜单

默认导航菜单

代码语言:javascript复制
<?php wp_nav_menu(); ?>

指定的导航菜单

代码语言:javascript复制
<?php wp_nav_menu( array('menu' => 'Project Nav' )); ?>

基于分类的导航

代码语言:javascript复制
<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>

基于页面的导航

代码语言:javascript复制
<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(); ?>

重回开头开始第二个循环

链接

主循环

代码语言:javascript复制
<?php if(have_posts()) { ?>
	<?php while(have_posts()) { the_post(); ?>
		<?php // 显示文章标题,内容缩略图等的代码?>
	<?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(); ?>

显示生成当前页面所需的查询数

链接


0 人点赞