新手如何写自己的WordPress主题

现在的WP主题满天飞，但是你有没有想过做一个自己的WP主题？这篇文章就教你从最基础，做一个WP主题

一.主题的文件结构

WordPress主题放在wp-content/themes/下，做为一个独立的文件夹存在。

文件夹的名字随意，但不要使用纯数字，否则会导致主题无法在主题列表中正常显示。

主题文件夹中包含该主题需要的所有样式文件、模板文件、函数文件、JavaScript脚本 文件、静态文件等。

一个最小的主题通常由三类文件组成：

• 样式表文件 style.css
• 函数文件functions.php（可选）
• 模板文件

注意，这些文件的名称是固定的，不能随意更改。

样式文件

style.css是一个主题的必选文件，因为其中包含了对这个主题的描述信息。一个style.css的头部信息如下：

/* Theme Name: 主题名称（必选）

Theme URI: 主题的地址，可选，格式为一个URL，如http://wordpress.org/

Description: 对主题的描述，会显示在主题列表中。

Author: 作者

Version: 版本，如1.0 Tags: 给主题加的一些标签，可选，一般是为了让用户更方便搜索到这个主题。

*/

需要注意的是，每个主题都应该有一个自己的主题名称（Theme Name），以便于在主题列表中可以区分。

函数文件

除非你建立一个纯静态的主题，否则你一定会调用到Wordpress的API。这些主题所要用到的函数就写在functions.php文件中。

你可以以Wordpress自带主题中的functions文件做为参考。

模板文件

模板文件不是一个文件，而是一类php文件。它们决定了你每个页面的最终显示效果。模板文件遵循一定的命名规则。

模板文件命名规则

index.php

主模板。如果你的主题使用自己的模板，index.php 是必须要有的。

comments.php

评论模板.

front-page.php

首页模板，仅用于开启静态首页时。

home.php

主页模板，默认的首页。如果你开启了静态首页这是展现最新的文章的模板页面。

single.php

单独页面模板。显示单独的一篇文章时被调用。对于这个以及其他的请求模板，如果模板不存在会使用 index.php。

single-.php

自定义单独页面模板。例如，single-books.php 展示自定义文章类型为books的文章. 如果文章类型未被设置则使用index.php。

page.php

页面模板，独立页面调用。

category.php

分类模板，分类页面调用。

tag.php

标签模板，标签页面调用。

taxonomy.php

术语模板，请求自定义分类法的术语时使用。

author.php

作者模板，作者页面调用。

date.php

日期/时间模板，按时间查询时使用的模板。

archive.php

存档模板，查询分类，作者或日期时使用的模板。需要注意的是，该模板将会分别被category.php， author.php， date.php所覆盖（如果存在的话）。

search.php

搜索结果模板，显示搜索结果时使用的模板。

attachment.php

附件模板，查看单个附件时使用的模板。

image.php

图片附件模板，当在wordpress中查看单个图片时将调用此模板，如果不存在此模板，则调用attachment.php 模板。

404.php

404 错误页面模板，当WordPress无法查找到匹配查询的日志或页面时，使用404.php文件。

没有特别的数量要求，你甚至可以仅仅使用一个文件index.php作为模板文件，所有 页面都会使用这个模板，多数情况下，你会有多个模板来显示不同的页面。

总结:

首先，这个主题包含下面几个文件：

• style.css
• index.php
• single.php
• header.php
• sidebar.php
• footer.php

style.css的内容上面已经提及，你只需要补充自己需要的css就可以了。

header.php, sidebar.php, footer.php分类是页面的顶部、边栏、尾部。文章采用single.php作用模板，其它页面（如主页）会采用index.php做模板。

index.php的内容为： <?php get_header(); ?> 首页和其它页面。 <?php get_sidebar(); ?> <?php get_footer(); ?> 文章页面模板

single.php为： <?php get_header(); ?> <h1><?php the_title(); ?></h1> <div><?php the_content(); ?></div> <?php get_sidebar(); ?> <?php get_footer(); ?>

这样，我们一个最简单的模板就完成了。剩下的就是你自己根据你的需要为其添加样式和内容了。另外在模板中所有你可能用到的Wordpress函数在这里都可以找到：Wordpress Function Reference。

每个Wordpress发行版中都会默认的提供了一两个模板，它们完全可以做为你写模板的参考。