Angular.JS directive for gravatar images
npm install angular-gravatar



angular-gravatar
==============
Angular.JS directive for Gravatar.
Copyright (C) 2015, Sebastian Wallin
Requirements
-----
* AngularJS (http://angularjs.org)
Install with Bower
-----
```
bower install angular-gravatar
Install with NPM
-----
``
npm install angular-gravatar
Usage
-----
Include angular-gravatar.js in your application.
`html`
Add the module ui.gravatar as a dependency to your app:
`js`
var app = angular.module('app', ['ui.gravatar']);
Then use the directive on an image tag and it will set the correct src
attribute for you.
`html`
If the source is already an MD5 hash, it will be left untouched (thanks @thewarpaint)
#### Binding Once
If you know that the source is not going to change, you can use the gravatar-src-once instead:
`html`
> Note: this directive will watch for a non falsy value and then stop watching.
Configuration
-----
The options that are sent along to Gravatar can be set either
directly in the directive as seen above with size or configured as defaultgravatarServiceProvider
parameters via the :
`js
angular.module('ui.gravatar').config([
'gravatarServiceProvider', function(gravatarServiceProvider) {
gravatarServiceProvider.defaults = {
size : 100,
"default": 'mm' // Mystery man as default for missing avatars
};
// Use https endpoint
gravatarServiceProvider.secure = true;
// Force protocol
gravatarServiceProvider.protocol = 'my-protocol';
// Override URL generating function
gravatarServiceProvider.urlFunc = function(options) {
// Code to generate custom URL
};
}
]);
`
Note that by default, no explicit protocol is set. This means that the image will use the protocol with which the page is loaded. For example; if the page url is http://www.example.com the image will be loaded over http, but if the page url is https://www.example.com the image will be loaded over https.
Anyway, you can force the protocol you want (for https use secure = true instead of protocol = 'https' because gravatar url differs for secure/no secure).http
For example, if you are developing a mobile app with Cordova you should use . Otherwise directive will use file` protocol and fail.
All the available options can be seen over at the Gravatar docs for image
requests
License
-----
MIT
Contributors
-----
* Alexander Makarenko, @estliberitas
* Eduardo Garcia, @thewarpaint
* Thomas Vervest, @tvervest
* Gonzalo Aguirre, @gaguirre
* Gabe Hayes, @gabehayes
* Peter Dave Hello, @PeterDaveHello
* Kalisa Falzone, @KalisaFalzone
* Victor Torres, @victor-torres