【代码札记】Comment2Pushover，Typecho评论推送Pushover提醒

前几天发现一直在用的 Server 酱出了点问题，之前一直还是挺好用的，能够将网站上的评论推送到微信上进行提示，但最近不能用了，我才想起来两年前买的 Pushover 这个东西，遂魔改大佬的插件以令其能推送评论提醒到 Pushover 上。插件源文件内附。

简介展开目录

这个插件的原型是 Y!an 大佬写的 Comment2Wechat，我修改了其中向 Server 酱的 API 推送消息的部分代码，使其可以利用 Pushover 推送评论通知。此处需要声明原插件在 Github 的项目是使用 GNU General Public License v3.0 协议授权的，因此修改后的代码仍需要使用相同的协议授权，并且注明版权归属声明。但你可以自由使用这些代码。

对于修改处的说明展开目录

1. 插件的基础配置展开目录

首先要修改的就是插件的名称，显然这个插件不应当和原插件重名，其次便是随名称变动而变动的注册插件监听器（可能是叫这个名字吧，我没能找到一个官方的 Typecho 插件开发手册）的语句，以及启用插件成功时的提示消息：显然 Pushover 需要的配置和 Server 酱是不太一样的。

Pushover 需要两个参数：USER_KEY 和 API_TOKEN，前者是你一登陆 Pushover 控制台就能看见的，后者是你需要创建一个 APP，并在 APP 的设定中找到的。这两个不能够弄反，二者皆在每次推送通知时和通知内容一并发给 Pushover 的 API，由 API 判断二者是否正确。这两个参数我也对应的有关配置页面处的函数中做出了修改。

2. 插件的核心功能展开目录

对于插件推送通知的功能我修改的不多。我很高兴两个 API 使用的都是 HTTP 的 POST 请求工作的，而唯一的差别是 POST 请求的内容不一样罢了。因此我按照原来的格式，照猫画虎，实现了 Pushover 的 API 所需要的 POST 请求的构建。并且替换了请求要发送到的 URL。

3. 其他未提到的修改展开目录

其他未提到或上面没说清楚的修改，应该都是和 API 有关的地方，请先参阅 Pushover 和 / 或 Server 酱的手册。若仍存疑问，欢迎评论。

使用展开目录

完整地复制以下代码，贴进一个文件名是 Plugin.php 的文件中。在 Typecho 的插件目录下新建名为 Comment2Pushover 的目录（上述两个名字请务必区分大小写），并将此文件放置于其中。最后进入 Typecho 后台启用插件并配置好即可。

<?php
/**
 * Pushover推送评论通知，修改自Y!an的微信推送评论通知。
 * 
 * @package Comment2Pushover
 * @author 天空Blond
 * @version 1.0.0
 * @link https://skyblond.info
 */
class Comment2Pushover_Plugin implements Typecho_Plugin_Interface
{
    /**
     * 激活插件方法,如果激活失败,直接抛出异常
     * 
     * @access public
     * @return void
     * @throws Typecho_Plugin_Exception
     */
    public static function activate()
    {
    
        Typecho_Plugin::factory('Widget_Feedback')->comment = array('Comment2Pushover_Plugin', 'sc_send');
        Typecho_Plugin::factory('Widget_Feedback')->trackback = array('Comment2Pushover_Plugin', 'sc_send');
        Typecho_Plugin::factory('Widget_XmlRpc')->pingback = array('Comment2Pushover_Plugin', 'sc_send');
        
        return _t('请配置此插件的 USER_KEY 和 API_TOKEN, 以使您的Pushover推送生效');
    }
    
    /**
     * 禁用插件方法,如果禁用失败,直接抛出异常
     * 
     * @static
     * @access public
     * @return void
     * @throws Typecho_Plugin_Exception
     */
    public static function deactivate(){}
    
    /**
     * 获取插件配置面板
     * 
     * @access public
     * @param Typecho_Widget_Helper_Form $form 配置面板
     * @return void
     */
    public static function config(Typecho_Widget_Helper_Form $form)
    {
        $key = new Typecho_Widget_Helper_Form_Element_Text('user', NULL, NULL, _t('USER_KEY'), _t('USER_KEY 可以在 Pushover 账户的控制台中找到'));
        $form->addInput($key->addRule('required', _t('您必须填写一个正确的 USER_KEY')));
        
        $key2 = new Typecho_Widget_Helper_Form_Element_Text('token', NULL, NULL, _t('API_TOKEN'), _t('API_TOKEN 可以在 Pushover 的 APP 的控制台中找到'));
        $form->addInput($key2->addRule('required', _t('您必须填写一个正确的 API_TOKEN')));
    }
    
    /**
     * 个人用户的配置面板
     * 
     * @access public
     * @param Typecho_Widget_Helper_Form $form
     * @return void
     */
    public static function personalConfig(Typecho_Widget_Helper_Form $form){}

    /**
     * 微信推送
     * 
     * @access public
     * @param array $comment 评论结构
     * @param Typecho_Widget $post 被评论的文章
     * @return void
     */
    public static function sc_send($comment, $post)
    {
        $options = Typecho_Widget::widget('Widget_Options');

        $token = $options->plugin('Comment2Pushover')->token;
        $user = $options->plugin('Comment2Pushover')->user;

        $text = "有人在您的博客发表了评论";
        $desp = "".$comment['author']." 在「".$post->title."」中说到: \n\n > ".$comment['text'];

        $postdata = http_build_query(
            array(
                'token' => $token,
                'user' => $user,
                'message' => $desp,
                'title' => $text,
                'url' => $post->permalink,
                'url_title' => $post->title
                )
            );

        $opts = array('http' =>
            array(
                'method'  => 'POST',
                'header'  => 'Content-type: application/x-www-form-urlencoded',
                'content' => $postdata
                )
            );
        $context  = stream_context_create($opts);
        $result = file_get_contents('https://api.pushover.net/1/messages.json', false, $context);
        return  $comment;
    }
}

- 全文完 -