$value ) { switch( $key ) { case 'firstname': case 'lastname': case 'company': case 'position': case 'email': case 'url': case 'tel': case 'teltype': case 'adrtype': case 'label': case 'rev': $vars[$key] = trim($value); break; case 'pobox': case 'extended': case 'street': case 'city': case 'state': case 'zip': case 'country': $address[$key] = trim($value); break; case 'adr': if( !isset($vars['label']) ) $vars['label'] = trim($value); $vars[$key] = trim($value); break; case 'assign': // do nothing break; case 'noencode': $encode = FALSE; break; } } $tpl = << $value ) { if( $value != '' ) { $fnd = true; break; } } if( $fnd ) { // address specified $vars['adr'] = "{$address['pobox']};{$address['extended']};{$address['street']};{$address['city']};{$address['state']};{$address['zip']};{$address['country']}"; if( !isset($vars['label']) ) { // build the label $atpl = <<assign('address',$address); $smarty->_compile_source('address tmp',$atpl,$_compiled); @ob_start(); $smarty->_eval('?>'.$_compiled); $_label = @ob_get_contents(); @ob_end_clean(); $_label = str_replace('__NL__',"\n",$_label); $_label = str_replace("\n",'\n',$_label); $_label = str_replace('\n\n','\n',$_label); $_label = str_replace('\n\n','\n',$_label); $vars['label'] = $_label; } } } $smarty->assign('vars',$vars); $smarty->_compile_source('address plugin',$tpl,$_compiled); @ob_start(); $smarty->_eval('?>'.$_compiled); $_contents = @ob_get_contents(); @ob_end_clean(); $_contents = str_replace('__NL__',"\n",$_contents); $_contents = str_replace("\n\n","\n",$_contents); if( $encode ) $_contents = rawurlencode($_contents); if( isset($params['assign']) ) { $smarty->assign(trim($params['assign']),$_contents); return; } return $_contents; } function smarty_cms_help_function_vcard() { $txt = <<What Does This Do?

This is a simple plugin capable of generating a formatted, or encoded vcard (V3) for use on websites.

Features and Limitations:

  • Supports a single address or telephone number.
  • Automatically builds the ADR tag and LABEL Tag.
  • Supports specifying the adress and/or telephone type.
  • Automatically builds the FN tag.
  • Optional URL encoding.

How Do I Use It?

A downloadable vcard

  • Create a simple page template with just {content}
  • Create a new page using the template created above. Disable the wysiwyg for this page. Set the alias for ths page to "myvcard"
  • In the page content of the new page add: 
    {vcard noencode=1 firstname=John lastname=Doe company='Acme Corporation' position='grunt worker' email='jdoe@acme.org' url='http://www.acme.org/people/jdoe' tel='1 (000) 5551212'}
  • In other pages, or page templates, use {cms_selflink} to create a link to your vcard. Something like: {cms_selflink page=myvcard text='My Vcard'}

A vcard String

Vcards can be generated as a string for use in supplying to another service (such as posting a vcard to an address registry, or generating a qrcode). This is similar to the above procedure except the noencode=1 parameter is removed. You may also add the assign parameter.

{vcard firstname=John lastname=Doe company='Acme Corporation' position='grunt worker' email='jdoe@acme.org' url='http://www.acme.org/people/jdoe' tel='1 (000) 5551212'}

Parameters:

  • firstname : (required) The persons given name.
  • lastname : (required) The persons family name.
  • company : (optional) An organizational name.
  • position : (optional) An optional position within the organization.
  • email : (optional) An email address.
  • url : (optional) A website address.
  • tel : (optional) Telephone number.
  • teltype : (optional) - Telephone type (i.e: home,work,mobile) default: pref
  • adrtype : (optional) - Address type (i.e: home,work,mobile) default: pref
  • label : (optional) - Human readable address. If not specified the adr field is used.
  • rev : (optional) - Revision number. If not specified the current date and time are used.
  • pobox : (optional) - Post Office Box portion of the address. This parameter is ignored if adr is specified.
  • extended : (optional) - Extended portion of the address. This parameter is ignored if adr is specified.
  • street : (optional) - Street portion of the address. This parameter is ignored if adr is specified.
  • city : (optional) - City portion of the address. This parameter is ignored if adr is specified.
  • state : (optional) - State portion of the address. This parameter is ignored if adr is specified.
  • zip : (optional) - Postal code portion of the address. This parameter is ignored if adr is specified.
  • country : (optional) - Country name portion of the address. This parameter is ignored if adr is specified.
  • adr : (optional) - The ability to override the complete address string. This is a formatted string with the various addesss portions specified in order and separated with a semicolon. If it is not specified, the adr field is built from the various other parameters.
  • assign : (optional) - Assign the output of the tag to the named smarty variable instead of to the page.
  • noencode : (optional) - If specified, and a nonzero value the output will not be url encoded.
EOT; echo $txt; } function smarty_cms_about_function_vcard() { ?>

Author: Robert Campbell <calguy1000@gmail.com>

Version: 1.0

Change History:

  • 1.0 - Initial Version.