月度归档： 2007 年 12 月

本文以技术手册的方式简单汇总 WordPress 模板的基本资料，希望能对朋友们有所助益。

WordPress 基本模板文件
一套完整的 WordPress 模板应至少具有如下文件：

• style.css : CSS(样式表)文件
• index.php : 主页模板
• archive.php : Archive/Category 模板
• 404.php : Not Found 错误页模板
• comments.php : 留言/回复模板
• footer.php : Footer 模板
• header.php : Header 模板
• sidebar.php : 侧栏模板
• page.php : 内容页(Page)模板
• single.php : 内容页(Post)模板
• searchform.php : 搜索表单模板
• search.php : 搜索结果模板

当然，具体到特定的某款模板，可能不止这些文件，但一般而言，这些文件是每套模板所必备的。
基本条件判断 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 函数及命令

• <?php get_header(); ?> : 调用 Header 模板
• <?php get_sidebar(); ?> : 调用 Sidebar 模板
• <?php get_footer(); ?> : 调用 Footer 模板
• <?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 手册
• <?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 . ‘/文件名’); ?> : 嵌入其他文件，可为定制的模板或其他类型文件

与模板相关的其他函数

• <?php _e(’Message’); ?> : 输出相应信息
• <?php wp_register(); ?> : 显示注册链接
• <?php wp_loginout(); ?> : 显示登录/注销链接
• <!–next page–> : 将当前内容分页
• <!–more–> : 将当前内容截断，以不在主页/目录页显示全部内容
• <?php timer_stop(1); ?> : 网页加载时间(秒)
• <?php echo get_num_queries(); ?> : 网页加载查询量

更详细的信息请参考 WordPress 官方文档。

转载原文： http://blogsdiy.org/2007-12/wordpress-template-handbook/