WordPress模板文件常用内置函数简单说明

<?php bloginfo(’stylesheet_url’); ?> 显示style.css文件路径.

<?php bloginfo(’name’); ?> 显示当前Blog的标题.

<?php bloginfo(’url’); ?> 显示当前Blog的URL地址.

<?php bloginfo(’description’); ?> 显示当前Blog的描述.

<?php if(have_posts()) : ?> 是否有日志
<?php while(have_posts()) : 如果有日志,循环继续
the_post(); ?> 取出该日志
<?php the_title(); ?> 当前取出的日志的标题
<?php the_permalink(); ?> 该日志的链接地址
<?php the_content(); ?> 该日志的内容
<?php the_excerpt(); ?> 该日志的摘要
<?php the_category(’, ‘) ?> 显示当前日志所在分类列表,逗号隔开
<?php the_author(); ?> 输出当前日志作者的名字。
<?php comments_popup_link(’No Comments >’, ‘1 Comment >’, ‘% Comments >’); ?>
当弹出留言的功能激活的话,comments_popup_link() 调用一个弹出的留言窗口。
如果没有激活,comments_popup_link() 则只是简单的显示留言列表。
No Comments > 是在没有留言的时候显示的。
1 Comment > 是用于当你刚好有1条留言时候。
% Comments >; 是用于当你有多于一条留言的时候。
比如:8 Comments >。百分号 % 用来显示数字。> 是用来显示一个双层箭头 >。
<?php edit_post_link(’Edit’, ‘ | ‘, ”); ?>
这个只有当你以管理员身份登录的的时候(以编辑者,Editor登录也可以)才可见。
edit_post_link() 只是简单为你显示一个可以用来编辑当前日志的编辑链接
这样可以让你不必去去管理界面搜寻该日志而能直接编辑。
edit_post_link() 有三个参数。
第一个是用来确定哪个词你将用在编辑链接的链接标题。
如果你使用 Edit post,那么将显示 Edit post 而不是 Edit。
第二个参数是用来显示在链接前面的字符,在这里是竖线 |,代码就是&124;。
第三个参数是用于显示在编辑链接后面的字符,在这里没有使用。
<?php the_ID(); ?> 当前日志的ID
<?php endwhile; ?> 关闭while
<?php endif; ?> 关闭if

<?php posts_nav_link(); ?> 显示分页链接
<?php posts_nav_link(’in between’,’before’,”after’); ?> 定制分页链接的显示方式
第1个参数是显示在后一页和前一页链接的中间。
第2个参数显示在前面。
第3个参数显示在后面。

<?php previous_post_link(’< %link’) ?> 前一篇日志的链接

<?php next_post_link(’ %link >’) ?> 后一篇日志的链接

<?php link_pages(’<p><strong>Pages:</strong> ‘, ‘</p>’, ‘number’); ?>
显示子页面的链接
在编辑wordpress页面时,加上<!–nextpage–>即可以让下面的内容分页
上面的语句最终显示效果: Pages: 1 2 3

_e() 以便你的主题可翻译化
如: <?php _e(’Categories’); ?> 输出字符 Categories.

<?php wp_list_cats(); ?> 调用分类链接列表
wp_list_cats(’sort_column=name&optioncount=1&hierarchical=0′); ?>
参数的说明
sort_column=name – 把分类按字符顺序排列
optioncount=1 – 显示在每个分类下面的日志数
hierarchial=0 – 不把子分类放到子列表元素中,这就解释了为什么我的 子分类 链接是列在列表中第一级。
& – 每次你增加另一个参数的时候,你需在它之前要输入 & 用来把和现有的参数区分开。如 & 在 sort_column 和 optioncount之间。

<?php wp_list_pages(); ?> 日志链接列表
<?php wp_list_pages(’title_li=<h2>Page</h2>’); ?>
定义标题 “Page” 的样式
title_li 是一个用来客户化页面链接列表的标题的参数。
<h2>Pages</h2> 是 title_li 这个参数的值
<?php wp_list_pages(’depth=3&title_li=<h2>Page</h2>’); ?>
为了限制显示列表的层数,可以增加 depth 这个参数
上面的代码定义了只显示3级别的链接

<?php wp_get_archives(’type=monthly’); ?>
按月调用存档列表链接,并把每个链接放入 <li> 和 </li> 标签中。
wp_get_archives() 为每个链接产生了列表元素(LI)标签

<?php get_links_list(); ?> 显示友情链接

<?php include(TEMPLATEPATH.’/搜索页面’); ?> 向页面添加搜索框
TEMPLATEPATH 是wp中主题文件夹的位置

<?php get_calendar(); ?> 使用日历功能

<?php wp_register(); ?> 管理链接,未登录显示注册链接

<?php wp_loginout(); ?> 登录链接,如果已登录则显示为退出

<?php wp_meta(); ?> 使用Meta功能
使用 wp_register();或wp_loginout();需要在后面加上此函数

<?php if ( function_exists(’dynamic_sidebar’) && dynamic_sidebar() ) : else : ?>
<?php _e(’不支持窗体化侧边栏’); ?> 使用Widget 插件来窗体化侧边栏
<?php endif; ?>

<?php get_header(); ?> 包含header.php文件(头部信息)

<?php get_sidebar(); ?> 包含sidebar.php文件(侧边栏)

<?php get_footer(); ?> 包含footer.php文件(脚注信息)

<?php comments_template(); ?> 包含comments.php文件(评论)

style.css中描述主题的一些信息,格式如下:
第一行显而易见就是主题的名字。
第二行是这个主题的地址,如果你的主题只是私用的而不准备发布的话,那就不用考虑它。
第三行是主题的描述。
第四行是版本号,这是非常重要的,特别是当你公开发布你主题新版本的时候。
第五和第六行分别是你的名字和主页。
范例:
Theme Name: WordPress  模板一
Theme URI: http://seo-dic.com.cn/
Description: 仅作说明 <a href=”http://seo-dic.com.cn/achives/” mce_href=”http://seo-dic.com.cn/achives/”>这里是模板所在的地址</a>.
Version: 2.00  这里是版本信息
Author: 这里填的是作者名称
Author URI: http://seo-dic.com.cn/

wordpress主题中的模板文件的内容格式:
1. archive.php 和 search.php 模板文件是相同的。
2.Pages (和日志不同)是没有分类的,他们同样没有后一页和前一页的链接。有的只是上一篇日志和下一篇日志
3.Single.php 不会显示留言链接(被 comments_popup_link() 函数调用)并且他不用 posts_nav_link() 去调用导航链接。