wordpress主题制作教程(二):主题文件结构

开始制作WordPress主题之前,首先得了解WordPress主题到底由哪些文件构成,你得清楚WordPress程序是怎样与主题文件连接的。一般来讲一个主题至少需要包含两个文件:index.php和style.css。

细的来说,可能存在的文件有:

主页:

  1. home.php
  2. index.php(这个算是万能的了)

文章页:

  1. single-{post_type}.php – 如果文章类型是videos(即视频),WordPress就会去查找single-videos.php(WordPress 3.0及以上版本支持)
  2. single.php
  3. index.php

页面:

  1. xxx.php(文件名随便),自定义页面模板 – 在WordPress后台创建页面的时候,右侧边栏可以选择页面的自定义模板
  2. page-{slug}.php – 如果页面的缩略名是news,WordPress将会查找 page-news.php(WordPress 2.9及以上版本支持)
  3. page-{id}.php – 如果页面ID是6,WordPress将会查找page-6.php
  4. page.php
  5. index.php

分类模板:

  1. category-{slug}.php – 如果分类的缩略名为news,WordPress将会查找category-news.php(WordPress 2.9及以上版本支持)
  2. archive-{post_type}.php--如果你的主题有自定义文章类型,比如按照官方网站教程,注册了一个名为book的文章类型,那么它的归档页面模板就是category-book.php,如果没有这个文件,它是不会使用其它文件来代替的,将会直奔404
  3. taxonomy-{taxonomy_slug}.php-这是自定义分类法的分类页,比如上面你注册了一个book的文章类型,然后你注册一个分类法author,它的别名是authors,以便让文章按作者分类。那么这个作者分类页的模板文件就是taxonomy-authors.php
  4. category-{id}.php -如果分类ID为6,WordPress将会查找category-6.php
  5. category.php
  6. archive.php
  7. index.php

标签

  1. tag-{slug}.php – 如果标签缩略名为sometag,WordPress将会查找tag-sometag.php
  2. tag-{id}.php – 如果标签ID为6,WordPress将会查找tag-6.php(WordPress 2.9及以上版本支持)
  3. tag.php
  4. archive.php
  5. index.php

作者:

  1. author-{nicename}.php – 如果作者的昵称为rami,WordPress将会查找author-rami.php(WordPress 3.0及以上版本支持)
  2. author-{id}.php – 如果作者ID为6,WordPress将会查找author-6.php(WordPress 3.0及以上版本支持)
  3. author.php
  4. archive.php
  5. index.php

日期页面:

  1. date.php
  2. archive.php
  3. index.php

搜索结果:

  1. search.php
  2. index.php

404 (未找到)页面

  1. 404.php
  2. index.php

附件页面:

  1. MIME_type.php – 可以是任何MIME类型 (image.php, video.php, audio.php, application.php 或者其他).
  2. attachment.php
  3. single.php
  4. index.php

函数

  1. functions.php

评论模板

  1. comments.php

关于上面的文件层次结构

上面除了自定义文章类型,和自定义分类法需要固定的模板来显示对应内容,其它的,如果缺少对应文件,可以用其它文件代替。以主页为例,下面有2个文件home.phpindex.phpWordPress程序会从你的主题文件夹中依次查找这两个文件,如果找到home.php,则使用home.php作为博客首页模板,即使你的主题文件夹中有index.php;如果home.php未找到,则使用index.php作为首页模板;如果home.phpindex.php都找不到,你的主题将不会被WordPress识别,等于废物。

对于上面这么多文件,不一定全部备齐,需要什么模板采用到,对于复杂一点的主题,通常会有很多php函数,为了有清晰的层次结构,作者一般会将代码分装在其它的php文件中,可以在functions.php使用include_once等函数包含文件。

本篇教程之前的几篇教程是

本篇教程之后的几篇教程是

没有找到你要找的内容?你可以通过搜索你要找的内容,或者给我们留言。

已有8条评论

  1. LYNN
    LYNN : 回复

    想请教一下,WordPress的js文件是在哪个文件引入的呢

    • 阿树工作室
      阿树工作室 回复LYNN: 回复

      这个没有规定,比如如果你想在网页头部标签的前面引入js,那你可以直接把js引入代码写在header.php文件对应位置即可,你也可以通过函数来间接引入

  2. Jae
    Jae : 回复

    如果home.php和index.php都找不到,你的主题将不会被WordPress识别,等于废物

    这里不是先找front-page.php 如何这个找不到才接着在下面两个。 是不是新版本才是这样的,旧版本是按照你说的那样?

  3. nba custom jerseys
    nba custom jerseys : 回复

    Bucks Jersey

  4. wusiyu
    wusiyu : 回复

    这个教程很好!

  5. LNG加气站
    LNG加气站 : 回复

    挺好的WORDPRESS教程,讲解的很详细,正需要它,谢谢楼主分享。

    • 阿树工作室
      阿树工作室 回复LNG加气站: 回复

      本站有广告。你懂得

  6. Arch!tect
    Arch!tect : 回复

    heyheyyoyo

发表评论