NAME

Net::Social::Mapper - utilities for dealing with internet persona

SYNOPSIS

my $mapper   = Net::Social::Mapper->new;
my $persona  = $mapper->persona('daveman692', 'livejournal');

print $persona->user;    # daveman692
print $persona->service; # livejournal
print $persona->domain;  # livejournal.com
print $persona->name;    # LiveJournal

# Print out any feeds available (if any exist)
print "Feeds : ".join(", ", @feeds);

# What type are the feed items 
print "Feeds contain : ".join(", ", $persona->types);

# These other options may or may not be available
print "Home page   : ".$persona->homepage;
print "Profile url : ".$persona->profile;
print "Full Name   : ".$persona->full_name;
print "Service id  : ".$persona->id;
print "Photo url   : ".$persona->photo;
print "FOAF  url   : ".$persona->foaf;

# If you have network access then you can query 
# who they are elsewhere on the web
my @personas = $persona->elsewhere;

# Other examples ...

my $persona  = $mapper->persona('daveman692', 'flickr');
print $persona->user;    # daveman692
print $persona->id;      # 36381329@N00

my $persona  = $mapper->persona('http://davidrecordon.com');
print $persona->user;    # http://davidrecordon.com 
print $persona->service; # website
print $persona->domain;  # davidrecordon.com

my $persona  = $mapper->persona('test@example.com');
print $persona->user;    # test@example.com
print $persona->service; # email
print $persona->id;      # test
print $person->domain;   # example.com

# Moreover Net::Social::Mapper tries to work out the service from the url so that  ...
my $persona  = $mapper->persona('http://daveman692.livejournal.com');
my $persona  = $mapper->persona('http://daveman692.livejournal.com/data/rss');
my $persona  = $mapper->persona('http://daveman692.livejournal.com/data/atom');
my $persona  = $mapper->persona('http://www.livejournal.com/userinfo.bml?user=daveman692');
# ... all return 
print $persona->user;    # daveman692
print $persona->service; # livejournal
print $persona->domain;  # livejournal.com
print $persona->name;    # LiveJournal

METHODS

new

Get a new Net::Social::Mapper object.

persona <user> [service]

Return a Net::Social::Mapper::Persona object representing the user.

Returns undef if it doesn't know anything about the service.

sitemap

The Net::Social::Mapper::SiteMap object containing everything we know about various services.

classmap [key value]

Return a hash of (lowercase) service names to classes;

Alternatively if you pass in a key, value pair then that will be added to the map.

Passing in undef as the value will delete the key.

get <url>

Get the contents of the url or undef on failure;

AUTHOR

Simon Wistow <swistow@sixapart.com>

COPYRIGHT

Copyright 2008, Six Apart Ltd.

Released under the same terms as Perl itself.