hcard-xfn-supporting-friends-lists

From Microformats Wiki
Revision as of 16:22, 30 August 2008 by Tantek (talk | contribs) (moved should support XFN rel me from hcard-xfn-supporting-friends-lists to hcard-advocacy (add XFN rel-me when adding class="url" for the hCard))
Jump to navigation Jump to search

hCard+XFN supporting friends lists

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.

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.

  • dopplr.gif Dopplr - as announced login and go to http://www.dopplr.com/account/fellows_from_hcard to import (site is private beta)
  • 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. 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 and hCard on friends lists.

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.

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.

Implement hCard XFN supporting friends lists

Want to implement hCard+XFN on your site so you can list it here?

  1. Markup friends with hCard. See the hCard authoring page for how to mark-up names, links, icons of people in friends lists with hCard.
  2. XFN on friend links. Friends lists should be marked up with XFN per XFN clarifications: mapping community site friends. See also the XFN: Getting Started page for how to markup links to people with XFN. See also the hCard examples: hCard and XFN which demonstrates this and the previous step quite well.
  3. rel="me" to a user's other URLs. Hyperlinks to users' home pages or blogs should have the XFN rel="me" attribute to support user-driven (since the user chooses the URL to link to) identity consolidation.
  4. 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 rel="me" to that link.
  5. rel="me" on friends list pagination links. If your site paginates a user's friend list into multiple pages, be sure to add rel="me next" to your "Next" pagination hyperlinks, and similarly rel="me prev" to your "Previous" pagination hyperlinks.

Please also consider implementing 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:

  1. Provide a user interface to "Import Friends" (like a button or menu item)
  2. 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.
  3. 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.
  4. 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.
  5. Consider also providing a checkbox "[x] 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

Should support rel-me

See and please add to: hCard advocacy - XFN rel="me".

Should support friend lists

See and please add to: hCard advocacy - hCard XFN friends lists.

For more information

In addition to the previous "Implement" sections, see the hCard authoring page for how to mark-up information about a person with hCard, and XFN getting started page for how to mark-up friend links with XFN.

Join the microformats community, in particular the #microformats IRC channel on irc://irc.freenode.net#microformats and the 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.

See hCard+XFN supporting friends lists issues for issues, problems with implementations.

See also