WordPress模板技术手册

我们在博客平台的选择一文中之所以推荐使用WordPress来搭建博客,主要原因便在于WordPress较高的流行度,各种围绕其进行的开发、功能扩充应有尽有,基本上可以说我们在博客建设中所需的任何功能,都已有人想到并得到实现,让blogger不必在网站具体的技术实现及功能扩充方面投入过多的精力,而更专注于内容建设。

以WordPress模板为例,网上几乎随处可见,花样种类繁多,即使Blogger完全没有Html设计基础,也不妨碍建设一个漂亮的、成功的博客。不过,凡事有利便有弊,也有些朋友不愿使用这类免费的模板,不管怎么说,这类免费模板总会有其他人在使用,有时难免会给用户似曾相识的感觉,而更希望自己定制一套专用的模板以体现更多的个人特色;也有些朋友对目前正在使用的模板不太满意,希望能对其进行一定的调整或功能扩充,这就需要对WordPress模板的设计方法及常用函数有个基本了解。

本文以技术手册的方式简单汇总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官方文档

发表评论

返回顶部