Initial commit

2026-03-07 11:19:25 +08:00
commit e75f275ef4
4484 changed files with 645480 additions and 0 deletions
--- a/GravatarCache/GravatarCache.php
+++ b/GravatarCache/GravatarCache.php
@@ -0,0 +1,219 @@
+<?php
+/**
+ * Gravatar 头像缓存插件
+ *
+ * @package GravatarCache
+ * @author Byends
+ * @version 2.0.2
+ * @link http://www.byends.com
+ */
+class GravatarCache implements Typecho_Plugin_Interface
+{
+    /**
+     * 激活插件方法,如果激活失败,直接抛出异常
+     *
+     * @access public
+     * @return void
+     * @throws Typecho_Plugin_Exception
+     */
+    public static function activate()
+    {
+        Typecho_Plugin::factory('Widget_Abstract_Comments')->gravatar = array('GravatarCache', 'getGravatar');
+    }
+
+    /**
+     * 禁用插件方法,如果禁用失败,直接抛出异常
+     *
+     * @static
+     * @access public
+     * @return void
+     * @throws Typecho_Plugin_Exception
+     */
+    public static function deactivate()
+    {
+        self::deleteFile();
+    }
+
+    /**
+     * 获取插件配置面板
+     *
+     * @access public
+     * @param Typecho_Widget_Helper_Form $form 配置面板
+     * @return void
+     */
+    public static function config(Typecho_Widget_Helper_Form $form)
+    {
+        $timeCache = new Typecho_Widget_Helper_Form_Element_Text('timeCache', NULL, '1209600', _t('缓存时间'),_t('缓存时间，默认 14天 = 1209600 秒'));
+        $timeCache->input->setAttribute('class', 'mini');
+        $form->addInput($timeCache->addRule('required', _t('必须填写缓存时间'))->addRule('isInteger', _t('缓存时间必须是整数')));
+
+        $dir = new Typecho_Widget_Helper_Form_Element_Text('dir', null, '/usr/uploads/avatarCache/', _t('存放路径'), _t('缓存头像存放的路径，请确保第一个目录可写！'));
+        $form->addInput($dir->addRule('required', _t('必须填写缓存目录')));
+
+        $delCache= new Typecho_Widget_Helper_Form_Element_Radio( 'delCache', array( 'delY' => '是', 'delN' => '否' ), 'delY', '删除缓存',_t('禁用插件时是否删除缓存头像和目录') );
+        $form->addInput($delCache);
+
+        return _t('请到插件配置里设置相应选项');
+    }
+
+    /**
+     * 个人用户的配置面板
+     *
+     * @access public
+     * @param Typecho_Widget_Helper_Form $form
+     * @return void
+     */
+    public static function personalConfig(Typecho_Widget_Helper_Form $form){}
+
+    /**
+     * 插件实现方法
+     *
+     * @param $size
+     * @param $rating
+     * @param $default
+     * @param $comments
+     */
+    public static function getGravatar($size, $rating, $default, $comments)
+    {
+        $imgUrl = self::getGravatarCache($comments->mail, $comments->request->isSecure(), $size, $rating, $default);
+        echo '<img class="avatar" src="'.$imgUrl.' "alt="'.$comments->author.'" width="'.$size.'" height="'.$size.'" />';
+    }
+
+    /**
+     * 外部调用方法
+     *
+     * @param $mail
+     * @param bool $isSecure
+     * @param int $size
+     * @param string $rating
+     * @param string $default
+     * @return string
+     * @throws exception
+     */
+    public static function getGravatarCache($mail, $isSecure = false, $size = 32, $rating = 'G', $default = 'mm')
+    {
+        $option = Typecho_Widget::widget('Widget_Options')->plugin('GravatarCache');
+        $siteUrl = Helper::options()->siteUrl;
+        $dir = __TYPECHO_ROOT_DIR__ . DIRECTORY_SEPARATOR;
+        $referer = "http://www.gravatar.com";
+        $path = $option->dir;
+        $path = substr($path, 0, 1) == '/' ? substr($path, 1) : $path;
+        $path = substr($path, -1, 1) != '/' ? $path.'/' : $path;
+        $file = $dir.$path.'default.jpg';
+        $default = empty($default) ? 'mm' : $default;
+        $default = $default == 'mm' ? $default : urlencode($default);
+
+        if(!self::mkdirs(dirname($file))){
+            throw new exception('GravatarCache 目录创建失败，请检查指定的根目录是否可写' );
+        }
+
+        /** 如果默认的 default.jpg不存在，则下载 gravatar 默认的头像到本地*/
+        if(!file_exists($file)){
+            $avatar = 'http://www.gravatar.com/avatar/00000000000000000000000000000000?d='.$default.'&s='.$size.'&r='.$rating;
+            if(!self::download($avatar, $referer, $file)) copy($avatar, $file);
+        }
+
+        $timeCache = $option->timeCache;
+        $defaultMail = empty($mail) ? 'default' : md5( strtolower( $mail ) );
+        $imgUrl = $siteUrl.$path.$defaultMail.'.jpg';
+        $baseFile = $dir.$path.$defaultMail.'.jpg';
+
+        if(!file_exists($baseFile) || (time() - filemtime($baseFile)) > $timeCache){
+            $host = $isSecure ? 'https://secure.gravatar.com' : 'http://www.gravatar.com';
+            $avatar = $host.'/avatar/'.$defaultMail.'?d='.$default.'&s='.$size.'&r='.$rating;
+            if(!self::download($avatar, $referer, $baseFile)) copy($avatar, $baseFile);
+            if(filesize($baseFile) == 911 && filesize($file) != 911) copy($file, $baseFile);
+        }
+        return $imgUrl;
+    }
+
+    /**
+     * 生成多级目录
+     *
+     * @param $dir
+     * @return bool
+     */
+    public static function mkdirs($dir)
+    {
+        return is_dir($dir) or (self::mkdirs(dirname($dir)) and mkdir($dir, 0777));
+    }
+
+    /**
+     * 禁用插件时同时删除缓存头像
+     *
+     * @access public
+     * @return void
+     */
+    public static function deleteFile()
+    {
+
+        $option = Typecho_Widget::widget('Widget_Options')->plugin('GravatarCache');
+        $path = __TYPECHO_ROOT_DIR__ . DIRECTORY_SEPARATOR. $option->dir;
+        if (substr($path,-1)!='/') {$path.='/';}
+        if( $option->delCache == 'delY' ){
+            foreach (glob( $path. '*.jpg') as $filename) {
+                unlink($filename);
+            }
+            $sysDir =  array( 'usr', 'uploads', 'themes', 'plugins' );
+            $dirArray = explode("/", $path);
+            array_pop($dirArray);
+            $currentDir = array_pop($dirArray);
+
+            if(!in_array( $currentDir, $sysDir)) { rmdir($path); }
+        }
+    }
+
+    /**
+     * 下载头像到本地
+     *
+     * @param $url
+     * @param $referer
+     * @param $imagePath
+     * @return bool
+     */
+    public static function download( $url, $referer, $imagePath  )
+    {
+        $fpLocal = @fopen( $imagePath, 'w' );
+        if( !$fpLocal ) {
+            return false;
+        }
+
+        if( is_callable('curl_init') ) {
+            $ch = curl_init();
+            curl_setopt( $ch, CURLOPT_URL, $url );
+            curl_setopt( $ch, CURLOPT_REFERER, $referer );
+            curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT, 10 );
+            curl_setopt( $ch, CURLOPT_FOLLOWLOCATION, 1 );
+            curl_setopt( $ch, CURLOPT_HEADER, 0 );
+            curl_setopt( $ch, CURLOPT_FILE, $fpLocal );
+            if( !curl_exec($ch) ) {
+                fclose( $fpLocal );
+                curl_close( $ch );
+                return false;
+            }
+            curl_close( $ch );
+        }else {
+            $opts = array(
+                'http' => array(
+                    'method' => "GET",
+                    'header' => "Referer: $referer\r\n"
+                )
+            );
+
+            $context = stream_context_create( $opts );
+            $fpRemote = @fopen( $url, 'r', false, $context );
+            if( !$fpRemote ) {
+                fclose( $fpLocal );
+                return false;
+            }
+
+            while( !feof( $fpRemote ) ) {
+                fwrite( $fpLocal, fread($fpRemote, 8192) );
+            }
+            fclose( $fpRemote );
+        }
+
+        fclose( $fpLocal );
+        return true;
+    }
+}
--- a/GravatarCache/README.md
+++ b/GravatarCache/README.md
@@ -0,0 +1,33 @@
+Gravatar 头像缓存插件 For Typecho
+=============
+支持curl方式下载Gravatar头像到本地，可指定目录和保存时间。
+
+### 使用说明
+- 将GravatarCache.php文件直接上传至`/usr/plugins/`目录(:warning:不需要文件夹)；
+- 登陆后台，在“控制台”下拉菜单中进入“插件管理”
+- 启用插件即可
+
+### 升级日志
+
+#### 2.0.2 at 2012-04-07
+- 修复初次激活插件，初次调用 getGravatarCache() 不会自动创建缓存文件夹的BUG
+- getGravatarCache() 增加第五个参数 $default
+  - getGravatarCache($mail, $isSecure = false, $size = 32, $rating = 'G', $default = 'mm')
+  - $mail     ->  邮件地址；
+  - $isSecure ->  是否使用 https 安全协议，默认 false；
+  - $size     ->  头像大小，这个只用于当评论头像不存在时重新获取头像时的大小，若头像已存在则无效，默认 32
+  - $rating   ->  头像等级，这个只用于当评论头像不存在时重新获取头像时的等级，若头像已存在则无效，默认 G
+  - $default  ->  默认头像 地址，默认值 为 mm（此值对应 gravatar官方比较美观的默认头像）
+- 整理简化代码，提高可读性
+
+#### 1.2.1 at 2012-04-06
+
+- 修复由于没有声明方法类型 为 静态类型 而导致插件初次使用时 出现错误警告的BUG （download 方法）
+- 删除一些无用的代码行
+
+#### 1.2.0  at 2011-04-14
+ 
+- 修复程序逻辑BUG
+- 修复域名后面多出一个斜杠的BUG
+- 优化了代码效率
+