在查看电子邮件时获取头像图像(使用 Gravatar 和/或自定义 API)。

安装次数: 1,459

依赖: 0

建议者: 0

安全: 0

星星: 19

关注者: 7

分支: 10

公开问题: 1

类型:roundcube-plugin

v1.6 2021-12-24 16:27 UTC

This package is auto-updated.

Last update: 2024-09-09 13:04:04 UTC


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

为了预期的行为,确保它在 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';