README

安装

更新您的 composer.json 文件，将此包作为依赖项包含

"thomaswelton/laravel-gravatar": "~1.0"

此包支持 Laravel 5.5 中提供的 包发现 功能，因此如果您使用 Laravel 5.5，则不再需要注册以下类。

通过将其添加到 config/app.php 文件中的 providers 数组来注册 Gravatar 服务提供者。

Thomaswelton\LaravelGravatar\LaravelGravatarServiceProvider::class

通过将其添加到 config/app.php 文件中的 aliases 数组来别名化 Gravatar 门面。

'aliases' => [
     'Gravatar' => Thomaswelton\LaravelGravatar\Facades\Gravatar::class
]

配置 - 可选

通过运行以下命令将配置文件复制到您的项目中

php artisan vendor:publish --provider="Thomaswelton\LaravelGravatar\LaravelGravatarServiceProvider"

默认图像

更新配置文件以指定要使用的默认头像大小以及如果未找到 Gravatar 则返回的默认图像。

允许的默认值

• (string) <custom URL>: 您选择的图像的 URL（公开可用，带有图像扩展名且不包含查询字符串）。
• (string) 404: 如果与电子邮件散列没有关联任何图像，则不加载任何图像，而是返回 HTTP 404。
• (string) mm: (神秘人) 一个简单的人物卡通剪影轮廓（不根据电子邮件散列而变化）。
• (string) identicon: 基于电子邮件散列的几何图案。
• (string) monsterid: 生成具有不同颜色、面部等的“怪物”。
• (string) wavatar: 具有不同特征和背景的生成面孔。
• (string) retro: 精美的生成，8 位街机风格的像素化面孔。

示例图像可以在 Gravatar 网站 上查看。

内容评级

默认情况下，只显示“G”级图像。您可以在配置文件中通过编辑 'maxRating' => 'g' 全局更改此系统，允许的值是

• g: 适用于任何观众类型的所有网站。
• pg: 可能包含粗俗的手势、穿着挑逗性的人、较轻的脏话或轻微的暴力。
• r: 可能包含粗俗的脏话、严重的暴力、裸露或硬毒品使用。
• x: 可能包含成人色情图像或极其令人不安的暴力。

可以通过更改调用 Gravatar::src 或 Gravatar::image 时的 $rating 参数来更改内容评级。

用法

Gravatar::exists($email)

返回一个布尔值，表示给定的 $email 是否具有 Gravatar。

Gravatar::src($email, $size = null, $rating = null)

返回指定电子邮件地址的 Gravatar 的 https URL。可以可选地传入所需的尺寸作为整数。尺寸将包含在 1 - 512 之间，因为 Gravatar 不会返回大于 512 或小于 1 的尺寸。

<!-- Show image with default dimensions -->
<img src="{{ Gravatar::src('thomaswelton@me.com') }}">

<!-- Show image at 200px -->
<img src="{{ Gravatar::src('thomaswelton@me.com', 200) }}">

<!-- Show image at 512px scaled in HTML to 1024px -->
<img src="{{ Gravatar::src('thomaswelton@me.com', 1024) }}" width=1024>

Gravatar::image($email, $alt = null, $attributes = [], $rating = null)

返回一个 <img> 标签的 HTML。

// Show image with default dimensions
echo Gravatar::image('thomaswelton@me.com');

// Show image at 200px
echo Gravatar::image('thomaswelton@me.com', 'Some picture', ['width' => 200, 'height' => 200]);

// Show image at 512px scaled in HTML to 1024px
echo Gravatar::image('thomaswelton@me.com', 'Some picture', ['width' => 1024, 'height' => 1024]);