欢迎来到《真香,30天做一套wordpress主题》系列文章,我们的目标是花上30天的时间闭关修炼,建立一套全新的wordpress主题,如果你看到的第一篇文章不是《基础框架搭建》,建议你关注我们(数字江湖异志录),从该系列的第一篇开始阅读。
我们将尽量保持文章的循序渐进和通俗易懂,请确保自己已经掌握了那一篇文章的全部内容时才选择跳过,不然可能会错过关键的信息噢~
这里我们假定你已经知晓了以下基础知识,这些基础知识对理解文章内容是至关重要的:
1. html/css/js基础
2. php基础
3. 如何使用wordpress
4. 如何搭建web环境
如果你已经知晓了以上基础知识,恭喜你,本系列的任何文章内容对你而言都没有什么难度。
文章详情页
今天(第11天)就是本系列文章的最后一篇了(说好的30天呢?!),网络上已经出现了很多非法转载本文的网站,希望你们能在采集后记得手动把我骂你们的这句话删除,xxxxxx,本文首发于头条号数字江湖异志录和本人博客hhacker.com,非以上渠道看到本文的读者都是看到了非法转载的文章。为什么提前结束呢,因为制作的进度的确超过了我的想像,很多东西封装好以后,复制复制就能用,实在是太赞了,废话不多说,我们开始singular.php文章详情页的主题文件制作。
还是老套路,从home.php整个复制一套过去,我们只需要关注左侧区域的文章内容就可以了。
<?php while (have_posts()) { the_post(); the_content(); } ?>
以上代码插到main-container里,直接搞定,今天我们的任务就完成了:
等等,作者你这也太敷衍了吧,好好好,我们样式也没有,标题也没显示,这样当然不行,我只是开个玩笑嘛。
我们首先要做的就是把内容区域amp化,但是一个一个去把img替换成amp-img,video替换成amp-video实在是太麻烦了,并且还有很多细节上的处理直接替换肯定是不行的,怎么办呢,还好伟大的开源世界早已有了成熟的技术方案:amp-library(),它的作用就是将传统的html转换成amp html。
正常的用法应该是composer intall安装,但是这里我们为了方便直接在把库文件放到主题文件夹里进行引用,在functions.php末尾添加:
require_once __dir__ . '/lib/vendor/autoload.php';
再次打开一个博客文章详情页,没报错就基本ok了,我们写一个公共方法html2amp来做这个转换,这样在主题文件里只需要调用就可以了:
function html2amp($html='') { $amp = new lullabotampamp(); $amp->loadhtml($html); return $amp->converttoamphtml();}
这里需要注意的是,因为amp的技术规范要求,如果你在本地加载非http资源的话,也就是如果文章内容里的音频、视频是http协议地址,会出现src内容为空的情况,这不是bug,这是特性。
如此我们的文章页就完整了amp化。
然后我们将文章标题和日期、作者等信息在内容顶部显示出来:
<div class="flex-box"> <div class="flex-box post-meta-box"> <a class="post-meta" href="<?php echo esc_url( get_author_posts_url( get_the_author_meta( 'id' ) ) ) ?>"><span class="iconfont icon-mr-postmeta"></span><?php esc_html(the_author()); ?></a> <a class="post-meta" href="<?php the_permalink() ?>"><span class="iconfont icon-mr-postmeta"></span><?php the_time( get_option( 'date_format' ) ); ?></a> <a class="post-meta" href="<?php the_permalink() ?>#comments"><span class="iconfont icon-mr-postmeta"></span><?php comments_number('0', '1', '%'); ?></a> <a class="post-meta" href="<?php the_permalink() ?>"><span class="iconfont icon-mr-postmeta"></span><?php echo (int)get_post_meta(get_the_id(), 'views', true); ?></a> <a class="post-meta" href="<?php the_permalink() ?>"><span class="iconfont icon-mr-postmeta icon-like-sp"></span><?php echo (int)get_post_meta(get_the_id(),'likes',true); ?></a> <?php if ($edit_link = get_edit_post_link(get_the_id())): ?> <a class="post-meta edit-link" href="<?php echo esc_url($edit_link);?>"><span class="iconfont icon-mr-postmeta"></span><?php _e('edit')?></a> <?php endif; ?> </div> </div>
然后我们开始一个一个把文章内容block样式化,这里我们主要处理以下几种block:
1.1 image 图片
1.2 cover 图片上盖文字
1.3 h1~h6(常用h2 h3 h4) heading文字
1.4 quotes 引用文本
1.5 paragraphs 段落文本
1.6 gallery 图集
1.7 ol/ul 有序/无序列表
1.8 文本加粗
1.9 download 文件下载
这里我们不去动wordpress生成的dom结构,加加样式就好。
image图片:
cover图片
heading 标题
quotes引用文本:
段落文本:
gallery图集:
ol / ul 有序/无序列表:
download下载:
顺便再做做移动端适配,内容区域这里我们基本上就ok了。
还记得我们在做文章列表用到了一个点赞属性吗?这个点赞功能是原wordpress里没有的,需要我们自己用postmeta属性来实现,这里我们在文章底部加上这个功能,如果不用amp的话这里直接就是ajax请求就可以了,用amp的话怎么办呢?我们直接用amp-form的action-xhr就可以了。
我们先在functions.php里写点赞的ajax功能:
// add likesfunction set_post_likes(){ $id = (int)$_post["post_id"]; if ( $_post['action'] === 'likes'){ $raters = (int)get_post_meta($id,'likes',true); if (!isset($_cookie['likes_'.$id])) { setcookie('likes_'.$id,$id,time() + 99999999,'/',$_server['http_host'],false); update_post_meta($id, 'likes', ($raters + 1)); } wp_send_json(['likes'=>get_post_meta($id,'likes',true), 'class'=>'likes-button-active likes-button']); } wp_die();}add_action('wp_ajax_nopriv_likes', 'set_post_likes');add_action('wp_ajax_likes', 'set_post_likes');
这里我们同样是利用了update_post_meta存储数据,有两个需要注意的地方,我们在代码里存了一个cookie值,防止重复点击点赞数直接被刷爆,但是这样其实也只是防君子不防小人而已。第二个地方是我们声明了两个action,wp_ajax_nopriv_开头的和wp_ajax开头的分别代表未登录和已登陆用户可用到的ajax action,这样我们在调用/wp-admin/admin-ajax.php时wordpress才能找到正确的代码位置。
<form class="likes-form" method="post" action-xhr="<?php echo follow_scheme_replace(get_site_url(null, '/wp-admin/admin-ajax.php'))?>" target="_top" on="submit-success: amp.setstate({'likes': event.response.likes,'likesclass': event.response.class})" > <input type="hidden" name="post_id" value="<?php echo get_the_id() ?>" /> <input type="hidden" name="action" value="likes" /> <button type="submit" [class]="likesclass" class="likes-button <?php if (isset($_cookie['likes_'.get_the_id()])) echo 'likes-button-active';?>" [text]="likes"> <?php echo (int)get_post_meta(get_the_id(),'likes',true); ?> </button> </form>
这里我们的amp-form使用的是action-xhr,这就和jquery里的ajax调用是一样的了,然后我们用amp-bind对数据做了绑定,这样我们的点赞按钮就能在点赞后直接显示出最新的点赞数据。这里我们要记得在header里把amp-bind的库文件加载进来。
最后加上样式之后,我们的点赞按钮就完成了(另外别忘了做移动端css适配):
接下来我们把上一篇、下一篇文章的导航链接做一下:
<nav class="post-nav"> <?php $prev_post = get_previous_post(); $next_post = get_next_post(); ?> <div class="nav-previous"> <?php if (!empty($prev_post)): ?> <a class="post-nav-link-active" title="<?php echo $prev_post->post_title;?>" href="<?php echo get_permalink($prev_post->id); ?>"><?php _e('previous post')?></a> <?php else: ?> <a><?php _e('previous post')?></a> <?php endif; ?> </div> <div class="nav-next"> <?php if (!empty($next_post)): ?> <a class="post-nav-link-active" title="<?php echo $next_post->post_title;?>" href="<?php echo get_permalink($next_post->id);?>"><?php _e('next post')?></a> <?php else: ?> <a><?php _e('next post')?></a> <?php endif; ?> </div> </nav>
这里需要注意的地方是get_previous_post和get_next_post的第一个参数,如果传入一个true的话,则上一页和下一页的指向会是同目录下的文章,默认不指定则是整个博客的文章。
接下来是增加社交分享组件,首先引入amp-social组件库:
<script async custom-element="amp-social-share" src="https://cdn.ampproject.org/v0/amp-social-share-0.1.js"></script>
然后在页面里直接添加需要的社交分享类型就可以了,简直不要太方便!
<div class="social-share"> <div class="social-share-box"> <amp-social-share class="rounded" type="email" layout="responsive" width="20" height="20"></amp-social-share> </div> <div class="social-share-box"> <amp-social-share class="rounded" type="linkedin" layout="responsive" width="20" height="20"></amp-social-share> </div> <div class="social-share-box"> <amp-social-share class="rounded" type="pinterest" layout="responsive" data-param-media="https://amp.dev/static/samples/img/amp.jpg" width="20" height="20"></amp-social-share> </div> <div class="social-share-box"> <amp-social-share class="rounded" type="tumblr" layout="responsive" width="20" height="20"></amp-social-share> </div> <div class="social-share-box"> <amp-social-share class="rounded" type="twitter" layout="responsive" width="20" height="20"></amp-social-share> </div> <div class="social-share-box"> <amp-social-share class="rounded" type="whatsapp" layout="responsive" width="20" height="20"></amp-social-share> </div> <div class="social-share-box"> <amp-social-share class="rounded" type="line" layout="responsive" width="20" height="20"></amp-social-share> </div> </div>
这里我们没设置facebook的分享,facebook是个奇葩,只有它需要一个额外的app_id参数,需要使用者自己到facebook后台生成并绑定域名,太麻烦了,把它去掉。
然后是文章标签,这个也非常简单:
<div class="post-tags"> <?php if ( get_the_tags() ) { the_tags('', '', ''); } ?> </div>
这样几句话就完事了,加上简单的css描述之后:
最后我们来做文章评论部分,这里稍微麻烦一点,首先直接在singular.php文件里输出:
<?php comments_template(); ?>
然后建立comments.php文件,也就是评论的模板主文件:
<div id="comments" class="comments content"> <?php if (post_password_required()) : ?> <p><?php _e( 'post is password protected. enter the password to view any comments.' ); ?></p> <?php else: ?> <?php if (have_comments()) : ?> <h2><?php comments_number(); ?></h2> <ul> <?php wp_list_comments();?> </ul> <?php paginate_comments_links( array( 'next_text' => '', 'prev_text' => '', ) ) ?> <?php endif; ?> <?php if ( !comments_open() && post_type_supports( get_post_type(), 'comments' ) ) : ?> <p><?php _e( 'comments are closed here.'); ?></p> <?php else: ?> <?php comment_form(); ?> <?php endif; ?> <?php endif; ?></div>
这里我们把这个容器的id定为comments,这样做是为了方便锚链接,然后我们把content样式给它,让它复用一些内容区域的样式。
还有一定要注意paginate_comments_links一定要加上,这样子评论才支持分页,同样我们不对wordpress输出的html结果做过多的改动,基本保持原样输出,加上样式就ok了。
如此,我们的评论部分就完成了。
总结和预告
本文是本系列的最后一篇,文章详情页完成后我们的整套主题就全部完成了,当然了,还有很多细节上的地方可以修正,但是总的来说我们已经完成了整套主题的开发!只用了11天,比预想的30天早了好多(吃瓜群众:让你以后还敢乱取标题!),很多地方像是css的描述因为过于冗长,所以没在文章内贴出,因为本系列文章的目的是抛砖引玉,并不是纯粹的代码展览。
接下来的系列文章,我还没有明确的主题,如果大家有什么好的建议,可以私信或评论留言,让我们以技术为出发点,探讨交流美好的事物。