ornicar / gravatar-bundle
This bundles provides a Gravatar API various utilities to work with it in templates
Installs: 752 951
Dependents: 10
Suggesters: 0
Security: 0
Stars: 132
Watchers: 7
Forks: 35
Open Issues: 7
Type:symfony-bundle
Requires
- php: >=5.3.0
- symfony/framework-bundle: ~4.0|~3.0|~2.3
- symfony/templating: ~4.0|~3.0|~2.0
Requires (Dev)
- symfony/phpunit-bridge: ~2.7
- twig/extensions: 1.0.*
Suggests
- twig/twig: For gravatar twig extension usage
Conflicts
- twig/twig: <1.12
README
Deprecated
Installation
- Add this bundle to your projects composer.json
"require": { "ornicar/gravatar-bundle" : "~1.0" }
- Run composer update to install the bundle and regenerate the autoloader
$ composer update ornicar/gravatar-bundle
- Add this bundle to your application's kernel:
// application/ApplicationKernel.php public function registerBundles() { return array( // ... new Ornicar\GravatarBundle\OrnicarGravatarBundle(), // ... ); }
- Configure the
gravatar
service, templating helper and Twig extension in your config:
# application/config/config.yml ornicar_gravatar: ~
- If you always have some default for your gravatars such as size, rating or default it can be configured in your config
# application/config/config.yml ornicar_gravatar: rating: g size: 80 default: mm
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', true) ?>" />
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, secure) }}" />
For more information look at the gravatar implementation pages.