prodrigestivill / gravatar
在查看电子邮件时获取头像图像(使用 Gravatar 和/或自定义 API)。
v1.6
2021-12-24 16:27 UTC
Requires
- php: >=5.2.0
- roundcube/plugin-installer: >=0.1.3
README
非官方插件,在 Gravatar 中显示个人资料图片,并支持自定义头像 API。
它被实现为 Roundcube 只读隐藏地址簿。您必须确保此插件已添加到主配置($config['plugins']
)中的最新条目。如果是这样,并且任何地址簿(LDAP、Google 等)已经为联系人提供了照片,它将首先使用其他图片,如果没有提供,则使用 Gravatar(Roundcube 将按照主配置中的顺序使用)。
在 roundcube 1.2.0 中进行了测试。
安装
安装步骤
- 通过 composer
- 运行
php composer.phar require "prodrigestivill/gravatar":"dev-master"
- 运行
- 通过 git
- 克隆仓库:
cd roundcube/plugins && git clone git@github.com:prodrigestivill/roundcube-gravatar.git gravatar
- 克隆仓库:
- 通过 tarball
- 下载并解压缩 tarball 到
roundcube/plugins
目录,并将解压缩的目录重命名为gravatar
- 下载并解压缩 tarball 到
为了预期的行为,确保它在 config/config.inc.php
中的 $config['plugins']
列表中始终是最新插件(或至少是地址簿插件)。此外,在启用或禁用插件时,请考虑清除浏览器缓存。
要按用户启用:登录到 Roundcube,并通过导航到设置页面、点击首选项、点击地址簿、启用 Gravatar 并保存来启用/禁用插件。
要配置/更改默认值
- 将
config.inc.php.dist
复制到plugins/gravatar/
目录中的config.inc.php
。 - 修改您想要更改的值,并用 '//' 注释其余内容
自定义 API
您可以在 plugins/gravatar/
目录中的 config.inc.php
文件中的 'gravatar_custom_photo_api' 下定义自定义照片 API。以下为替换示例。
- %%: 文字 '%'
- %s: 根据 'gravatar_https' 配置的 'http' 或 'https' 架构
- %e: 联系人电子邮件(使用 urlencode 进行转义)
- %m: 电子邮件的 md5 哈希值
- %a: 电子邮件的 sha1 哈希值
- %z: 配置的头像大小(以像素为单位)
- %r: 配置的评级('g'、'pg'、'r'、'x')
默认 Gravatar API 的用法是:%s://www.gravatar.com/avatar/%m?s=%z&r=%r&d=404
您可以使用本地文件,不一定是 URL。但如果您计划直接用于文件系统访问,出于安全原因,最好仅使用哈希电子邮件替换,即使所有参数都已使用 urlencode 进行转义。
示例
$config['gravatar_custom_photo_api'] = 'http://www.example.com/directory/%e.jpg?s=%z'; //OR// $config['gravatar_custom_photo_api'] = '/path/%m.jpg';