hcard-implementations

hCard Implementations

This page is an informative section of the hCard specification.

The following implementations have been developed which either generate or parse hCards. If you have such an hCard implementation, feel free to add it to the top of the New Implementations section. If you have a page or site which just publishes hCards, please use hcard-examples-in-wild instead.

New Implementations

Add new implementations here for evaluation and classification into the below taxonomy of implementations.

hCard Implementations

Input (works with)	Output	Implementation	Description
vCard	HTML	vcardin.py	Converts .vcf to .html based on a kid template. Part of the <acronym title="Resource Description Framework">RDF</acronym> Calendar workspace
hCard	vCard	hCard to QR-Code	Converts a published hCard to a vCard and displays the matching QR-Code.
Verizon contacts (HTML)	hCard-enhanced input	Verizon Contact Exporter	Adds hcards to a typical HTML page of contacts from someone's Verizon online address book so that they can be exported (say, if someone wants to leave Verizon)
hCard	Validation results	hCard Validator	Finally!
?	?	Cogmap	Cogmap has a bunch of org charts marked up with hcard. Desperately needs XPN!
TripIt contacts	hCard-enhanced input	TripIt	The TripIt contact list of your connections is marked up with hCard
hCard (WordPress plugin)	Avatars (HTML)	hAvatar	Wordpress plugin displaying avatars for commenters based on their hCard
hCard	hCard	org.microformats.hCard	Java hCard parser and creator.
vCard	hCard	Mobile Online Business' vCard to hCard converter
vCard, CSV (Firefox extension)	vCard, hCard	Jam	An active address book extension for Firefox/Flock. Jam imports Vcard and various CSV formats, and can output contacts in Vcard and hCard format.
? (Firefox extension)	?	tt_address	A Firefox extension for TYPO3. Supports hCard since the latest release, v2.0.0
? (Firefox extension)	?	Operator	Lets you combine pieces of information on Web sites with applications in ways that are useful. (Firefox-plugin)
(Wordpress plugin)	hCard, vCard	Wordpress hCard Creator	I've made this simple plugin for wordpress. It adds the hCard Options submenu at Options menu, where you can create a simple hCard and put it on your blog using < ?php hcard_creator() ?> to show it. Also, it is possible to show an "export to vCard" link, which uses Brian Suda X2V. (Got send an e-mail to him regarding this)
(Bookmarklet)	highlighted hCards/hCalendars	Microformats Bookmarklet	A bookmarklet designed for IE6 and IE7, Firefox, Safari, Opera and Camino, that overlays on the current page to allow users to import individual hCards or hCalendars. Written by Remy Sharp.
(OS X)	hCards, vCards	vCardExplorer	A Mac OS X Application, that displays VCF-Files and extracts hCards from Websites written by Daniel Kagemann.
(NetNewsWire)	extracted hCards and hCalendars	Extract Microformats	A script for NetNewsWire that supports extracting hCard and hCalendar data in blog posts (via technorati service). Written by Chris Casciano
hCard	?	hKit	Is an open source PHP 5 parsing library with support for hCard.
?	?	Technorati Microformats Search	Indexes hCard, hCalendar, and hReview as announced by Tantek. list of pages with indexing Issues so they can be looked into as to why data is not being extracted suda.co.uk/contact multipack.co.uk
(Dreamweaver 8)	hCards	Dreamweaver Extension suite	From the Web Standards Project. Enables the authoring of hCards from within Dreamweaver 8.
?	hCards	Scooch	A slide show and presentation creator that generates a hCard for individual slide show authors and comment authors with a CSS button to parse and download via X2V. Also uses hReview for slide ratings and rel-tag for categories.
(Flock extension)	hCards, hCalendars, xFolk, hReviews	Flocktails	A port of Tails extension for Flock 0.5.12 that looks for hCards, hCalendar, xFolk and hReview and tosses them into a handy topbar
hCalendar, hCard, hReview, rel-tag	?	uformats	A Ruby library that can parse hCalendar, hCard, hReview and rel-tag
(Firefox extension)	hCard, hCalendar, hReview, xFolk	Tails	A Firefox Extension that will display the presence and details of microformats (hCard, hCalendar, hReview, xFolk) on a webpage. Tails Export is an extended version.
hCards(Firefox Extension)	Address Book contacts	Smartzilla	A Firefox Extension that finds hCards on web pages and lets you add them to your addressbook.
(Textpattern plugin)	hCards, other microformats	pnh_mf	A plugin for Textpattern that supports embedding hCard and other microformats in templates and blog posts. Written by Chris Casciano.
?	?	There is evidence of built-in hCard support in the Konqueror browser	Specifically, Konqueror 3.5, in KDE 3.5 (kubuntu Breezy w/ update).
?	?	There is evidence of a kwiki plugin for hCards	Update: the hCard kwiki plugin svn repository. See the documentation of the hCard kwiki plugin.
hCard (Bookmarklet)	vCard	X2V	A bookmarklet that parses hCard and produces a .vcf (vCard) stream. Note: needs to be updated as the spec is refined.
hCard (Firefox extension)	vCard	Smartzilla	By Duncan Walker. A a Firefox extension that gets hCard data from a webpage, uses Brian Suda's XSL (locally) to transform it to vcard format and opens the resulting .vcf file.
hCard (Greasemonkey script)	?	George's Greasemonkey user script	By George. A Greasemonkey user script that detects hCards and allows users to easily add them to their address book application. Relies on the X2V web service to do the conversion.
hCard (Greasemonkey script)	vCard	Greasemonkey script	By Martin Rehfeld. An update to the work of David Janes. Finds many microformat elements, including hCards, and provides a popup menu of actions. The hCard to vCard conversion is done internally within the script. This will work with FireFox 1.5+/GreaseMonkey 0.6.4+ now.
hCard (Greasemonkey)	vCard	an hCard parser Greasemonkey user script	By Mark Pilgrim. Self-contained and does not rely on the X2V web service.
hCard (PHP “extension”)	hCard access for PHP5	a-working-microformats-extension-to-simplexml	By Oliver Brown. An "extension" to SimpleXML that gives simple access to hCard information in PHP5.
☑	☒	using hCards in your blog	By Andrew D. Hume. A system (Wordpress plugin?) for using hCards in your blog to represent people leaving comments on blog posts.
?	hCard	rfc2629.xslt	Now attempts to generate hCard information (RFC2629 is an XML format for authoring RFCs and Internet Drafts, see example document)
iChat buddy list (OS X, AppleScript)	hCards	iChat buddy list to hCards	Open source AppleScript to automatically convert one's buddy list in the MacOSX iChat AIM client into a valid XHTML 1.0 Strict list of hCards.
?	?	palmagent	A collection of palmpilot and sidekick tools. It includes X2V derivatives xhtml2hcard.xsl and toICal.xsl plus some hcardTest materials.
?	?	OpenPsa 2.x	CRM application uses hCard for all person listings. The widget is reusable across Midgard CMS
URLs	URLs containing hCards	hCard finder and structured search application	By Emiliano Martínez Luque. An experimental hCard finder and structured search application that finds hCards within a given set of URLs and returns the ones that match the specified search criteria.
Address Book contacts (OS X)	CSV, TDF, Google contacts, hCards	Lustro	A free, open source Mac OS X application that exports your Address Book contacts to CSV, tab delimited, Google Contacts, and hCards (of course). It creates a single XHMTL webpage with all your contacts as hCards.

