opening-hours-formats

2011-03-07T09:58:42Z

Smtm: wrapper for HTML code

Google places uses this format to *display* the opening hours, and then applies some javascript to hide the lines which are not immediately useful:
The translate the day names and the time formats into the users locale.

This is clearly rendered data for end user consumption and not a format one can use to establish a standard.

See an example here with opening hours: http://maps.google.com/maps/place?cid=17374953169507020841

<source lang=html4strict>
<table style="" id="oh-ov-table" class="oh-table">
<tbody>
<tr class="oh-highlight-day">
<td class="oh-day">
Montag
</td>
<td dir="ltr">
11:00-16:00
</td>
</tr>
<tr>
<td class="oh-day">
Dienstag
</td>
<td dir="ltr">
11:00-22:00
</td>
</tr>
<tr>
<td class="oh-day">
Mittwoch
</td>
<td dir="ltr">
11:00-22:00
</td>
</tr>
<tr>
<td class="oh-day">
Donnerstag
</td>
<td dir="ltr">
11:00-22:00
</td>
</tr>
<tr>
<td class="oh-day">
Freitag
</td>
<td dir="ltr">
11:00-16:00
</td>
</tr>
<tr>
<td class="oh-day">
Samstag
</td>
<td dir="ltr">
Geschlossen
</td>
</tr>
<tr>
<td class="oh-day">
Sonntag
</td>
<td dir="ltr">
Geschlossen
</td>
</tr>
</tbody>
</table>
</source>

opening-hours-formats

2011-03-07T09:53:41Z

Smtm: google places showing opening hours

Google places uses this format to *display* the opening hours, and then applies some javascript to hide the lines which are not immediately useful:
The translate the day names and the time formats into the users locale.

See: http://maps.google.com/maps/place?cid=17374953169507020841

<nowiki>
<table style="" id="oh-ov-table" class="oh-table">
<tbody>
<tr class="oh-highlight-day">
<td class="oh-day">
Montag
</td>
<td dir="ltr">
11:00-16:00
</td>
</tr>
<tr>
<td class="oh-day">
Dienstag
</td>
<td dir="ltr">
11:00-22:00
</td>
</tr>
<tr>
<td class="oh-day">
Mittwoch
</td>
<td dir="ltr">
11:00-22:00
</td>
</tr>
<tr>
<td class="oh-day">
Donnerstag
</td>
<td dir="ltr">
11:00-22:00
</td>
</tr>
<tr>
<td class="oh-day">
Freitag
</td>
<td dir="ltr">
11:00-16:00
</td>
</tr>
<tr>
<td class="oh-day">
Samstag
</td>
<td dir="ltr">
Geschlossen
</td>
</tr>
<tr>
<td class="oh-day">
Sonntag
</td>
<td dir="ltr">
Geschlossen
</td>
</tr>
</tbody>
</table>
</nowiki>

opening-hours

2011-02-17T08:10:02Z

Smtm:

proposed Format:

<nowiki><span class="operating-hours">
Tu-Sa 08:00-15:00; Sa 08:00-12:00
</span></nowiki>

see it here: http://www.geodatacheck.com/p/2

Use a semicolon to separate the different days or or time ranges.
Use two letter english day names. Times are local times with leading zero

This is the format as used in openstreetmap.org for a node description with opening hours. Openstreetmap has very rigid semantics, so it makes sense to follow their format.

opening-hours

2011-02-17T08:09:04Z

Smtm:

proposed Format:

<span class="operating-hours">
Tu-Sa 08:00-15:00; Sa 08:00-12:00
</span>

see it here: http://www.geodatacheck.com/p/2

Use a semicolon to separate the different days or or time ranges.
Use two letter english day names. Times are local times with leading zero

This is the format as used in openstreetmap.org for a node description with opening hours. Openstreetmap has very rigid semantics, so it makes sense to follow their format.

hcard-implementations

2011-02-15T09:50:45Z

Smtm: /* New Implementations */

<h1>hCard Implementations</h1>
{{TOC-right}}

This page is an '''informative''' section of the [[hcard|hCard specification]].

