Download vCard Script


/ Published in: PHP
Save to your folder(s)

Features: Complies to version 2.1 of the vCard specification
Supports the following attributes:

* Name
* Formatted Name
* Phone and fax numbers
* Birthday
* Address
* Address label
* email address
* notes
* URL


Copy this code and paste it in your HTML
  1. <?
  2. /***************************************************************************
  3.  
  4. PHP vCard class v2.0
  5. (c) Kai Blankenhorn
  6. www.bitfolge.de/en
  7. kaib@bitfolge.de
  8.  
  9.  
  10. This program is free software; you can redistribute it and/or
  11. modify it under the terms of the GNU General Public License
  12. as published by the Free Software Foundation; either version 2
  13. of the License, or (at your option) any later version.
  14.  
  15. This program is distributed in the hope that it will be useful,
  16. but WITHOUT ANY WARRANTY; without even the implied warranty of
  17. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  18. GNU General Public License for more details.
  19.  
  20. You should have received a copy of the GNU General Public License
  21. along with this program; if not, write to the Free Software
  22. Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  23.  
  24. ***************************************************************************/
  25.  
  26.  
  27. function encode($string) {
  28. return escape(quoted_printable_encode($string));
  29. }
  30.  
  31. function escape($string) {
  32. return str_replace(";","\;",$string);
  33. }
  34.  
  35. // taken from PHP documentation comments
  36. function quoted_printable_encode($input, $line_max = 76) {
  37. $hex = array('0','1','2','3','4','5','6','7','8','9','A','B','C','D','E','F');
  38. $lines = preg_split("/(?:
  39. |\r|\n)/", $input);
  40. $eol = "
  41. ";
  42. $linebreak = "=0D=0A";
  43. $escape = "=";
  44. $output = "";
  45.  
  46. for ($j=0;$j<count($lines);$j++) {
  47. $line = $lines[$j];
  48. $linlen = strlen($line);
  49. $newline = "";
  50. for($i = 0; $i < $linlen; $i++) {
  51. $c = substr($line, $i, 1);
  52. $dec = ord($c);
  53. if ( ($dec == 32) && ($i == ($linlen - 1)) ) { // convert space at eol only
  54. $c = "=20";
  55. } elseif ( ($dec == 61) || ($dec < 32 ) || ($dec > 126) ) { // always encode "\t", which is *not* required
  56. $h2 = floor($dec/16); $h1 = floor($dec%16);
  57. $c = $escape.$hex["$h2"].$hex["$h1"];
  58. }
  59. if ( (strlen($newline) + strlen($c)) >= $line_max ) { // CRLF is not counted
  60. $output .= $newline.$escape.$eol; // soft line break; " =
  61. " is okay
  62. $newline = " ";
  63. }
  64. $newline .= $c;
  65. } // end of for
  66. $output .= $newline;
  67. if ($j<count($lines)-1) $output .= $linebreak;
  68. }
  69. return trim($output);
  70. }
  71.  
  72. class vCard {
  73. var $properties;
  74. var $filename;
  75.  
  76. function setPhoneNumber($number, $type="") {
  77. // type may be PREF | WORK | HOME | VOICE | FAX | MSG | CELL | PAGER | BBS | CAR | MODEM | ISDN | VIDEO or any senseful combination, e.g. "PREF;WORK;VOICE"
  78. $key = "TEL";
  79. if ($type!="") $key .= ";".$type;
  80. $key.= ";ENCODING=QUOTED-PRINTABLE";
  81. $this->properties[$key] = quoted_printable_encode($number);
  82. }
  83.  
  84. // UNTESTED !!!
  85. function setPhoto($type, $photo) { // $type = "GIF" | "JPEG"
  86. $this->properties["PHOTO;TYPE=$type;ENCODING=BASE64"] = base64_encode($photo);
  87. }
  88.  
  89. function setFormattedName($name) {
  90. $this->properties["FN"] = quoted_printable_encode($name);
  91. }
  92.  
  93. function setName($family="", $first="", $additional="", $prefix="", $suffix="") {
  94. $this->properties["N"] = "$family;$first;$additional;$prefix;$suffix";
  95. $this->filename = "$first%20$family.vcf";
  96. if ($this->properties["FN"]=="") $this->setFormattedName(trim("$prefix $first $additional $family $suffix"));
  97. }
  98.  
  99. function setBirthday($date) { // $date format is YYYY-MM-DD
  100. $this->properties["BDAY"] = $date;
  101. }
  102.  
  103. function setAddress($postoffice="", $extended="", $street="", $city="", $region="", $zip="", $country="", $type="HOME;POSTAL") {
  104. // $type may be DOM | INTL | POSTAL | PARCEL | HOME | WORK or any combination of these: e.g. "WORK;PARCEL;POSTAL"
  105. $key = "ADR";
  106. if ($type!="") $key.= ";$type";
  107. $key.= ";ENCODING=QUOTED-PRINTABLE";
  108. $this->properties[$key] = encode($name).";".encode($extended).";".encode($street).";".encode($city).";".encode($region).";".encode($zip).";".encode($country);
  109.  
  110. if ($this->properties["LABEL;$type;ENCODING=QUOTED-PRINTABLE"] == "") {
  111. //$this->setLabel($postoffice, $extended, $street, $city, $region, $zip, $country, $type);
  112. }
  113. }
  114.  
  115. function setLabel($postoffice="", $extended="", $street="", $city="", $region="", $zip="", $country="", $type="HOME;POSTAL") {
  116. $label = "";
  117. if ($postoffice!="") $label.= "$postoffice
  118. ";
  119. if ($extended!="") $label.= "$extended
  120. ";
  121. if ($street!="") $label.= "$street
  122. ";
  123. if ($zip!="") $label.= "$zip ";
  124. if ($city!="") $label.= "$city
  125. ";
  126. if ($region!="") $label.= "$region
  127. ";
  128. if ($country!="") $country.= "$country
  129. ";
  130.  
  131. $this->properties["LABEL;$type;ENCODING=QUOTED-PRINTABLE"] = quoted_printable_encode($label);
  132. }
  133.  
  134. function setEmail($address) {
  135. $this->properties["EMAIL;INTERNET"] = $address;
  136. }
  137.  
  138. function setNote($note) {
  139. $this->properties["NOTE;ENCODING=QUOTED-PRINTABLE"] = quoted_printable_encode($note);
  140. }
  141.  
  142. function setURL($url, $type="") {
  143. // $type may be WORK | HOME
  144. $key = "URL";
  145. if ($type!="") $key.= ";$type";
  146. $this->properties[$key] = $url;
  147. }
  148.  
  149. function getVCard() {
  150. $text = "BEGIN:VCARD
  151. ";
  152. $text.= "VERSION:2.1
  153. ";
  154. foreach($this->properties as $key => $value) {
  155. $text.= "$key:$value
  156. ";
  157. }
  158. $text.= "REV:".date("Y-m-d")."T".date("H:i:s")."Z
  159. ";
  160. $text.= "MAILER:PHP vCard class by Kai Blankenhorn
  161. ";
  162. $text.= "END:VCARD
  163. ";
  164. return $text;
  165. }
  166.  
  167. function getFileName() {
  168. return $this->filename;
  169. }
  170. }
  171.  
  172.  
  173. // USAGE EXAMPLE
  174.  
  175. $v = new vCard();
  176.  
  177. $v->setPhoneNumber("+49 23 456789", "PREF;HOME;VOICE");
  178. $v->setName("Mustermann", "Thomas", "", "Herr");
  179. $v->setBirthday("1960-07-31");
  180. $v->setAddress("", "", "Musterstrasse 20", "Musterstadt", "", "98765", "Deutschland");
  181. $v->setEmail("thomas.mustermann@thomas-mustermann.de");
  182. $v->setNote("You can take some notes here.
  183. Multiple lines are supported via \\r\\n.");
  184. $v->setURL("http://www.thomas-mustermann.de", "WORK");
  185.  
  186. $output = $v->getVCard();
  187. $filename = $v->getFileName();
  188.  
  189. Header("Content-Disposition: attachment; filename=$filename");
  190. Header("Content-Length: ".strlen($output));
  191. Header("Connection: close");
  192. Header("Content-Type: text/x-vCard; name=$filename");
  193.  
  194. echo $output;
  195. ?>

URL: http://www.bitfolge.de/phpvcard-en.html

Report this snippet


Comments

RSS Icon Subscribe to comments

You need to login to post a comment.