怎么用代码制作WordPress的归档页面
先看看效果，这个是我网站的归档页面：http://www.shenjieblog.com/archives
其实WordPress自带了一个归档的功能，但是只能显示在网页中的某一个部分，但是我想单独制作一个归档页面，因为看见很多网站都有这个，制作一个单
独的归档页面可以让访问者清晰的看到我的网站内容，可以让访问者轻松地找到自己想要的内容，我最开始在阳光盒子的网站看见了他网站的归档页面，感觉效果很
不错，于是想制作一个和他一样的效果，百度了一下，加上自己的修改和美化，弄了一下午终于做成了上图的效果，不多说，方法如下：
原创作者：zwwooooo
特点：
1. 按照年份、月份显示文章列表
2. 显示每月的文章数量（需要配合及Query）
3. 显示每篇文章的评论数
4. 使用 WordPress 原生函数实现数据调用
5. 这个存档函数会在数据库生成一个表 zww_archives_list 来做缓存，只在发表/修改文章时才更新，减少数据库查询。
6. 即使不使用第5点的数据库缓存功能也比以前的直接 SQL 语句省资源。
这两天稍微空闲点，看到博客草已人高，所以就找找以前有没有没解决的来访朋友评论提到的问题。然后想起我 2012 年写的《代码实现WordPress归档页面模板[WP原生函数篇]》，按照这篇文档折腾的朋友大部分都成功了，但是总是有部分朋友说出现文章排列不对或 者文章不全什么的，因为觉得大部分朋友都能成功，所以就一直没去分析。
今天分析了一下，应该是有些月份如果 0 篇文章就会出现问题，这是判断代码没写好的原因，于是自己想了一下，就重写了一个。
简单说下步骤，
1. 归档函数
下面代码放到主题文件 functions.php 里面，另外注意代码里面有中文，所以要把 functions.php 文件编码改为 UTF8 无 BOM 格式
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
|
/* Archives list v2014 by zwwooooo | http://zww.me */function zww_archives_list() { if( !$output = get_option('zww_db_cache_archives_list') ){ $output = '<div id="archives"><p><a id="al_expand_collapse" href="#">全部展开/收缩</a> <em>(注: 点击月份可以展开)</em></p>'; $args = array( 'post_type' => 'post', //如果你有多个 post type，可以这样 array('post', 'product', 'news') 'posts_per_page' => -1, //全部 posts 'ignore_sticky_posts' => 1 //忽略 sticky posts ); $the_query = new WP_Query( $args ); $posts_rebuild = array(); $year = $mon = 0; while ( $the_query->have_posts() ) : $the_query->the_post(); $post_year = get_the_time('Y'); $post_mon = get_the_time('m'); $post_day = get_the_time('d'); if ($year != $post_year) $year = $post_year; if ($mon != $post_mon) $mon = $post_mon; $posts_rebuild[$year][$mon][] = '<li>'. get_the_time('d日: ') .'<a href="'. get_permalink() .'">'. get_the_title() .'</a> <em>('. get_comments_number('0', '1', '%') .')</em></li>'; endwhile; wp_reset_postdata(); foreach ($posts_rebuild as $key_y => $y) { $output .= '<h3 class="al_year">'. $key_y .' 年</h3><ul class="al_mon_list">'; //输出年份 |
PS: 因为查询度有点大，所以有加数据库缓存，只在文章发表/修改时才会更新缓存数据，所以测试时，可以特意去后台点“快速编辑”文章然后点更新就可以更新缓存数据。
2. 复制一份主题的 page.php 更名为 archives.php，然后在最顶端加入：
|
1
2
3
4
5
|
<?php/*Template Name: Archives*/?> |
在 archives.php 找到类似 ，在其下面加入如下代码
|
1
|
<?php zww_archives_list(); ?> |
然后新建页面（如叫：归档），选择模版为 Archives
3. 给主题加载 jQuery 库，没有加载的，把下面这句扔到 functions.php 里面就行了。
|
1
|
wp_enqueue_script('jquery'); |
4. jQuery 代码：
这次玩了逐个下拉/收缩效果，想着很好，但我博客感觉效果一般，因为文章太多了…如果文章不多，可以把代码里面 2 个 (s-10<1)?0:s-10 改为 s ，效果会好看点。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
|
(function ($, window) { $(function() { var $a = $('#archives'), $m = $('.al_mon', $a), $l = $('.al_post_list', $a), $l_f = $('.al_post_list:first', $a); $l.hide(); $l_f.show(); $m.css('cursor', 's-resize').on('click', function(){ $(this).next().slideToggle(400); }); var animate = function(index, status, s) { if (index > $l.length) { return; } if (status == 'up') { $l.eq(index).slideUp(s, function() { animate(index+1, status, (s-10<1)?0:s-10); }); } else { $l.eq(index).slideDown(s, function() { animate(index+1, status, (s-10<1)?0:s-10); }); } }; $('#al_expand_collapse').on('click', function(e){ e.preventDefault(); if ( $(this).data('s') ) { $(this).data('s', ''); animate(0, 'up', 100); } else { $(this).data('s', 1); animate(0, 'down', 100); } }); });})(jQuery, window); |
PS：不知道怎么写 js 文件然后调用的朋友就直接打开 header.php 并找到 ，在其下面加上
|
1
|
<script type="text/javascript">上面那段 jQuery 代码</script> |
因为是放在主题的 the_content() 下面，所以会默认使用主题写好的 h3 ul li 格式，如果要更加有特色，那么就要自己去修改 css 了
4. css根据需要写，不写也可以的。HTML结构：
|
1
2
3
4
5
6
7
8
9
10
11
|
<div id="archives"> <p>[<a id="al_expand_collapse" href="#">全部展开/收缩</a>] <em>(注: 点击月份可以展开)</em></p> <h3 class="al_year">'年份</h3> <ul class="al_mon_list"> <li><span class="al_mon">月份<em> (本月文章数量)</em></span> <ul class="al_post_list"> <li>号数: <a href="文章链接">文章标题</a> <em>(评论数量)</em></li> </ul> </li> </ul> </div> |
上面是原文，现在我来说说我的总结补充和修改：
1.首先说说上面有些不详细的步骤：
（1）：第二步：原文说的复制page.php更名为 archives.php意
思就是先进入cpanel面板里面把page.php这个页面先下载下来（路径一般是public_html/wp-content/themes/【你
主题的名字】这个目录中），然后重命名为archives.php，然后不要修改直接上传到cpanel面板和page.php页面相同的目录中，（之所
以说不要修改直接上传到cpanel面板中再修改是因为涉及到UTF-8的编码问题，为了避免出错就上传后再修改），然后按照原文所说的修改。
（2）：第二步：原文说的新建页面（如叫：归档），选择模版为 Archives意
思就是在你上传了archives.php并修改好之后，在WordPress后台中去新建一个页面，然后在新建的时候在右边选项中选择模板为
Archives，然后内容不需要填写，可以修改一下固定链接让其好看一点，比如我的固定链接是http://www.shenjieblog.com
/archives，如图：
（3）：第四步：原文作者其实没有给出作者自己的CSS效果代码，但是我谷歌到了一篇文章中给出了原文作者的那种CSS效果，然后之后我直接把那些CSS
代码复制到了我的style.css文件最下面，但是出现了两个问题：一是归档页面最上面的“全部展开/收缩”按钮看不见了，想了好久，没想出原因，后来
打开审查元素，发现其实那个其实还在，只是因为和我的主题有一些冲突，其实说白了就是位置错位了，
于是我删除了两行代码就解决了；还有一个问题就是可能也是因为我主题的自带的ul标签效果和我现在设置的有冲突，导致我ul前面的小方块没有去掉，于是我
有手动添加了一行代码解决了。然后后来我发现字体太小了，颜色也不好看，我后来又在阳光盒子中看见他的归档页面就是我想要的效果，就是本文最上面的图片那
种效果，而且我和他使用的主题也都是一样的，所以我就想说看看他的CSS是什么样的，最开始的时候我不知道怎么查看他的那个CSS，我不可能通过审查元素
看，所以后来我想到了一个方法，直接把他的style.css文件下载下来，怎么下载呢？直接查看源代码，他的源代码很乱，
没关系。我把他的代码全部复制然后粘贴到Editplus中，你也可以用记事本，然后快捷键是ctrl+F，查找，输入css然后查找，直到找到下面这
种字样就代表这个是他使用的css样式（一般都在最上面，很好找的），注意有时候不止一个，然后知道这个的大体位置之后就在源代码中去查找，找到之后右
键，然后复制下载链接，复制到迅雷中去下载就可以把他的CSS文件下载下来，如果你像我一样使用Editplus的话可以直接在Editplus中右键，
然后复制下载链接，
这个就是我下载下来的文件，
可以用记事本打开然后根据我上面写的那个HTML结构查找相应的代码，快捷键是ctrl+F，也就是输入archives然后查找，
找到之后复制那些代码到自己后台的style.css文件的最后就可以了，然后可以根据自己的想法修改。
然后我现在我贴出我修改的代码，修改的部分会有注释，然后你们如果要用的话也可以自己修改一下
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
|
#archives { position: relative; /*top: -60px; left: 150px;*//*原文这两行代码就是影响我最上面“全部展开/收缩”效果的，我删除了这个*/}#archives h3 { margin-bottom: 0; padding: 0 15px; border-bottom: 1px solid #ddd; font-size: 20px;/*这个字体大小和下面的我都做了一些修改*/ font-weight: 400; text-align: center; letter-spacing: 5px}#archives ul { list-style: none; margin: 0 30px; padding: 10px 0 20px 10px; border-left: 1px solid #ddd; font-size: 18px}#archives li { list-style: none;/*这一行代码是我自己添加的，不加这个就会出现ul标签前面的黑色小方块，很难看*/ position: relative; line-height: 30px}#archives ul ul { margin: -15px 0 0 0; padding: 15px 0 10px 0}#archives ul ul li { padding: 0 0 0 15px}#archives ul ul li:before { content: ""; position: absolute; left: 0; top: 10px; border-top: 5px dashed transparent; border-bottom: 5px dashed transparent; border-left: 10px solid #ddd}#al_expand_collapse { display: inline-block; line-height: 24px; padding: 0 10px; color: #fff; font-size: 12px; text-decoration: none; background: linear-gradient(to bottom, #4caf50 20%, #388e3c 80%) repeat scroll 0 0 transparent;/*这个颜色和下面的我都做了一些修改*/ background: -webkit-linear-gradient(to bottom, #4caf50 20%, #388e3c 80%) repeat scroll 0 0 transparent}#al_expand_collapse:hover { background: linear-gradient(to bottom, #388e3c 20%, #4caf50 80%) repeat scroll 0 0 transparent; background: -webkit-linear-gradient(to bottom, #388e3c 20%, #4caf50 80%) repeat scroll 0 0 transparent}#archives em { padding-left: 5px; font-size: 12px; color: #777}#archives .al_mon { padding-left: 5px; font-size: 14px; font-weight: 700}#archives .al_mon:after { content: ""; position: absolute; left: -10px; top: 15px; width: 10px; height: 1px; background: #ddd}#archives .al_mon em { font-size: 12px; font-weight: 400} |
把上面这些代码复制到自己WordPress外观——菜单——编辑——style.css文件的最底部即可。然后刷新一下就可以了。
PS:注意如果刷新之后没有效果的话可能是因为浏览器的缓存，关闭浏览器之后清除一下缓存再试就可以了，因为我遇到了这个问题，所以提醒一下大家。
原文网址：http://zww.me/wordpress-archive-page-template-wp-primary-function-2014-edition.z-turn
CSS代码参考网址：http://www.erro.cn/archives/3856.html
