B站来源的Typecho追番页插件

感谢原插件(WikimoeBangumi)的创作者广树，我所做的仅仅是在其基础之上进行了些许改动而已。
不想看废话的，就请直接拉到最后。

一、为什么想做这个

自打从WP转到Typecho，我就突然有了浏览独立博客的习惯。但博客内容并不是我浏览的重点所在，我更喜欢去看每位博客作者的关于页面。真的有意思。

除此之外，我很好奇每个博客的结构。比如都有哪些分类，页面都有什么元素之类的。这关注点有点儿奇怪，不是吗？

但不知是不是我的选择性记忆，我逐渐发现不少的博客都有一个追番页。你说它有什么用吗？我其实没感觉有啥用说实话…所以我也一直没怎么太注意过这种插件。直到我开始应用了看板作为我的进度及备忘工具之后，突然感觉追番页这种有条理的东西，放在那儿也挺有意思的啊。于是便简单搜了搜这类插件。自然，如果你检索过这种插件，那么仅有的两个结果你大概也就知道了：我使用的这个主题的大佬做的熊猫追番，以及WikimoeBangumi。这两个的来源都是 Bangumi 的API，而我从来都是在B站上头（不管是看还是追）的，单开一个账号我也想不起来去打理，又白消耗人家一丁点数据库空间。所以，我便尝试着把WikimoeBangumi改造，用B站的api来实现一个追番插件了。

二、现在成什么样了

每天两小时，连蒙带猜的搞了两天，已经改的差不多了。用抽风Crazy这个头油怪的账号试了一下（不，他并不认识我，之后你会明白为什么可以拿别人账号测试），83个追番加载的速度还算可以接受吧。刨去我的服务器从德国向B站请求数据->B站返回给德国->处理好后将网页发送到圣何塞->圣何塞转送给北京这种由于世界人民大团结而产生的延迟，我认为3秒加载还是可以接受的。

主要更改了哪些呢？

api：这是当然的。现在会通过B站来请求追番数据了
登录方式：大佬原本的插件是通过用户名密码，很友好的登陆的。但是B站的第三方登录需要API Key，否则需要破一道图片验证码…这太麻烦了，所以我改成了直接用cookie登录。自然，插件设置页变更成了填写UID和cookie。所以设置的时候有点儿麻烦，但恕我才疏学浅，实在想不到怎么能比较方便的实现登录了…
块显示内容：原本插件会显示中文番剧名、外文番剧名、首播日期、进度。现在更改成了中文番剧名、最后更新的剧集名、首播日期、进度。
进度条显示内容：原本是简洁的当前话数/总话数（类似10/13、5/未知），但B站的剧集数并没那么规矩，而好在B站api直接提供了一个当前观看状态的值（类似于 已看完第13话、已看完PV1、看到第2话 1:37这种），顺便为了友好化未知这种冷冰冰的词，所以更改成了观看状态(截掉了具体的观看位置)/共 num 话（类似于 已看完第13话/共 13 话、已看完PV1/未完结、看到第2话/共 12 话）
css：稍微的调整了块高度，使其在RAW主题上可以更好地显示；亦调整了图片长宽，避免变形；换成了em单位，对于不同分辨率，显示应该更好一些了？还调整了进度条，现在当番剧未完结时，进度会显示成50%了。
(201b新增)css: 块背景可选透明还是番剧封面
函数变更：整体到底是麻烦了还是简单了我也说不清，总之删掉了部分函数，更改了载入追番的逻辑（B站API默认不能直接获取到所有，但是它会返回一个追番总数。）分页获取，提供上下翻页按钮，更改了curl的方法（加入了伪装登录用的各种需要的头），自然也更改了各种变量对应的json字段，最后增加了一个函数，用于截掉详细进度信息。
(201c新增)函数：增加了下载封面到服务器的方法。现在可以完全规避b站禁止跨域导致的封面403问题了。
(2010新增)函数: 可以自定义每页展示的番剧数量以及翻页键按钮样式了。
(207新增)依赖：独立了jQuery依赖，使得不再要求主题带有jQuery库，(2010新增)并且包含在插件中，不必再担心获取js速度的问题了。
(2411新增)js：增加了插件版本检测功能。现在，每有新版本发布，在插件设置页面都将自动弹出通知引导下载。
(2411新增)函数：增加了Cookie有效性验证方法。现在当填入的Cookie过期时，插件设置页面将自动提示便于及时修改。