Authoring

Implementations you can use to author, create, and publish hCards.

Web-based Creators

hCard creator

Create your own hCards; also has a Dutch interface. hCard Give feedback.

Blogging and CMS tools

Textpattern plug-in

jmc_event_manager is a plugin for Textpattern that outputs locations and events in hCard (and hCalendar) formats. Written by Joel Courtney.

Wordpress Addressbook plugin

Display list of addresses from the blog owner's address book, each marked up as an hCard. Maintained by Sam Wilson.

Browser scripts and plug-ins

Browser plugins that work with existing authoring tools:

Any browser with javascript and a little bit of CSS

microformats.org hCard creator (see also Tantek's original hCard creator on tantek.com.

Desktop Authoring Tools

• ...

Search and Discovery

• Technorati Microformats Search indexes hCard, hCalendar, and hReview as announced by Tantek.
• Microformats Bookmarklet is a bookmarklet designed for Safari (works in Firefox and Camino) that overlays on the current page to allow users to import individual hCards or hCalendars. Written by Remy Sharp.

Conversion and Import

Implementations you can use to importing into an address book application, typically by converting hCard to vCard.

Web Services

These return vCard (.vcf) and other contact formats for easy importing into typical address book programs or other processing.

• www.tomota.de Online address book that allows to import, export and convert hCard into vCard, ldif, csv and plain text.

• ...

Firefox Greasemonkey Plugins

• Oomph for GreaseMonkey - Injects the Oomph javascript for Greasemonkey

Aggregators

• ...

Forms

• hCard Mapper maps hCards onto form fields (Javascript based)

Browsing

Implementations that detect, display and otherwise highlight hCards in pages.

• ...

Firefox extension

Operator - This extension is casual-user, advanced-user and developer friendly. Very customizable and unobstrusive.

Internet Explorer extension

Oomph - This Add-In to Internet Explorer will light up on pages with hCards.

Flock extension

• ...

Open Source

Open source libraries of hCard parsers and other related code for building hCard implementations. Note: it is very likely that above implementations may be duplicated in this section. That's ok.

Javascript

The hCard creator (hCard creator feedback) is a very simple, yet illustrative, open source user interface / form / script which creates an hCard in real-time as you type in a set of contact information.

Perl

• Data::Microformat - CPAN module for both creating and parsing hCards

PHP

• hKit

Python

• gmail2hcard-py.txt - for converting Gmail CSV address book export to hCards

Ruby

• Resumy - small tool that is capable to generate Resumes marked up using the hResume Microformat standard into a W3C valid web page.

Java

• org.microformats.hCard

Objective-C

• Lustro is a free and open source Mac OS X application that exports your Address Book contacts to CSV, tab delimited, Google Contacts and hCards off course. It creates a single XHMTL webpage with all your contacts as hCards.

Additional Applications

This section should probably be incorporated into hcard-brainstorming.

There are numerous potential additional uses and applications for hCards on the Web. The following are merely a few thoughts and possibilities that folks have come up with:

• As an open standard/format for Gravatars.
  • Like this.
  • Wordpress plugin with hCard based replacement for gravatar is in the make. Alper 12:59, 8 Aug 2007 (PDT)
• Marking up individual authors of blog posts on a group blog
• Marking up people's names and URLs in a blogroll
• Any reference to people in blog posts (e.g. when citing them, or referencing them, or describing them, by name).
• ...

Related Pages

• hCard
• hCard cheatsheet - hCard properties
• hCard creator (feedback) - create your own hCard.
• hCard authoring - learn how to add hCard markup to your existing contact info.
• hCard examples - example usage of various classes within hCard.
• hCard examples in the wild - an on-going list of websites which use hCards.
• hcard-supporting-user-profiles - sites with user profiles marked up with hCard - a very common example.
• hCard FAQ - if you have any questions about hCard, check here.
• hCard implementations - websites or tools which either generate or parse hCards.
• hCard parsing - normative details of how to parse hCards.
• hCards and pages - semantic distinctions between different hCards on a page, and how to identify each
• hcard-user-interface - techniques and issues surrounding user-interfaces to author, publish, and display hCards.
• hCard profile - the XMDP profile for hCard
• hCard singular properties - an explanation of the list of singular properties in hCard.
• hCard tests - a wiki page with actual embedded hCards to try parsing.
• hCard advocacy - encourage others to use hCard
• hCard "to do" - jobs to do

The hCard specification is a work in progress. As additional aspects are discussed, understood, and written, they will be added. These thoughts, issues, and questions are kept in separate pages.

• hCard brainstorming - brainstorms and other explorations relating to hCard.
  • hcard-parsing-brainstorming - brainstorming specific to parsing of hCard
  • geo brainstorming
• hCard feedback - general feedback (as opposed to specific issues).
• hCard issues - specific issues with the specification.
• vCard errata - corrections to the vCard specification, which underlies hCard.
• vCard suggestions - suggested improvements to the vCard specification.