npm install passport-photo
var photo = require("passport-photo");
var fb = require("passport-photo-facebook");
var gravatar = require("passport-photo-gravatar")
photo.use(gravatar());
photo.use(fb.id());
photo.use(fb.token());
photo.use(fb.search({access_token:"Any Valid Access Token"}));
//Default methods are never cached and must not return 404.
photo.useDefault(gravatar({default:"identicon"}));
photo({facebookid:445461, access_token:"User's Access Token",email:"user@example.com"}, function(err, avatarURL){
if(!err) require('request')(avatarURL).pipe(require('fs').createWriteStream("./avatar.jpg"));
});
Passport photo will try each strategy in turn until one of them returns a valid avatar url. It always checks to make sure urls don't return 404, so for example, the gravatar method doesn't need to handle 404's internally. This means that if you are returned a URL, it will provide a response code of 200 (after following any redirects).
A strategy just consists of a simple function which takes a user and a callback e.g.
function default(user, callback){
callback("http://www.gravatar.com/avatar/00000000000000000000000000000000?d=mm");
}
photo.use(default);
This is the list of currently implimented strategies.
- Facebook - Can retrieve using User ID, Access Token or e-mail
- Gravatar - Can retrieve using e-mail, username support would be great
Soon, you can expect caches and middleware for connect/express to be listed here.
Add another strategy to the list of strategies used in a standard flow.
@param strategy {function} function(user, callback([url]))
Provide a default strategy, you can only provide one of these.
There are 2 things which are special about default strategies
- The result of a default strategy is not cached, ever.
- passport-photo doesn't check that the default strategy returns a valid url, it could result in a 404 error for example and we won't catch that.
For this reason, we would typically use defaults for things where we just return a siluette of the user, or perhaps an identicon.
As with defaults, you can only have one cache provider. We still check the results of a cache provider to ensure they are valid urls and don't 404.
If the user is not in the cache, simply callback with no arguments.
@param cache {object} The cache service
@param cache.get {function} function(user, callback([url])) The function to attempt to retrieve an item from the cache.
@param cache.set {function} function(user, url, done()) Add an item to the cache.
- Linked In
- Webfinger
- Simple Web Discovery
- Google+
- MySpace
(The MIT License)
Copyright (c) FPF Lindesay
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.