=== hCard ShortCode ===
Contributors: Comparto Web, sandropaganotti
Tags: hcard, vcard
Requires at least: 3.0
Tested up to: 4.4
Stable tag: trunk

hCard ShortCode is a WordPress plugin that translates vCard to hCard and let's you display them using a simple [hcard] shortcode.

== Description ==

hCard ShortCode translates vCard to hCard and let's you display them using a simple [hcard] shortcode.

## How it works:
1. install the plugin
2. upload the vCards in the Media section
3. choose a **no-space only-alphanumeric lowercase** Title for the vCards
4. use the [hcard vcard='vcard title' only='optional comma separated vcard fields to display'] shortcode 
5. style the resulting hCard using CSS

## Which fields are supported?
hCard ShortCode supports the following vCard fields:

* `N` given name and family name;
* one `EMAIL` optionally use `TYPE` to specify a label to use in the <a> link;
* one `TITLE`
* one `ORG`
* one `PHOTO` with `TYPE=URL`
* one or more `URL`, optionally use `TYPE` to specify a label to use in the <a> link;
* one `ADR`

## Can you give me a sample vCard?
Sure, here it is:

    BEGIN:VCARD
    N:Paganotti;Sandro;;;
    EMAIL;TYPE=Email:sandro.paganotti@compartoweb.com
    TITLE:Software Architect
    ORG:Comparto Web
    PHOTO;VALUE=URL;TYPE=PNG:/wp-content/uploads/2012/04/official_me-43x43.png
    URL;TYPE=Twitter:https://twitter.com/#!/sandropaganotti
    URL;TYPE=LinkedIn:http://www.linkedin.com/in/sandropaganotti
    ADR;INTL;PARCEL;WORK:;;Via Cipro 66;Brescia;Brescia;25100;Italia
    END:VCARD

## How can use the 'only' option?
the `only` option can be used to limit the fields printed on the hCard, you
can declare a comma-separated list of the fields you want to be displayed, here's the
keyword:

* `name` for given name and family name
* `email` for the `EMAIL`
* `org:title` for the `TITLE` 
* `org:name` for the `ORG`
* `url` for the `URL`s
* `photo` for the `PHOTO`
* `location` for thr `ADR`

## An example:
Here's a shortcode example:

    [hcard vcard="sandropaganotti" only="name,email,org:title,photo,url"]

## Kudos and acknowledgements:
This plugin uses the cool Contact_Vcard_Parse class from Paul M. Jones <pjones@ciaweb.net> and a modified version of the phpMicroformats class from Tobias Kluge (enarion.net). Thank you!

== Installation ==

1. install the plugin (copy in wp-content/plugins and activate)
2. upload the vCards in the Media section
3. choose a **no-space only-alphanumeric lowercase** Title for the vCards
4. use the [hcard vcard='vcard title' only='optional comma separated vcard fields to display'] shortcode 
5. style the resulting hCard using CSS

== Frequently Asked Questions ==

= Can I use it in text widgets? =

Sure! just add `add_filter('widget_text', 'do_shortcode');` to your `functions.php`.

== Changelog ==

= Trunk =
* tested with Wordpress 4.4
* inititial release