philetaylor / gravatar-bundle
FORKED!!! This bundles provides a Gravatar API various utilities to work with it in templates
Installs: 30 109
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 2
Forks: 38
Open Issues: 0
Type:symfony-bundle
Requires
- php: >=5.3.0
- symfony/framework-bundle: *
- symfony/templating: *
Requires (Dev)
Suggests
- twig/twig: For gravatar twig extension usage
Conflicts
- twig/twig: <1.12
README
Note: This is the new home for OrnicarGravatarBundle. The package name and namespace will not change. But the code will be maintained.
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.