The following implementations have been developed which either generate or parse [[hcard|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.

Please help out by trying out these implementations and once verified move them to the grouped sections below. For now we are keeping them in grouped sections (rather than a table) because there are so many differnt kinds of implementations that it does not quite make sense to have columns that apply to all implementations. - [[User:Tantek|Tantek]]

* All .tel domains are now automatically hCard-compliant when viewed on the web (non-mobile only for now). Examples: [http://telnic.tel telnic.tel] , [http://schuh.tel schuh.tel] .
* [http://h2v.1daylater.com/ h2v.1daylater.com] A service and javascript library that very easily converts HTML snippets into their downloadable counterparts - for webdevelopers
* [http://www.w3.org/2002/12/cal/vcardin.py vcardin.py]: converts .vcf to .html based on a kid template; part of [http://www.w3.org/2002/12/cal/ the RDF Calendar workspace]
* [http://microform.at/hcard2qrcode/ hCard to QR-Code] -- Converts a published hCard to a vCard and displays the matching QR-Code.
* [http://code.google.com/p/verizon-contact-exporter/ 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)
* [http://hcard.geekhood.net/ hCard Validator] - finally!
* [http://www.cogmap.com/ Cogmap] - Cogmap has a bunch of org charts marked up with hcard. Desperately needs [[XPN]]!
* [http://www.tripit.com/ TripIt] - The TripIt contact list of your connections is marked up with hCard
* [[hAvatar]] - Wordpress plugin displaying avatars for commenters based on their hCard
* [[org.microformats.hCard]] - java hCard parser and creator.
* [http://mobileonlinebusiness.com.au/uf/vCard_to_hCard_converter.html Mobile Online Business' vCard to hCard converter]
*[http://www.jamplanet.com Jam] is an active address book extension for Firefox/Flock. Jam imports Vcard and various CSV formats, and can output contacts in Vcard and hCard format.
*The "[http://typo3.org/extensions/repository/view/tt_address/2.0.1/ tt_address]" extension for [http://www.typo3.com TYPO3] supports hCard since the latest release, v2.0.0
*[https://addons.mozilla.org/firefox/4106/ Operator] lets you combine pieces of information on Web sites with applications in ways that are useful. For instance, download hCard information to Outlook. (Firefox-plugin)
*[http://rafaeloliveira.net/labs/hcard_creator.zip 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)
*[http://leftlogic.com/lounge/articles/microformats_bookmarklet/ Microformats Bookmarklet] is 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.
*[http://domanske.de/2006/09/vcardexplorer-04/ vCardExplorer] is a Mac OS X Application, that displays VCF-Files and extracts hCards from Websites written by [http://vcardexplorer.corefault.de Daniel Kagemann].
* [http://placenamehere.com/mf/nnwextract/ Extract Microformats] is a script for NetNewsWire that supports extracting hCard and hCalendar data in blog posts (via technorati service). Written by [[User:ChrisCasciano|Chris Casciano]]
* [http://allinthehead.com/hkit/ hKit] is an open source PHP 5 parsing library with support for hCard.
* [http://kitchen.technorati.com/search Technorati Microformats Search] indexes [[hcard|hCard]], [[hcalendar|hCalendar]], and [[hreview|hReview]] as [http://tantek.com/log/2006/05.html#d31t1802 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
* [http://www.webstandards.org/action/dwtf/microformats/ Dreamweaver Extension suite] from the [http://webstandards.org/ Web Standards Project] enables the authoring of hCards from within Dreamweaver 8.
* [http://scooch.gr0w.com/ Scooch] is 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 [http://suda.co.uk/projects/X2V/ X2V]. Also uses [[hReview]] for slide ratings and [[rel-tag]] for categories.
* [http://blog.codeeg.com/2006/03/20/flock-tails-flocktails/ Flocktails] - port of Tails extension for Flock 0.5.12 that looks for hCards, hCalendar, xFolk and hReview and tosses them into a handy topbar
*[http://opensource.reevoo.com/2006/03/08/release-uformats-12/ uformats] is a ruby library that can parse [[hCalendar]], [[hCard]], [[hReview]] and [[rel-tag]]
* [http://blog.codeeg.com/tails-firefox-extension-03/ Tails] is a Firefox Extension that will display the presence and details of microformats ([[hcard|hCard]], [[hcalendar|hCalendar]], [[hreview|hReview]], [[xfolk|xFolk]]) on a webpage. [https://addons.mozilla.org/firefox/2240/ Tails Export] is an extended version.
* [http://www.stripytshirt.co.uk/features/firefox/smartzilla Smartzilla is a Firefox Extension] that finds hCards on web pages and lets you add them to your addressbook.
* [http://placenamehere.com/TXP/pnh_mf/ pnh_mf] is a plugin for [http://textpattern.com/ Textpattern] that supports embedding hCard and other microformats in templates and blog posts. Written by [http://placenamehere.com/ Chris Casciano].
* There is [http://flickr.com/photos/factoryjoe/68755089/ evidence of built-in hCard support in the Konqueror browser]. Specifically, Konqueror 3.5, in KDE 3.5 (kubuntu Breezy w/ update).
* There is [http://tagcamp.org/index.cgi?ContactList evidence of a kwiki plugin for hCards]. Update: the [http://svn.kwiki.org/cwest/Kwiki-hCard/ hCard kwiki plugin svn repository]. See the [http://microwiki.caseywest.com/index.cgi?hCard documentation of the hCard kwiki plugin].
* [http://suda.co.uk/projects/X2V/ X2V] is a bookmarklet that parses hCard and produces a .vcf (vCard) stream. Note: needs to be updated as the spec is refined.
* [http://www.stripytshirt.co.uk Duncan Walker] has built [http://www.stripytshirt.co.uk/features/firefox/smartzilla 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.
* [http://george.hotelling.net/90percent/ George] has written a [http://george.hotelling.net/90percent/geekery/greasemonkey_and_microformats.php 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.
* [http://inside.glnetworks.de/ Martin Rehfeld] has updated the work of [http://blogmatrix.blogmatrix.com/ David Janes] and produced a [[Greasemonkey]] [http://inside.glnetworks.de/2006/06/05/microformats-have-arrived-in-firefox-15-greasemonkey-06/ script] that finds many microformat elements, including hCards, and [http://blog.davidjanes.com/mtarchives/2005_08.html#003379 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.''
* [http://diveintomark.org/ Mark Pilgrim] has also written an [http://diveintomark.org/projects/greasemonkey/hcard/ hCard parser Greasemonkey user script]. It is self-contained and does not rely on the X2V web service.
* [http://www.oliverbrown.me.uk/2005/09/03/a-working-microformats-extension-to-simplexml/ Oliver Brown] has written an "extension" to [http://www.php.net/simplexml SimpleXML] that gives simple access to hCard information in PHP 5.
* [http://thedredge.org/ Andrew D. Hume] has built a system (Wordpress plugin?) for [http://thedredge.org/2005/06/using-hcards-in-your-blog/ using hCards in your blog] to represent people leaving comments on blog posts.
* [http://greenbytes.de/tech/webdav/rfc2629.xslt rfc2629.xslt] now attempts to generate hCard information ([http://ietf.org/rfc/rfc2629 RFC2629] is an XML format for authoring RFCs and Internet Drafts, see [http://greenbytes.de/tech/webdav/rfc2629xslt/rfc2629xslt.html example document])
* [http://tantek.com/microformats/buddylist2hcards.html 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.
* [http://dev.w3.org/cvsweb/2001/palmagent/ palmagent] is a collection of palmpilot and sidekick tools. It includes X2V derivatives xhtml2hcard.xsl and toICal.xsl plus some [http://dev.w3.org/cvsweb/2001/palmagent/hcardTest.html hcardTest] materials
* [http://www.openpsa.org/ OpenPsa 2.x] CRM application uses hCard for all person listings. The widget is [http://www.midgard-project.org/midcom-permalink-922834501b71daad856f35ec593c7a6d reusable across Midgard CMS]
* [http://www.metonymie.com Emiliano Martínez Luque] has written an experimental [http://www.metonymie.com/hCard_extract/app.html 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.
* [http://www.milkcarton.be/apps/lustro 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.

* [http://www.gowebsolutions.com/plugins/wp-customer-reviews/ WP Customer Reviews] is a Wordpress plugin which lets customers leave testimonials and reviews of your business, service, or website. Reviews are in hReview format and also provides an hCard implementation for business details.
* [http://www.goodatacheck.com/ Geodatacheck.com] is a Webservice where you enter you address and contact Info, it geocodes your location and asks for your socialmedia handles and geo app venue or places ID like google place, gowalla, foursquare. You get a vCard and a hCard as output. Use the hCard snippet to place have your address with all the additional links in an hCard format.

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

===Web-based Creators===
;[http://microformats.org/code/hcard/creator hCard creator]:Create your own hCards; also has a [http://www.wnas.nl/microformats/hcard/hcardCreator.html Dutch interface]. [[hcard-creator-feedback|hCard Give feedback.]]

===Blogging and CMS tools===
;[http://euphemize.net/blog/plugins/textpattern/jmc_event_manager/ Textpattern plug-in]:jmc_event_manager is a plugin for [http://textpattern.com/ Textpattern] that outputs locations and events in hCard (and hCalendar) formats. Written by [http://euphemize.net/ Joel Courtney].
;[http://wordpress.org/extend/plugins/addressbook/ Wordpress Addressbook plugin]:Display list of addresses from the blog owner's address book, each marked up as an hCard. Maintained by [http://samwilson.id.au 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 : [http://microformats.org/code/hcard/creator microformats.org hCard creator] (see also [http://tantek.com/ Tantek]'s original [http://tantek.com/microformats/hcard-creator.html hCard creator on tantek.com].

===Desktop Authoring Tools===
* ...

==Search and Discovery==
* [http://kitchen.technorati.com/search Technorati Microformats Search] indexes [[hcard|hCard]], [[hcalendar|hCalendar]], and [[hreview|hReview]] as [http://tantek.com/log/2006/05.html#d31t1802 announced by Tantek].
* [http://leftlogic.com/info/articles/microformats_bookmarklet 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 [[hcard|hCards]] or [[hcalendar|hCalendars]]. Written by [http://leftlogic.com 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.
* [http://www.tomota.de www.tomota.de] Online address book that allows to import, export and convert hCard into vCard, ldif, csv and plain text.

* ...

===Firefox Greasemonkey Plugins===
* [http://userscripts.org/scripts/show/36879 Oomph for GreaseMonkey] - Injects the [http://www.visitmix.com/lab/oomph Oomph] javascript for Greasemonkey

===Aggregators===
* ...

===Forms===
* [http://lib.omnia-computing.de/hcardmapper hCard Mapper] maps hCards onto form fields (Javascript based)

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

===Firefox extension===

[http://www.kaply.com/weblog/operator Operator] - This extension is casual-user, advanced-user and developer friendly. Very customizable and unobstrusive.

===Internet Explorer extension===

[http://www.visitmix.com/lab/oomph 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 [http://microformats.org/code/hcard/creator hCard creator] ([[hcard-creator-feedback|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
* [http://search.cpan.org/~ussjoin/Data-Microformat-0.01/lib/Data/Microformat/hCard.pm Data::Microformat] - CPAN module for both creating and parsing hCards
;PHP
* [[hKit]]
;Python:
* [http://tommorris.org/files/gmail2hcard-py.txt gmail2hcard-py.txt] - for converting Gmail CSV address book export to hCards
;Ruby:
* [http://github.com/cyril/resumy 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
* [http://www.milkcarton.be/apps/lustro 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 [http://www.gravatar.com/ Gravatars].
** Like [http://alper.nl/cgi-bin/OpenAvatar.py?url=http://tantek.com this].
** Wordpress plugin with hCard based replacement for gravatar is in the make. [[User:Alper|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-related-pages}}

opening-hours

2011-02-15T09:41:06Z

Smtm: opening hours example

proposed Format:
'Tu-Sa 08:00-15:00; Sa 08:00-12:00'.

see it here: http://www.geodatacheck.com/p/2

Use a semicolon to separate the different days or or time ranges.
Use two letter english day names. Times are local times with leading zero

This is the format as used in openstreetmap.org for a node description with opening hours. Openstreetmap has very rigid semantics, so it makes sense to follow their format.

Microformats Wiki - User contributions [en]

opening-hours-formats

opening-hours-formats

opening-hours

opening-hours

hcard-implementations

opening-hours