欢迎来到《真香,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主题的基础框架,即便现在还处于完全不能用的状态,但我们已经迈出了重要的一步,明天我们将关注到主题自定义参数的使用,并初步搭建页面公共顶部区域。
如果你喜欢这个系列的文章,赶快关注我们吧,不要错过后续的更多干货。