效果看这里

三、怎么用？

注意

你的博客根目录下不存在bangumi文件。注意是文件，文件夹是没问题的。因为封面会保存到这个文件夹内，所以如果存在同名文件夹没有关系（共用就好），但文件就不成了。

a、插件部署

下载最新的发行版，解压放到你的Typecho文件夹/usr/plugins/，并更改文件夹名为BiliBangumi，启用即可。

b、番剧页

参考WikimoeBangumi的部署方法。只不过语句要改成<?php BiliBangumi_Plugin::output(); ?>

c、插件设置

2010版本开始，设置内容从UID、cookie两项增加到了5项：UID、cookie、块背景、每页数量和自定义翻页键。

UID很好说，直接把你的BilibiliUID填入即可。此时会有两种情况：

如果你的追番信息是公开的（即别人可以从你的主页看到你追的番）：这时候你的追番页应该就可以显示出追番信息了——除了进度相关是失效的。这就是为什么我可以用头油怪的账号做实验。
如果你的追番信息是隐藏的，或者说你想要显示出追番进度，那么就需要“登录”——也就是填入cookie。

至于块背景，你可以选择使用番剧封面还是默认背景色（默认是透明的）；每页数量则定义了每一页中展示的番剧数量，默认是10。

自定义翻页键则属于比较高级的设置项。可通过编写css自定义翻页按钮的样式实现更细致的美化。这里只需使用css中属性: 变量;的语法顺次写入即可。

d、所以如何获取cookie？

在Bilibili登录你的账号（电脑网页端，推荐使用Chrome）
点击头像，进入个人主页（此时网址应该是space.bilibili.com/uid号。如果uid号后面还有一堆字符，删掉即可）
按下万能的F12，切换到Network标签
清空一下Network里边的内容，然后F5刷新
不出意外，此时在Network列表内，应该有一项是以UID为名称的条目。点击它
弹出一个预览窗格，切换到Headers标签页
在Request Headers栏目下，会有一个cookie项目。把这个的值复制下来，粘贴到插件设置页，保存
enjoy

Cookie有寿命，无法保证长期有效。因此从1.0.0.2411版本开始，插件加入了Cookie有效性检测功能。当填入的Cookie失效，插件设置页面将弹出提示，便于及时更新设置项。

e、疑难解答

Q: 封面获取逻辑

A：因为使用no-referrer总会间歇性的失效导致封面无法获取，所以从版本201c开始，封面获取逻辑改为从服务器自身获取：

第一次进入到追番列表的番剧，自动去b站下载封面到typecho文件夹/bangumi/下
之后每次访问，封面就会从上述的文件夹获取封面文件了

因为需要下载，所以在初次启用插件时，最好在设置好后自己先访问一次以完成封面下载工作。受限于服务器传输速度和追番数量，第一次访问加载的时间可能会很长，耐心等待封面下载完成即可。

想清除封面文件，只需清理typecho根目录/bangumi即可

Q：迷の版本号

A：是一个拼接出的结果：原插件版本号.更新日期年份后两位+月份。这里边我只会更新我自己的版本号部分，原插件版本号会一直保留原样，作为基于哪个版本的参照。这是我的习惯，就像我喜欢留点儿缺陷，后期刷版本号的一种执念::(滑稽)

任何问题，留在这里吧。码云的issue我可能很难想起来去看…

当前页面是本站的「Google AMP」版。查看和发表评论请点击：完整版 »

飞蚊话