Logo  

web500gw: vCard support

 
  Web500gw supports now vCards - Electronic Business Cards, see http://www.imc.org/pdi/. So users of modern Web browsers could easily add entries to their address books.

Configuration

Add to ldaptemplates.conf[.access-suffix] a special template for a pseudo object class "web500gw_vcard". You can map there Directory attributes to vCard attributes. The labels should be according to the vCard attribute name specification, see RFC 2426.
Some options have special meaning for vCards:
1val - take only one value (required for some vCard attributes)
samerow - more attribute values to a vCard attribute (e.g. o and ou for ORG)
Example:
# vCard template
"vCard"
"vCard"
""
""
# objectclass list
web500gw_vcard
END
""
""
""
# rules used to define default values for new entries
END
# list of items for display
# only cis, mls, mail, time, date, url sould occure for vCard
# "friendly names" should be according to the vCard spec.
# They are NOT substituted by friendlyfile

item cis,1val   FN      cn
item cis        TITLE   personalTitle
item mls        "ADR;TYPE=WORK"    postalAddress
item cis        "TEL;VOICE;WORK"   telephoneNumber
item cis        "TEL;FAX;WORK"     facsimileTelephoneNumber
item cis        ORG                o
samerow
item cis        ORG                ou
item mail       "EMAIL;PREF;INTERNET" mail
item url,1val,sort    URL                   labeledURI
item mls        "ADR;TYPE=HOME"       homePostalAddress
item cis        "TEL;VOICE;HOME"      homePhone
item cis        NOTE                  description
END
Example of generated vCard:
BEGIN:vCard
VERSION:2.1
FN:Foo Bar
ADR;TYPE=WORK:org;street;city;Federal Republic of Germany
TEL;VOICE;WORK:+49 987 654-321
TEL;FAX;WORK:+49 123 456-789
ORG:organization,ou
EMAIL;PREF;INTERNET:user@domain
URL:http://server/path
NOTE:DSA manager
PRODID:web500gw 2.1
END:vCard
Connecting to an entry:

A vCard is generated if only the attribute vcard is requested by the URL. To include a link "GET vCard" to an entry, add a link action to a template, e.g. to person's template:

item linkact vCard   vcard "?vcard"
When displaying a person's entry, a Hyperlink to the person's vCard is shown. By clicking it, the client gets the vCard.

It is possible to request vCards also for other object classes than for persons. Of course the results may be useless.

VERSION: 2.1rc1
 Availability
 Features
 Changes
 Known Bugs
 Links & References

Installation
 Modes

Configuration:
 web500gw.conf
 Hints
 vCards
 Search interface
 Adding entries

Examples:
 web500gw.conf
 ldaptemplates.conf
 ldapfriendly

Support:
 Y2K proof?
 Mailing List
 Troubleshooting
 URL format
 URLs in entries
 LDAP errors

Developers
 SF.net Project

Test it:
 TU Chemnitz
 TU Chemnitz CGI
 Other sites


hosted by sourceforge
  (vcard.html.php Version 1.1) last modified by dekarl on 2001/07/22 at 20:17:46 GMT