欢迎来到《真香,30天做一套wordpress主题》系列文章,我们的目标是(没有蛀牙!)建立一套全新的wordpress主题,花上30天的时间闭关修炼,如果你看到的第一篇文章不是《基础框架搭建》,建议你关注我们(数字江湖异志录),从该系列的第一篇开始阅读。

我们将尽量保持文章的循序渐进和通俗易懂,请确保自己已经掌握了那一篇文章的全部内容时才选择跳过,不然可能会错过关键的信息噢~

理论基础

这里我们假定你已经知晓了以下基础知识,这些基础知识对理解文章内容是至关重要的:

1. html/css/js基础

2. php基础

3. 如何使用wordpress

4. 如何搭建web环境

如果你已经知晓了以上基础知识,恭喜你,本系列的任何文章内容对你而言都没有什么难度。

产品设定

当我准备制作一款wordpress主题的时候,我在脑海里浮现出几个关键字,然后迫不及待地把它们写了下来,而这些将上贯穿我们整个制作过程的核心产品/技术设定:

1. 纯amp主题(极致速度体验)

2. 移动端/pc端响应式布局(flex布局)

3. pure css design(无图设计)

4. 极简&科技风格(简约但不简单)

5. 传统blog style(还是那个配方 还是那个味道)

6. seo优化(自带seo光环)

7. 无插件依赖(plugin free)

wordpress主题基础结构

我们先来看一张图了解一下wordpress主题的基础页面结构:

(图片来源:wphierarchy.com)

这张图很清晰的表达了整个wordpress主题的层级结构,看上去有点复杂,但我们其实不需要制作所有的页面,只需要关注最后的两层就可以了,我们可以看到,其实整个wordpress主题的关键文件只需要一个index.php就够了,但我们实际不会这样做,因为把所有的页面内容都写到一个文件里实在是太耦合了,所以我们关注到上一个层级,并确定了以下几个需要制作的主题页面:

1. home.php 首页

2. 404.php 404未找到页面

3. search.php 搜索页面

4. singular.php 文章页面

5. archive.php 存档页面

总共5个页面,这样看是不是还挺简单的呢?

开始搭建

我们给这款主题取名叫freegeek,找到wordpress文件夹下,按如下路径建立freegeek文件夹。

/wp-content/themes/freegeek

我们需要建立的第一个文件是style.css,这个文件主要是对主题进行描述(通过注释)。

/*theme name: freegeektext domain: freegeekversion: 1.0requires at least: 4.7requires php: 5.2.4description: some descriptiontags: blog, two-column, amp, purecssauthor: the inline-flex teamauthor uri: theme uri: license: gnu license*/

啥?为什么就是一些注释?没错,就这些就够了,至于为什么要选择从一个style.css文件里读取配置信息,这个就得去问wordpress官方团队了(我估计这应该是有历史渊源的)。

然后我们建立一个index.php文件,内容为空,作为最顶层的一级,index.php文件是必不可少的。

这样我们就可以在后台主题列表里看到我们的freegeek主题了,虽然还什么都没有。

点击主题详情,我们就能看到那些在style.css里描述的主题信息:

这里其实还需要一张主题的截图文件,我们到后期再添加。

终于可以写代码了,我们建立一个home.php文件,从amp官网文档里复制一段快速开始的代码并稍作清理:

<!doctype html><html amp lang="en"> <head> <meta charset="utf-8"> <script async src="https://cdn.ampproject.org/v0.js"></script> <title>hello, amps</title><link rel="canonical" href="https://amp.dev/documentation/guides-and-tutorials/start/create/basic_markup/"> <meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1"><style amp-boilerplate>body{-webkit-animation:-amp-start 8s steps(1,end) 0s 1 normal both;-moz-animation:-amp-start 8s steps(1,end) 0s 1 normal both;-ms-animation:-amp-start 8s steps(1,end) 0s 1 normal both;animation:-amp-start 8s steps(1,end) 0s 1 normal both}@-webkit-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-moz-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-ms-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-o-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}</style><noscript><style amp-boilerplate>body{-webkit-animation:none;-moz-animation:none;-ms-animation:none;animation:none}</style></noscript> </head> <body> <h1>welcome to the mobile web</h1> </body></html>

这样我们的首页就可以访问了:

现在我们来抽离公共html head,并使用wordpress的方法对一些基础内容进行填充:

home.php

<!doctype html><html amp <?php language_attributes(); ?>> <head> <?php get_header() ?> <style amp-custom>/* 自定义style内容 */ </style> </head> <body> </body></html>

现在页面跑不起来了,会报错,因为我们还没有建立header.php文件,wordpress自动加载这个文件会找不到。

我们来建立header.php文件:

<meta charset="utf-8"><script async src="https://cdn.ampproject.org/v0.js"></script><title><?php echo wp_get_document_title() ?></title><link rel="canonical" href="<?php echo home_url($_server['request_uri']) ?>"><meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1"><style amp-boilerplate>body{-webkit-animation:-amp-start 8s steps(1,end) 0s 1 normal both;-moz-animation:-amp-start 8s steps(1,end) 0s 1 normal both;-ms-animation:-amp-start 8s steps(1,end) 0s 1 normal both;animation:-amp-start 8s steps(1,end) 0s 1 normal both}@-webkit-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-moz-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-ms-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-o-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}</style><noscript><style amp-boilerplate>body{-webkit-animation:none;-moz-animation:none;-ms-animation:none;animation:none}</style></noscript>

这里需要关注的几个wordpress内置方法是:

1. wp_get_document_title 获取文档标题

2. language_attributes 当前语言设定,比如en-us

这样我们就完成了head的抽离,最终页面访问仍然和之前的页面保持一致。

总结和预告

今天我们实现了一个wordpress amp主题的基础框架,即便现在还处于完全不能用的状态,但我们已经迈出了重要的一步,明天我们将关注到主题自定义参数的使用,并初步搭建页面公共顶部区域。

如果你喜欢这个系列的文章,赶快关注我们吧,不要错过后续的更多干货。