WordPress 主题添加最新更新文章列表功能

前短时间一个网友提到的功能，一直比较忙没时间做便拖到了今天。之前也有一些其他网友提过其他的一些功能，有些可能做了，有些可能一忙便忘了，望见谅。博主本人大学时的专业与编程无关，目前也是在学习中，所以有些功能也并不能保证很好地做出来，另外最重要的一点：博客主要是为了督促自己学习而建立的，所以不希望因博客的事务影响正常的学习，并且博客主题修改的也差不多了，之后应该不会有太多主题修改的内容了。下面是此次修改的前端显示效果。

额，下面还是主要说下主题添加最新更新文章列表功能的步骤吧。代码是在 zwwooooo 博主分享的代码基础上修改的，调整了超过更新日期 1 天内的演示样式，并基于 Options Framework 做了后台的控制选项。主题修改前还是提醒大家一下，备份！备份！！备份！！！下面简单说下如何配置。

新建 module_recently_updated_posts.php 文件

[wxcaptcha]新建一个名为 module_recently_updated_posts.php 的文件，然后复制以下代码至文件中即可，注意选择 UTF-8 编码格式。将保存后的文件丢到主题文件夹下，DUX 主题丢到 modules 文件夹下即可。

<?php
/**
  *最新更新文章列表
  *蝈蝈要安静 | 一个不学无术的伪程序员
  *https://blog.quietguoguo.com
  */

$num = QGG_Options('recently_updated_posts_num');
$days = QGG_Options('recently_updated_posts_days');
function recently_updated_posts($num = 5,$days = 7) {	
   if( !$recently_updated_posts = get_option('recently_updated_posts') ) {
	    $i=0;
        $args = array(			
			'post__not_in' =>get_option('sticky_posts'),
			'post_status' => 'publish',
			'posts_per_page' => -1,
			'orderby'=> 'modified',
			);	   
        query_posts($args);
        while ( have_posts() && $i < $num ) : the_post();
            if (current_time('timestamp') - get_the_time('U') > 60*60*24*$days) {
                $i++;
				
				$t1=get_the_modified_date("Y-m-d H:i:s");
				$t2=date("Y-m-d H:i:s");
				$diff=(strtotime($t2)-strtotime($t1))/86400;
				if( $diff < 1){ 
					$color = red;
				 } else {
					$color = "";
				 }				
				
                $the_title_value = get_the_title(); 
				$recently_updated_posts.= '<li style="color:'.$color.';"><a style="color:'.$color.';" href="'.get_permalink().'" title="'.$the_title_value.'">'.$the_title_value.'</a><span style="color:'.$color.';"> 更新于：'.get_the_modified_time('Y.m.d').'</span></li>';
           }
        endwhile;
        wp_reset_query();
        if ( !empty($recently_updated_posts) ) update_option('recently_updated_posts', $recently_updated_posts);
   }
   $recently_updated_posts = ($recently_updated_posts == '') ? '<li>暂无最新更新文章</li>' : $recently_updated_posts;
   echo '<div class="posts_list_block">
            <div class="title"><h3>'.QGG_Options('recently_updated_posts_title').'</h3></div>
            <div class="posts_list_block_bg"><ul>'.$recently_updated_posts.'</ul></div>
        </div>';
}
recently_updated_posts($num,$days);

?>

代码主要用于生成最近更新的文章列表，然后将其保存在名为 recently_updated_posts 的数据库字段里，你可以在 wp_options 数据表里找到它。主要是为了减少数据库查询量而设置的。[/wxcaptcha]

functions.php 文件修改

由于上面生成的文章列表以静态的形式保存在了 wp_options 数据表里，为了我们每次发布/更新文章后都能生成新的最新更新文章列表，需要清空原有 recently_updated_posts 字段信息并生成新的信息，所以需要将以下代码丢到主题的 functions.php 文件中，以确保每次发布/更新文章时都能清空 recently_updated_posts 的字段信息。

//新发表文章/修改文章时清空 recently_updated_posts 选项
function clear_rup_cache() {
    update_option('recently_updated_posts', ''); 
}
add_action('save_post', 'clear_rup_cache');

options.php 文件修改

由于博客目前使用的主题采用的然后我们修改下主题下的 Options Framework 做的后台控制选项，所以我也基于此设置了对应的后台选项。当然其他主题直接修改 module_recently_updated_posts.php 文件中的代码以符合自己网站也是可以的。

// 首页最新更新文章列表
$options[] = array(
    'name' => __('最新更新文章', 'QGG'),
    'desc' => __('开启', 'QGG'),
    'id' => 'recently_updated_open',
    'std' => true,
    'type' => 'checkbox');

$options[] = array(
    'name' => __('最新更新文章-标题文字', 'QGG'),
    'desc' => __('显示在最新更新文章列表左上角的标题文字', 'QGG'),
    'id' => 'recently_updated_posts_title',
    'std' => __('最新更新文章', 'QGG'),
    'type' => 'text');

$options[] = array(
    'name' => __('最新更新文章-显示文章数', 'QGG'),
    'desc' => __('纯数字，最多允许多少篇最新文章显示', 'QGG'),
    'id' => 'recently_updated_posts_num',
    'std' => 5,
    'class' => 'mini',
    'type' => 'text');	
	
$options[] = array(
    'name' => __('最新更新文章-多少天外', 'QGG'),
    'desc' => __('纯数字，多少天以外的文章更新后才显示。不明白？<a href="https://blog.quietguoguo.com">点击这里</a> 进行留言。', 'QGG'),
    'id' => 'recently_updated_posts_days',
    'std' => 7,
    'class' => 'mini',
    'type' => 'text');

将以上代码丢到 options.php 文件中去即可，修改完成后应该会在主题后台看到如下选项：

控制前端显示代码

在主题的 index.php 文件中合适的位置插入如下代码，注意代码中的路径改成第一步中 module_recently_updated_posts.php 文件的实际路径。

<?php  
    if( QGG_options('recently_updated_open') ){
        include get_stylesheet_directory() . '/modules/module_recently_updated_posts.php';
    }
?>

保存后台配置选项，刷新首页应该就能看到前端显示的内容了。

CSS 样式美化

默认的样式不太好看，这里简单美化一下，CSS 不合适的大家自行调整下即可。

/* 最新更新文章列表 */
.posts_list_block{
	margin: 5px 0px;	
}
.posts_list_block_bg {
	background:#FFF;
	padding:1px 20px;
	margin:10px 0px; 
	border-radius:4px;
}
.posts_list_block_bg ul{
	padding: 20px 10px;
	list-style-position: inside !important; 
	list-style: disc;
	overflow: hidden;
	}
.posts_list_block_bg li{
	line-height: 24px;
	white-space: nowrap; 
	overflow: hidden; 
	clear: both;
	text-overflow: ellipsis;
}
.posts_list_block_bg ul>li>span{
	color: #999;
	font-size: 12px;
	line-height: 24px;
	float: right;
}

最后，为了避免复制代码导致的错误，上面所有用到的代码文后会提供下载。