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

Translate “hCard ShortCode” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

Trunk

  • tested with WordPress 4.4
  • inititial release