让网站记住读者的浏览历史,让读者很方便地知道他最近阅读了你博客的哪些文章。这一举措,对于提高用户体验应该是不错的方法。那么,如何为你的WordPress站点添加这个功能?一起往下看吧!
倡萌2个多月前就在 neoease.com 看到 @MG12 的相关教程,也曾经在本地站点折腾过,还真的实现了。你可以按照 @MG12 文章历史浏览记录 这篇文章折腾。
通过代码集成文章浏览历史功能
倡萌折腾的时候是这样操作的:
1.将下面的代码另存为一个名为 view-history.js 的js文件(格式为 utf-8 无BOM)[代码来自于 @MG12]
/**
* @author: mg12 [http://www.neoease.com/]
* @update: 2013/01/09
*
* IE6/7 need a third-party JSON library to polyfill this feature. [https://github.com/douglascrockford/JSON-js/blob/master/json2.js]
*/
ViewHistory = function() {
this.config = {
limit: 10,
storageKey: 'viewHistory',
primaryKey: 'url'
};
this.cache = {
localStorage: null,
userData: null,
attr: null
};
};
ViewHistory.prototype = {
init: function(config) {
this.config = config || this.config;
var _self = this;
// define localStorage
if (!window.localStorage && (this.cache.userData = document.body) && this.cache.userData.addBehavior && this.cache.userData.addBehavior('#default#userdata')) {
this.cache.userData.load((this.cache.attr = 'localStorage'));
this.cache.localStorage = {
'getItem': function(key) {
return _self.cache.userData.getAttribute(key);
},
'setItem': function(key, value) {
_self.cache.userData.setAttribute(key, value);
_self.cache.userData.save(_self.cache.attr);
}
};
} else {
this.cache.localStorage = window.localStorage;
}
},
addHistory: function(item) {
var items = this.getHistories();
for(var i=0, len=items.length; i<len; i++) {
if(item[this.config.primaryKey] && items[i][this.config.primaryKey] && item[this.config.primaryKey] === items[i][this.config.primaryKey]) {
items.splice(i, 1);
break;
}
}
items.push(item);
if(this.config.limit > 0 && items.length > this.config.limit) {
items.splice(0, 1);
}
var json = JSON.stringify(items);
this.cache.localStorage.setItem(this.config.storageKey, json);
},
getHistories: function() {
var history = this.cache.localStorage.getItem(this.config.storageKey);
if(history) {
return JSON.parse(history);
}
return [];
}
};
/* <![CDATA[ */
//引用脚本并初始化对象
if(typeof localStorage !== 'undefined' && typeof JSON !== 'undefined') {
var viewHistory = new ViewHistory();
viewHistory.init({
limit: 5,
storageKey: 'viewHistory',
primaryKey: 'url'
});
}
/* ]]> */
/* <![CDATA[ */
// 如果 ViewHistory 的实例存在,则可以将页面信息写入。
if(viewHistory) {
var page = {
"title": document.getElementsByTagName('title')[0].innerHTML,
"url": location.href // 这是 primaryKey
// "time": new Date()
// "author": ...
// 这里可以写入更多相关内容作为浏览记录中的信息
};
viewHistory.addHistory(page);
}
/* ]]> */
/* <![CDATA[ */
var wrap = document.getElementById('view-history');
// 如果 ViewHistory 的实例存在,并且外层节点存在,则可显示历史浏览记录
if(viewHistory && wrap) {
// 获取浏览记录
var histories = viewHistory.getHistories();
// 组装列表
var list = document.createElement('ul');
if(histories && histories.length > 0) {
for(var i=histories.length-1; i>=0; i--) {
var history = histories[i];
var item = document.createElement('li');
var link = document.createElement('a');
link.href = history.url;
link.innerHTML = history.title;
item.appendChild(link);
list.appendChild(item);
}
// 插入页面特定位置
wrap.appendChild(list);
}
}
/* ]]> */
2.将 view-history.js 放到你主题下的 js 文件夹中,然后在主题的 footer.php 中使用下面的代码调用:
<script type="text/javascript" src="<?php bloginfo('template_url'); ?>/js/view-history.js"></script>
3.如果你的主题支持小工具,你可以使用 [文本]小工具,添加标题为“浏览历史”,内容为“<div id="view-history"></div>”,然后保存,如下所示:
就可以看到效果了:
如果你的主题不支持小工具,就自己在需要显示的地方添加代码,代码中只要包含 id="view-history" 就能显示出浏览历史,比如:
<h3>浏览历史</h3>
<div id="view-history"></div>
使用插件添加文章浏览历史功能
wp-recently-viewed
@露兜 同学也根据这个方法制作了一个插件 wp-recently-viewed ,如果你不善于折腾代码,直接使用插件也是不错的选择。
1.下载 wp-recently-viewed ,安装并启用;
2.进入WordPress后台 – 外观 – 小工具,找到 浏览历史,拖到右边你想要显示浏览历史的地方,填写标题并保存即可;
3.上面是通过小工具来显示浏览历史,如果你不喜欢小工具或者你的主题没有小工具功能,而且你又懂得怎么修改主题代码,可以在你想要显示浏览历史的地方,插入以下HTML代码:
<div id="recently_viewed">
<h3>您刚刚看过</h3>
</div>
这样,插件的JS代码就会自动在div内部追加浏览过的文章列表代码;当然你也可以使用其他的html框架,只要保证父级元素含有 id="recently_viewed" 就可以了,如你也可以这么写:
<li id="recently_viewed"></li>
特别说明
有很多网友的文章标题后面带有博客名称,这样可能不太好看,如果你想去除标题中的博客名称,打开:wp-recently-viewed/js/add-history.js,查找:
"title": document.getElementsByTagName('title')[0].innerHTML,
改为
"title": noname[0],
然后再查找:
var page = {
改成:
var ptitle= document.getElementsByTagName('title')[0].innerHTML;
var noname = ptitle.split(" - ");
var page = {
以上代码第2行的 – 就是你的文章标题跟博客名称的分隔符,请根据实际情况进行修改。
类似插件 – Last Viewed Posts
Last Viewed Posts 是老外写的一个插件,通过cookies保存读者的浏览历史。当然,每个读者只能看到自己的浏览历史。
参考资料:
http://www.neoease.com/recently-viewed-items/
http://www.ludou.org/wordpress-recently-viewed.html
为什么我显示的是 undefined?