我爱水煮鱼 » WordPress » WordPress 主题教程 #15:子模板文件

WordPress 主题教程 #15:子模板文件

子模板文件从零开始创建 WordPress 主题系列教程的第十五篇,这篇将和像上一篇创建 header.phpsidebar.phpfooter.php 这些模板文件一样创建更多的子模板文件。

现在 index.php 文件已被拆分,这一切都变得更简单。

第1步:archive.php

在做这步之前,查看你的侧边栏,点击其中的一个存档链接,结果的页面是不是和首页没有什么不同?

  • 创建一个新文件:archive.php
  • index.php 中所有东西复制到 archive.php
  • 保存 archive.php
  • archive.php 文件,把 the_content 改成 the_excerpt
  • 再次保存 archive.php 文件

通过创建一个 archive.php 文件并把它改成和 index.php 不一样,这就是定制化存档页面的外观。

现在如果你刷新你的存档页面,它将只显示摘要而不是全文的日志。

为什么你想这么做呢? — 防止 Google 以为重复内容惩罚你的博客,如果一个存档页面和首页显示相同的内容,那就是重复的内容。

如果是私人的博客呢?那么就没有必要去区分首页和存档页面。但这并不是说摘要对私人博客没有用。

同样 — 默认你的类别页面将使用 archive.php 显示内容,如果你没有 archive.php 文件,类别页面将使用 index.php 显示内容。

如果你想类别页面首页存档页面看起来不一样,那么创佳一个 category.php 文件并定制化它。

第2步:search.php

  • 创建一个新文件:search.php
  • archive.php 中所有东西复制到 search.php
  • 保存就完成了。

现在所有的,所有的搜索结果将会返回摘要。如果没有 search.php 这个模板文件,搜索选项将会使用index.php 去显示搜索结果。

(可选)你可以返回到课程1去回顾者层次结构。

第3步:page.phpsingle.php

  • 创建两个新文件:page.phpsingle.php
  • index.php 中所有内容拷贝到 page.phpsingle.php。(从现在开始,页面和单篇日志应该是一样的。)
  • 保存页面和单篇日志文件,关闭它们。

第4步:定制 page.php

还记得静态页面页面之间的不同吗?page.php 模板文件是用来定制化这些特殊静态静态页面。

第一,在 page.php 中的 <?php the_content(); ?> 下输入以下代码:

<?php link_pages(’<p><code>Pages:</strong> ‘, ‘</p>’, ‘number’); ?>

<?php edit_post_link(’Edit’, ‘<p>’, ‘</p>’); ?>

第二,从 page.php 中移除 postmetadata 代码。结果如下:

page-php.gif

第三,在 page.php 中移除 posts_nav_link() 或者导航模块。

remove-navigation.gif

刚才发生了什么

第一行代码是用于显示页面的分页链接。

nextpage.gif

举个例子,编辑 About 页面。根据我的屏幕截图增加代码:

add-nextpage.gif

当你想把一个非常长的页面分成几个页面的时候,这是非常有用的。

第二行代码是用于显示可以用来编辑静态页面的编辑链接。

通常页面是没有分类,并且通常不想给他们显示创建时间,所以需要去移除 postmetadata。同样要移除 posts_nav_link() 代码因为静态页面不会显示后一页前一页的链接。

保存 page.php 文件并关闭它。

第5步:定制 single.php

点击一个日志的标题去阅读日志其余部分就会带你到单篇日志查看模式。single.php 模板就是用于处理查看单篇日志时的外观。

single.php 中的 <?php the_content() ?> 下输入:

<?php link_pages(’<p><strong>Pages:</strong> ‘, ‘</p>’, ‘number’); ?>

是的,这是相同的用于编码页面的分页链接的代码。同样我们也可以把日志分成多篇子日志。

第二,在 postmetadata 区域,移除 <?php comments_popup_link(); ?> 函数和前面的 <br /> 标签。不要移除整个 postmetadata

移除了留言链接函数是因为在单篇日志查看模式下留言链接函数是不起作用,所以要在 singel.php 文件中移除它。只有管理员可见的编辑链接,在 BR 标签的左边。你不想跳过一行才能看到这个本来你可以在右边看到链接?这就是移除 BR 标签的原因。

第三,用以下代码取代 <?php posts_nav_link(); ?>

<?php previous_post_link(’? %link’) ?> <?php next_post_link(’ %link ?’) ?>

在前面,存档,分类和搜索页面,我们使用 posts_nav_link() 函数去调用后一页前一页的链接。对于查看单一日志的页面,它是没有后一页和前一页链接的,我们可以使用 previous_post_link()next_post_link() 函数去调用前一篇日志和后一篇日志的链接。

保存 single.php 文件,到某篇日志下查看在导航区域的不同。

课程回顾

  • 创建了四个新的文件或者或者子模板:archive.php,search.php,page.phpsingle.php
  • archive.phpsearch.php 模板文件是相同的。
  • Pages (和日志不同)是没有分类的,他们同样没有后一页前一页的链接。
  • Single.php 不会显示留言链接(被 comments_popup_link() 函数调用)并且他不用 posts_nav_link() 去调用导航链接。

原文:link

标签:

分享到:

请选择你看完该文章的感受:

不错 超赞 无聊 扯谈 不解 路过
  1. 这是倒数第二篇,本想今天把最后一篇也翻译,后来发现 small potato的网站在搬家,上不去。反正关注的人也不是很多,不如过几天再翻译,hoho。

    随便说下,这个博客主要是针对 WordPress 和我们喜欢的音乐和电影,可能会扩展下,增加一些网络工具和技巧的介绍,目前主要由我和剑指天下维护,如果有谁有愿意加入和我们说一声。

  2. 这一篇看到最头大,而且示例的图片失效了,同时<?php link_pages(’Pages: ‘, ‘’, ‘number’); ?>

    在我本机输入的时候总是报错,中间多了些空格,但删了还是不行,由于没有图片对比,不知道哪里有问题(我对php不熟),请飞猪 更新一下,麻烦了。

  3. 把代码<?php link_pages(‘pages:‘,”,’number’); ?>加入page.php之后,在WP的控制平台上编辑页面时,怎么使用它分页呀,图上说根据截图增加代码,在编辑页面时怎么增加呀,真不明白,赐教了,谢谢 :roll:

  4. 到创建archive.php的部分,在IE7中浏览归档或者分类目录时出现边栏掉到底部的现象,firefox中无此问题。仔细检查了所有代码后发现没有问题。
    后来无意中在W3C中校验XHTML文件时出现的警告让我发现了问题所在:我的源文件是以带BOM的UTF-8格式编码,而这样会在一些编辑器与旧浏览器上出现问题,IE7就是这样的问题。
    于是将编码换为UTF-8无BOM的格式,问题立马得到了解决。
    我看原文章的留言有提到遇到这个问题,这里没有,看来多数文件是以ANSI格式编码的。
    这里仅作个提醒。

  5. 在第四步里
    <?php link_pages(’Pages: ‘, ‘’, ‘number’); ?>
    里的
    应该是

  6. 教程很不错啊 一口气看完了
    只是对这篇里说的归档还不是很理解
    “存档页面只显示摘要而不是原文”是什么意思
    “所有的搜索结果将返回摘要”又是什么意思呢
    摘要跟原文有什么区别 为什么我照做了 可是存档页面貌似还是显示的日志原文呢?