View source for hcard-xfn-supporting-friends-lists

<h1>hCard+XFN supporting friends lists</h1>
{{TOC-right}}

Welcome! If you have an account on any of the following services, you already have a list of your friends' hCards with your relationship to them in XFN which you can provide to other services to save time by either importing or subscribing to social network information so you can change it on one site, and have other sites automatically updated, rather than having to re-add/remove all your social network contacts multiple times every time you meet a new person, decide to unfriend someone etc.

== Services with hCard+XFN supporting friends lists ==
The following web sites support publishing hCard+XFN friends lists and are thus suitable for importing/subscribing to other sites that support hCard+XFN.  Alphabetically sorted.  Feel free to add sites with hCard+XFN supporting friends lists here. Please include a link to the site home page, and instructions for retrieving your the URL of your hCard+XFN supporting friends list on that site.

<div style="font-size:larger">
* http://identoo.com/images/icons/services/corkd.gif [http://www.corkd.com/ Cork'd] - login and copy the URL which should start with <nowiki>http://www.corkd.com/people/</nowiki>
* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - login and note that your user page has hCard and XFN for your contacts
* [http://gaia.com/ Gaia Community] - e.g. http://sphorbis.gaia.com/ - built by [http://www.zaadz.com Zaadz] 
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last FM] - login, click the "Friends" tab, and copy the URL which should look like: <nowiki>http://www.last.fm/user/[username]/friends/</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - View your contacts page <nowiki>http://ma.gnolia.com/people/[username]/contacts</nowiki> . Note [[hcard-xfn-supporting-friends-lists-issues#Magnolia|issue(s)]].
* [http://www.nsyght.com/ Nsyght] - Visit your profile page and select "view all" on the friends component. Should look like this: <nowiki>http://www.nsyght.com/friends/[username]/</nowiki>, e.g. [http://nsyght.com/users/lisa sample profile].
* [http://soup.io Soup] - On user profile if the "Friends list" element is displayed (on by default), else at <nowiki>/friends</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
</div>

== Services that import hCard+XFN supporting friends lists ==
The following web sites let you import hCard+XFN friends lists, e.g. from the above sites, and make use of both the XFN information and the hCards in the friends lists. Alphabetically sorted.  Feel free to add sites supporting hCard+XFN import here. Please include a link to the site home page, and instructions for how to import friends on the site.

=== import ===
The following sites do one time imports of friends lists.

* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - as [http://blog.dopplr.com/index.php/2007/06/23/importing-your-social-network-from-other-sites/ announced] login and go to <nowiki>http://www.dopplr.com/account/fellows_from_hcard</nowiki> to import (site is private beta)

* [http://t.heproject.com/ The Project] - Login with your OpenID and the site automatically tries to subscribe to your XFN friends list where it intersects with their userbase
** appears to fail logging in with a delegated OpenID, e.g. http://tantek.com/ - unable to verify import friends list support. [[User:Tantek|Tantek]] 10:03, 1 Feb 2008 (PST)

=== import and subscribe ===
The following sites support both importing and subscribing to friends lists.
* None currently.

=== delegation ===
The following sites support fully delegating your friends list to an external hCard+XFN friends list.
* None currently.

== Services with XFN supporting friends lists ==
These sites support XFN markup on friends lists.  It is a superset of the sites that support XFN <em>and</em> hCard on friends lists.
<div style="font-size:larger">
* [http://3eep.com/ 3eep] - each user's friends are linked to with XFN is located at <nowiki>http://3eep.com/users/[username]</nowiki>
* http://identoo.com/images/icons/services/corkd.gif [http://www.corkd.com/ Cork'd] - login and copy the URL which should start with <nowiki>http://www.corkd.com/people/</nowiki>
* [http://couchsurfing.com CouchSurfing] profiles have XFN Friendly friends lists (e.g. [http://www.couchsurfing.com/people/guaka Guaka's]).
* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - login and note that your user page has hCard and XFN for your contacts
* [http://gaia.com/ Gaia Community] - e.g. http://sphorbis.gaia.com/ - built by [http://www.zaadz.com Zaadz] 
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last FM] - login, click the "Friends" tab, and copy the URL which should look like: <nowiki>http://www.last.fm/user/[username]/friends/</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/LiveJournal.gif [http://livejournal.com LiveJournal] (see [[implementations#LiveJournal|LiveJournal]] implementation entry) - login, click on the "Profile" link, and copy the URL which should start with <nowiki>http://USERNAME.livejournal.com/profile</nowiki> where USERNAME is your LJ username. E.g. [http://daveman692.livejournal.com/profile]. LiveJournal profiles have complete friends lists marked up in XFN.
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - View your contacts page <nowiki>http://ma.gnolia.com/people/[username]/contacts</nowiki> . Note [[hcard-xfn-supporting-friends-lists-issues#Magnolia|issue(s)]].
* [http://meetlisten.com Meetlisten] - e.g. http://meetlisten.com/home/profile.php?id=1 and (e.g. [http://meetlisten.com/home/friends.php?id=6 MAKACOW-Brazil's]).
* [http://www.nsyght.com/ Nsyght] - Visit your profile page and select "view all" on the friends component. Should look like this: <nowiki>http://www.nsyght.com/friends/[username]/</nowiki>, e.g. [http://nsyght.com/users/lisa sample profile].
* http://identoo.com/images/icons/services/odeo.gif [http://odeo.com Odeo] — the "peep's" list of each user is marked up with XFN (rel="contact") e.g. http://odeo.com/profile/JeremyKeith . See [http://odeo.com/blog/2005/07/adding-microformats-to-odeo.html announcing blog post].
* http://pulse.plaxo.com/pulse/img/event_icons/Pownce.gif [http://pownce.com/ Pownce] -  login, click on the "Home" link at the top, and copy the URL.
* [http://soup.io Soup] - On user profile if the "Friends list" element is displayed (on by default), else at <nowiki>/friends</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/ (see also [http://wiki.www.videntity.org/wiki/Social_Networking_Unlimited Videntity XFN support documentation]).
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
</div>

== Services that import XFN supporting friends lists ==
The following web sites support importing your existing XFN supporting friends lists, e.g. from the above sites. Alphabetically sorted.  Feel free to add sites supporting XFN import here. Please include a link to the site home page, and instructions for how to import friends on the site.
=== import ===
The following sites do one time imports of friends lists.
* None currently.
=== import and subscribe ===
The following sites support both importing and subscribing to friends lists.
* None currently.
=== delegation ===
The following sites support fully delegating your friends list to an external XFN friends list.
* None currently.

== Services with XFN rel="me" to multiple external sites ==
The following services have a UI for entering any number of websites/homepages/blogs and publish it as part of your profile, linking to it with [[rel-me]].
<div style="font-size:larger">
* http://pulse.plaxo.com/pulse/img/event_icons/Digg.gif [http://digg.com/ Digg] - e.g. http://digg.com/users/tantek
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* http://pulse.plaxo.com/pulse/img/event_icons/plaxo.gif [http://plaxo.com/ Plaxo] - e.g. http://joseph.myplaxo.com/
* http://pulse.plaxo.com/pulse/img/event_icons/Pownce.gif [http://pownce.com/ Pownce] - login, go to your profile, and copy the URL which should start with <nowiki>http://pownce.com/</nowiki>
* http://technorati.com/tools/mozsearch/technorati.png [http://technorati.com/ Technorati] - e.g. http://technorati.com/people/technorati/tantek
* http://www.postreach.com/images/logo_typepad.gif [http://typepad.com/ TypePad] - e.g. http://www.markpasc.typepad.com/
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/
* http://openid.net/wp-content/uploads/vox.png [http://vox.com/ Vox] - e.g. http://anil.vox.com/
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
</div>

== Services with XFN rel="me" to one external site ==
The following services have a UI for entering one website/homepage/blog and publish it as part of your profile, linking to it with [[rel-me]].
<div style="font-size:larger">
* http://pulse.plaxo.com/pulse/img/event_icons/Digg.gif [http://digg.com/ Digg] - e.g. http://digg.com/users/tantek
* [http://eventful.com/ Eventful] - login, click on your username, and copy that URL.
* http://pulse.plaxo.com/pulse/img/event_icons/Flickr.gif [http://flickr.com/ Flickr] - login, click "Your Photos", click "Profile", and copy the URL which should be <nowiki>http://flickr.com/people/[username]/</nowiki>
** Flickr supports rel="me" identity consolidation with your webpage that you enter into your profile, and with your Flickr contacts page.  See [http://flickr.com/photos/factoryjoe/113866484/ screenshot of Flickr UI in Flock browser using Flocktails extension - March 17th 2006].
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* [http://jpgmag.com JPG Magazine]
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last.FM] - login, go to your profile, and copy the URL which should start with <nowiki>http://www.last.fm/user/</nowiki>
** Last.FM supports rel="me" identity consolidation with your webpage that you enter into your profile, and with your Last.FM friends page.
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - see [http://ma.gnolia.com/blog/2006/08/21/a-microadvance-in-our-microformats supports rel=me announcement].
* [http://nsyght.com Nsyght] - e.g. [http://nsyght.com/users/lisa sample profile].
* http://pulse.plaxo.com/pulse/img/event_icons/plaxo.gif [http://plaxo.com/ Plaxo] - e.g. http://joseph.myplaxo.com/
* http://pulse.plaxo.com/pulse/img/event_icons/Pownce.gif [http://pownce.com/ Pownce] - login, go to your profile, and copy the URL which should start with <nowiki>http://pownce.com/</nowiki>
** Pownce [http://pownce.com/t/notes/644806/ supports rel="me" for LOTS of other profiles].
* [http://soup.io Soup] - on user profile
* http://technorati.com/tools/mozsearch/technorati.png [http://technorati.com/ Technorati] - e.g. http://technorati.com/people/technorati/tantek
* http://www.postreach.com/images/logo_typepad.gif [http://typepad.com/ TypePad] - e.g. http://www.markpasc.typepad.com/
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/
* http://openid.net/wp-content/uploads/vox.png [http://vox.com/ Vox] - e.g. http://anil.vox.com/
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
</div>

== Implement hCard XFN supporting friends lists ==
Want to implement hCard+XFN on your site so you can list it here?  

# '''Markup friends with hCard.''' See the [[hcard-authoring|hCard authoring]] page for how to mark-up names, links, icons of people in friends lists with hCard.
# '''XFN on friend links.''' Friends lists should be marked up with XFN per [[xfn-clarifications#mapping_community_site_.22friends.22|XFN clarifications: mapping community site friends]]. See also the [http://www.gmpg.org/xfn/join XFN: Getting Started] page for how to markup links to people with XFN. See also the [[hcard-examples#hCard_and_XFN|hCard examples: hCard and XFN]] which demonstrates this and the previous step quite well.
# '''rel="me" to a user's other URLs'''. Hyperlinks to users' home pages or blogs should have the XFN <code>rel="me"</code> attribute to support user-driven (since the user chooses the URL to link to) identity consolidation.
# '''rel="me" on "View All Friends..." links'''. If a user profile page on your site links to a separate page for that user's friends list, add <code>rel="me"</code> to that link.
# '''rel="me" on friends list pagination links'''.  If your site paginates a user's friend list into multiple pages, be sure to add <code>rel="me next"</code> to your "Next" pagination hyperlinks, and similarly <code>rel="me prev"</code> to your "Previous" pagination hyperlinks.

Please also consider implementing [[hcard-supporting-user-profiles|hCard user profiles]].

== Implement import XFN friends lists ==
Want to implement importing (and preferably subscribing to) XFN friends lists on your site so you can list it here?

In addition to implementing hCard XFN supporting friends lists yourself (see above), do the following:

# '''Provide a user interface to "Import Friends"''' (like a button or menu item)
# '''When chosen, provide a text input field for the user to enter their profile URL''' (such as their blog or XFN friends list URL). If you already have the user's "Website", pre-fill the field with it, or if the user has many "Other Profiles", pre-fill the field with the first, and let the user pick any of them with a Select pop-up menu, or provide the user the option to just import XFN from all of them at once.
# '''Parse the [[XFN]] at the URL(s) given''' (links with rel="contact" or "acquaintance" or "friend" etc.) and check to see if there are any users on your site with any of those links as their rel="me" "Website" or among their rel="me" "Other Profiles" and add them to a list of people to invite. Crawl any symmetrical rel="me" links, especially symmetrical rel="me next" and/or rel="me prev" friends list pagination links for additional URLs to parse for XFN.  Consider also parsing those URLs simultaneously for hCards that have those XFN links as class="url" hCard properties, and if the hCards have additional contact information such as instant messaging or email, add them to the list of people to invite.
# '''Present the list of people to invite''', perhaps sorted by "closeness" of XFN relationships (e.g. list family relationships before just romantic relationships before just friends before just professional relationships before just acquaintances before just contacts before just met etc.) with a "Add Friend" button next to each.  When clicked, use [[XHR]] to add that person without altering the overall list, and change the Add button into a Cancel button.  Perhaps put an "Add all" button at the top (or bottom) to let the user simply add everyone listed with one click.
# '''Consider also providing a checkbox "<nowiki>[x]</nowiki> Subscribe to XFN friends"''' which would automatically run this import perhaps once a day and notify the user of new contacts found that they may want to add, and similarly present an "Add all" button.

== Sites that should support hCard and XFN ==
See [[hcard-advocacy#hCard_XFN_friends_lists|hCard advocacy - hCard XFN friends lists]].

== For more information ==
In addition to the previous "Implement" sections, see the [[hcard-authoring|hCard authoring]] page for how to mark-up information about a person with hCard, and [http://gmpg.org/xfn/join XFN getting started] page for how to mark-up friend links with XFN.

Join the [http://microformats.org/discuss microformats community], in particular the #microformats IRC channel on irc://irc.freenode.net#microformats and the [http://microformats.org/mailman/listinfo/microformats-dev/ microformats-dev mailing list], and send a message stating that you'd like to add hCard to the profiles and hCard+XFN supporting friends lists (and importing thereof) to your website.

Please also consider implementing [[hcard-supporting-user-profiles|hCard supporting user profiles]].

See [[hcard-xfn-supporting-friends-lists-issues|hCard+XFN supporting friends lists issues]] for issues, problems with implementations.

== See also ==
* [[xfn|XFN]] ([http://gmpg.org/xfn/ spec], [[xfn-faq|FAQ]], [[xfn-implementations|implementations]] - there are a few more in there that need to be copied and expanded in this page.)
* [[hcard-supporting-user-profiles]]
* [[hcard|hCard]] ([[hcard-authoring|authoring]], [[hcard-faq|FAQ]])
* [[social-network-portability]]
* [[data-portability]]
* [[user-interface]]