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<h3>How can use the 'only' option?</h3>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 URLs
  • 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"]<h3>Kudos and acknowledgements:</h3>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

FAQ

Can I use it in text widgets?

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

Contributors & Developers

“hCard ShortCode” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

Trunk

  • tested with WordPress 4.4
  • inititial release