README

This bundle allows you to display your avatar anywhere on your site, via the Gravatar service.

Requirements

• Symfony 6 or 7
• PHP 8.1 or higher
• A Gravatar account - it's free!

Installation

1. To install this bundle, run the following Composer command :

composer require saldanhakun/gravatar-bundle

1. If you always have some default for your gravatars such as size, rating or default it can be configured in your config :

# config/packages/pyrrah_gravatar.yaml
pyrrah_gravatar:
  rating: "g"
  size: 80
  default: "mp"

Usage

All you have to do is use the helper like this example:

<img src="<?php echo $view['gravatar']->getUrl('alias@domain.tld') ?>" />

Or with parameters:

<img src="<?php echo $view['gravatar']->getUrl('alias@domain.tld', '80', 'g', 'defaultimage.png') ?>" />

The only required parameter is the email adress. The rest have default values.

If you use twig you can use the helper like this example:

<img src="{{ gravatar('alias@domain.tld') }}" />

Or if you want to check if a gravatar email exists:

{% if gravatar_exists('alias@domain.tld') %}
  The email is an gravatar email
{% endif %}

Or with parameters:

<img src="{{ gravatar('alias@domain.tld', size, rating, default) }}" />

For more information look at the gravatar implementation pages.

Credits

• Pierre-Yves Dick
• All Contributors

License

The MIT License (MIT). Please see License File for more information.