class.ilvCard.php

Go to the documentation of this file.

<?php
/*
    +-----------------------------------------------------------------------------+
    | ILIAS open source                                                           |
    +-----------------------------------------------------------------------------+
    | Copyright (c) 1998-2001 ILIAS open source, University of Cologne            |
    |                                                                             |
    | This program is free software; you can redistribute it and/or               |
    | modify it under the terms of the GNU General Public License                 |
    | as published by the Free Software Foundation; either version 2              |
    | of the License, or (at your option) any later version.                      |
    |                                                                             |
    | This program is distributed in the hope that it will be useful,             |
    | but WITHOUT ANY WARRANTY; without even the implied warranty of              |
    | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               |
    | GNU General Public License for more details.                                |
    |                                                                             |
    | You should have received a copy of the GNU General Public License           |
    | along with this program; if not, write to the Free Software                 |
    | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA. |
    +-----------------------------------------------------------------------------+
*/

define("ADR_TYPE_NONE", 0);
define("ADR_TYPE_DOM", 1);
define("ADR_TYPE_INTL", 2);
define("ADR_TYPE_POSTAL", 4);
define("ADR_TYPE_PARCEL", 8);
define("ADR_TYPE_HOME", 16);
define("ADR_TYPE_WORK", 32);
define("ADR_TYPE_PREF", 64);

define("TEL_TYPE_NONE", 0);
define("TEL_TYPE_HOME", 1);
define("TEL_TYPE_MSG", 2);
define("TEL_TYPE_WORK", 4);
define("TEL_TYPE_PREF", 8);
define("TEL_TYPE_VOICE", 16);
define("TEL_TYPE_FAX", 32);
define("TEL_TYPE_CELL", 64);
define("TEL_TYPE_VIDEO", 128);
define("TEL_TYPE_PAGER", 256);
define("TEL_TYPE_BBS", 512);
define("TEL_TYPE_MODEM", 1024);
define("TEL_TYPE_CAR", 2048);
define("TEL_TYPE_ISDN", 4096);
define("TEL_TYPE_PCS", 8192);

define("EMAIL_TYPE_NONE", 0);
define("EMAIL_TYPE_INTERNET", 1);
define("EMAIL_TYPE_x400", 2);
define("EMAIL_TYPE_PREF", 4);

class ilvCard
{
    public $types;

    public $filename;
    
    public function __construct($version = "3.0")
    {
        $this->types = array(
            "FN" => "",
            "N" => "",
            "NICKNAME" => "",
            "PHOTO" => array(),
            "BDAY" => "",
            "ADR" => array(),
            "LABEL" => array(),
            "TEL" => array(),
            "EMAIL" => array(),
            "MAILER" => "",
            "TZ" => "",
            "GEO" => "",
            "TITLE" => "",
            "ROLE" => "",
            "LOGO" => array(),
            "AGENT" => "",
            "ORG" => "",
            "CATEGORIES" => "",
            "NOTE" => "",
            "PRODID" => "",
            "REV" => "",
            "SORT-STRING" => "",
            "SOUND" => array(),
            "UID" => "",
            "URL" => "",
            "VERSION" => "3.0",
            "CLASS" => "",
            "KEY" => array()
        );
        $this->types["VERSION"] = $version;
    }
    
    public function encode($string)
    {
        return escape(quoted_printable_encode($string));
    }
    
    public function fold($string = "", $length = 75)
    {
        $folded_string = "";
        preg_match_all("/(.{1,74})/", $string, $matches);
        for ($i = 0; $i < count($matches[1]); $i++) {
            if ($i < (count($matches[1]) - 1)) {
                $matches[1][$i] .= "\n";
            }
            if ($i > 0) {
                $matches[1][$i] = " " . $matches[1][$i];
            }
            $folded_string .= $matches[1][$i];
        }
        return $folded_string;
    }
    
    public function escape($string)
    {
        $string = preg_replace("/(?<!\\\\)(\\\\)([^;,n\\\\])/", "\${1}\${1}\${2}", $string);
        $string = preg_replace("/(?<!\\\\);/", "\\;", $string);
        $string = preg_replace("/(?<!\\\\),/", "\\,", $string);
        $string = preg_replace("/\n/", "\\n", $string);
        return $string;
    }
    
    public function &explodeVar($variable, $separator = ",")
    {
        $exploded = explode($separator, $variable);
        foreach ($exploded as $index => $var) {
            $exploded[$index] = $this->escape($var);
        }
        return $exploded;
    }
    
    public function buildVCard()
    {
        $vcard = "BEGIN:VCARD\n";
        $vcard .= "VERSION:" . $this->types["VERSION"] . "\n";
        foreach ($this->types as $type => $var) {
            ilLoggerFactory::getLogger('user')->debug(print_r($this->types, true));
            
            switch ($type) {
                case "FN":
                    if (strcmp($this->types["FN"], "") != 0) {
                        $fn = $this->fold("FN:" . $this->types["FN"]) . "\n";
                    } else {
                        $fn = "";
                    }
                    break;
                case "N":
                    if (strcmp($this->types["N"], "") != 0) {
                        $n = $this->fold("N:" . $this->types["N"]) . "\n";
                    } else {
                        $n = "";
                    }
                    break;
                case "NICKNAME":
                    if (strcmp($this->types["NICKNAME"], "") != 0) {
                        $nickname = $this->fold("NICKNAME:" . $this->types["NICKNAME"]) . "\n";
                    } else {
                        $nickname = "";
                    }
                    break;
                case "PHOTO":
                    $photo = "";
                    if (is_array($this->types["PHOTO"])) {
                        if (strcmp($this->types["PHOTO"]["VALUE"], "") != 0) {
                            $photo = $this->fold("PHOTO;VALUE=uri:" . $this->types["PHOTO"]["VALUE"]) . "\n";
                        } elseif (strcmp($this->types["PHOTO"]["ENCODING"], "") != 0) {
                            $photo = "PHOTO;ENCODING=" . $this->types["PHOTO"]["ENCODING"];
                            if (strcmp($this->types["PHOTO"]["TYPE"], "") != 0) {
                                $photo .= ";TYPE=" . $this->types["PHOTO"]["TYPE"];
                            }
                            $photo .= ":" . $this->types["PHOTO"]["PHOTO"];
                            $photo = $this->fold($photo) . "\n";
                        }
                    }
                    break;
                case "BDAY":
                    if (strcmp($this->types["BDAY"], "") != 0) {
                        $bday = $this->fold("BDAY:" . $this->types["BDAY"]) . "\n";
                    } else {
                        $bday = "";
                    }
                    break;
                case "ADR":
                    if (count($this->types["ADR"])) {
                        $addresses = "";
                        foreach ($this->types["ADR"] as $key => $address) {
                            $test = "";
                            foreach ($address as $str) {
                                $test .= $str;
                            }
                            if (strcmp($test, "") != 0) {
                                $adr = "ADR";
                                $adr_types = array();
                                if ($address["TYPE"] > 0) {
                                    if (($address["TYPE"] & ADR_TYPE_DOM) > 0) {
                                        array_push($adr_types, "dom");
                                    }
                                    if (($address["TYPE"] & ADR_TYPE_INTL) > 0) {
                                        array_push($adr_types, "intl");
                                    }
                                    if (($address["TYPE"] & ADR_TYPE_POSTAL) > 0) {
                                        array_push($adr_types, "postal");
                                    }
                                    if (($address["TYPE"] & ADR_TYPE_PARCEL) > 0) {
                                        array_push($adr_types, "parcel");
                                    }
                                    if (($address["TYPE"] & ADR_TYPE_HOME) > 0) {
                                        array_push($adr_types, "home");
                                    }
                                    if (($address["TYPE"] & ADR_TYPE_WORK) > 0) {
                                        array_push($adr_types, "work");
                                    }
                                    if (($address["TYPE"] & ADR_TYPE_PREF) > 0) {
                                        array_push($adr_types, "pref");
                                    }
                                    $adr .= ";TYPE=" . join(",", $adr_types);
                                }
                                $adr .= ":" . $address["POBOX"] . ";" . $address["EXTENDED_ADDRESS"] .
                                    ";" . $address["STREET_ADDRESS"] . ";" . $address["LOCALITY"] .
                                    ";" . $address["REGION"] . ";" . $address["POSTAL_CODE"] .
                                    ";" . $address["COUNTRY"];
                                $adr = $this->fold($adr) . "\n";
                                $addresses .= $adr;
                            }
                        }
                        $adr = $addresses;
                    } else {
                        $adr = "";
                    }
                    break;
                case "LABEL":
                    $label = "";
                    if (is_array($this->types["LABEL"])) {
                        if (strcmp($this->types["LABEL"]["LABEL"], "") != 0) {
                            $label = "LABEL";
                            $adr_types = array();
                            if ($this->types["LABEL"]["TYPE"] > 0) {
                                if (($this->types["LABEL"]["TYPE"] & ADR_TYPE_DOM) > 0) {
                                    array_push($adr_types, "dom");
                                }
                                if (($this->types["LABEL"]["TYPE"] & ADR_TYPE_INTL) > 0) {
                                    array_push($adr_types, "intl");
                                }
                                if (($this->types["LABEL"]["TYPE"] & ADR_TYPE_POSTAL) > 0) {
                                    array_push($adr_types, "postal");
                                }
                                if (($this->types["LABEL"]["TYPE"] & ADR_TYPE_PARCEL) > 0) {
                                    array_push($adr_types, "parcel");
                                }
                                if (($this->types["LABEL"]["TYPE"] & ADR_TYPE_HOME) > 0) {
                                    array_push($adr_types, "home");
                                }
                                if (($this->types["LABEL"]["TYPE"] & ADR_TYPE_WORK) > 0) {
                                    array_push($adr_types, "work");
                                }
                                if (($this->types["LABEL"]["TYPE"] & ADR_TYPE_PREF) > 0) {
                                    array_push($adr_types, "pref");
                                }
                                $label .= ";TYPE=" . join(",", $adr_types);
                            }
                            $label .= ":" . $this->types["LABEL"]["LABEL"];
                            $label = $this->fold($label) . "\n";
                        }
                    }
                    break;
                case "TEL":
                    if (count($this->types["TEL"])) {
                        $phonenumbers = "";
                        foreach ($this->types["TEL"] as $key => $phone) {
                            if (strcmp($phone["TEL"], "") != 0) {
                                $tel = "TEL";
                                $tel_types = array();
                                if ($phone["TYPE"] > 0) {
                                    if (($phone["TYPE"] & TEL_TYPE_HOME) > 0) {
                                        array_push($tel_types, "home");
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_MSG) > 0) {
                                        array_push($tel_types, "msg");
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_WORK) > 0) {
                                        array_push($tel_types, "work");
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_PREF) > 0) {
                                        array_push($tel_types, "pref");
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_VOICE) > 0) {
                                        array_push($tel_types, "voice");
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_FAX) > 0) {
                                        array_push($tel_types, "fax");
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_CELL) > 0) {
                                        array_push($tel_types, "cell");
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_VIDEO) > 0) {
                                        array_push($tel_types, "video");
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_PAGER) > 0) {
                                        array_push($tel_types, "pager");
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_BBS) > 0) {
                                        array_push($tel_types, "bbs");
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_MODEM) > 0) {
                                        array_push($tel_types, "modem");
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_CAR) > 0) {
                                        array_push($tel_types, "car");
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_ISDN) > 0) {
                                        array_push($tel_types, "isdn");
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_PCS) > 0) {
                                        array_push($tel_types, "pcs");
                                    }
                                    $tel .= ";TYPE=" . join(",", $tel_types);
                                }
                                $tel .= ":" . $phone["TEL"];
                                $tel = $this->fold($tel) . "\n";
                                $phonenumbers .= $tel;
                            }
                        }
                        $tel = $phonenumbers;
                    } else {
                        $tel = "";
                    }
                    break;
                case "EMAIL":
                    if (count($this->types["EMAIL"])) {
                        $emails = "";
                        foreach ($this->types["EMAIL"] as $key => $mail) {
                            if (strcmp($mail["EMAIL"], "") != 0) {
                                $email = "EMAIL";
                                $adr_types = array();
                                if ($mail["TYPE"] > 0) {
                                    if (($mail["TYPE"] & EMAIL_TYPE_INTERNET) > 0) {
                                        array_push($adr_types, "internet");
                                    }
                                    if (($mail["TYPE"] & EMAIL_TYPE_x400) > 0) {
                                        array_push($adr_types, "x400");
                                    }
                                    if (($mail["TYPE"] & EMAIL_TYPE_PREF) > 0) {
                                        array_push($adr_types, "pref");
                                    }
                                    $email .= ";TYPE=" . join(",", $adr_types);
                                }
                                $email .= ":" . $mail["EMAIL"];
                                $email = $this->fold($email) . "\n";
                                $emails .= $email;
                            }
                        }
                        $email = $emails;
                    } else {
                        $email = "";
                    }
                    break;
                case "MAILER":
                    if (strcmp($this->types["MAILER"], "") != 0) {
                        $mailer = $this->fold("MAILER:" . $this->types["MAILER"]) . "\n";
                    } else {
                        $mailer = "";
                    }
                    break;
                case "TZ":
                    if (strcmp($this->types["TZ"], "") != 0) {
                        $tz = $this->fold("TZ:" . $this->types["TZ"]) . "\n";
                    } else {
                        $tz = "";
                    }
                    break;
                case "GEO":
                    if (is_array($this->types["GEO"]) and
                        (strcmp($this->types["GEO"]["LAT"], "") != 0) and
                        (strcmp($this->types["GEO"]["LON"], "") != 0)) {
                        $geo = $this->fold("GEO:" . $this->types["GEO"]["LAT"] . ";" . $this->types["GEO"]["LON"]) . "\n";
                    } else {
                        $geo = "";
                    }
                    break;
                case "TITLE":
                    if (strcmp($this->types["TITLE"], "") != 0) {
                        $title = $this->fold("TITLE:" . $this->types["TITLE"]) . "\n";
                    } else {
                        $title = "";
                    }
                    break;
                case "ROLE":
                    if (strcmp($this->types["ROLE"], "") != 0) {
                        $role = $this->fold("ROLE:" . $this->types["ROLE"]) . "\n";
                    } else {
                        $role = "";
                    }
                    break;
                case "LOGO":
                    $logo = "";
                    if (is_array($this->types["LOGO"])) {
                        if (strcmp($this->types["LOGO"]["VALUE"], "") != 0) {
                            $logo = $this->fold("LOGO;VALUE=uri:" . $this->types["LOGO"]["VALUE"]) . "\n";
                        } elseif (strcmp($this->types["LOGO"]["ENCODING"], "") != 0) {
                            $logo = "LOGO;ENCODING=" . $this->types["LOGO"]["ENCODING"];
                            if (strcmp($this->types["LOGO"]["TYPE"], "") != 0) {
                                $logo .= ";TYPE=" . $this->types["LOGO"]["TYPE"];
                            }
                            $logo .= ":" . $this->types["LOGO"]["LOGO"];
                            $logo = $this->fold($logo) . "\n";
                        }
                    }
                    break;
                case "AGENT":
                    if (strcmp($this->types["AGENT"], "") != 0) {
                        $agent = $this->fold("AGENT:" . $this->types["AGENT"]) . "\n";
                    } else {
                        $agent = "";
                    }
                    break;
                case "ORG":
                    if (strcmp($this->types["ORG"], "") != 0) {
                        $org = $this->fold("ORG:" . $this->types["ORG"]) . "\n";
                    } else {
                        $org = "";
                    }
                    break;
                case "CATEGORIES":
                    if (strcmp($this->types["CATEGORIES"], "") != 0) {
                        $categories = $this->fold("CATEGORIES:" . $this->types["CATEGORIES"]) . "\n";
                    } else {
                        $categories = "";
                    }
                    break;
                case "NOTE":
                    if (strcmp($this->types["NOTE"], "") != 0) {
                        $note = $this->fold("NOTE:" . $this->types["NOTE"]) . "\n";
                    } else {
                        $note = "";
                    }
                    break;
                case "PRODID":
                    if (strcmp($this->types["PRODID"], "") != 0) {
                        $prodid = $this->fold("PRODID:" . $this->types["PRODID"]) . "\n";
                    } else {
                        $prodid = "";
                    }
                    break;
                case "REV":
                    if (strcmp($this->types["REV"], "") != 0) {
                        $rev = $this->fold("REV:" . $this->types["REV"]) . "\n";
                    } else {
                        $rev = "";
                    }
                    break;
                case "SORT-STRING":
                    if (strcmp($this->types["SORT-STRING"], "") != 0) {
                        $sortstring = $this->fold("SORT-STRING:" . $this->types["SORT-STRING"]) . "\n";
                    } else {
                        $sortstring = "";
                    }
                    break;
                case "SOUND":
                    $sound = "";
                    if (is_array($this->types["SOUND"])) {
                        if (strcmp($this->types["SOUND"]["VALUE"], "") != 0) {
                            $sound = $this->fold("SOUND;VALUE=uri:" . $this->types["SOUND"]["VALUE"]) . "\n";
                        } elseif (strcmp($this->types["SOUND"]["ENCODING"], "") != 0) {
                            $sound = "SOUND;ENCODING=" . $this->types["SOUND"]["ENCODING"];
                            if (strcmp($this->types["SOUND"]["TYPE"], "") != 0) {
                                $sound .= ";TYPE=" . $this->types["SOUND"]["TYPE"];
                            }
                            $sound .= ":" . $this->types["SOUND"]["SOUND"];
                            $sound = $this->fold($sound) . "\n";
                        }
                    }
                    break;
                case "UID":
                    $uid = "";
                    if (is_array($this->types["UID"])) {
                        if (strcmp($this->types["UID"]["UID"], "") != 0) {
                            $uid = "UID";
                            if (strcmp($this->types["UID"]["TYPE"], "") != 0) {
                                $uid .= ";TYPE=" . $this->types["UID"]["TYPE"];
                            }
                            $uid .= ":" . $this->types["UID"]["UID"];
                            $uid = $this->fold($uid) . "\n";
                        }
                    }
                    break;
                case "URL":
                    if (strcmp($this->types["URL"], "") != 0) {
                        $url = $this->fold("URL:" . $this->types["URL"]) . "\n";
                    } else {
                        $url = "";
                    }
                    break;
                case "KEY":
                    $key = "";
                    if (is_array($this->types["KEY"])) {
                        if (strcmp($this->types["KEY"]["KEY"], "") != 0) {
                            $key = "KEY";
                            if (strcmp($this->types["KEY"]["TYPE"], "") != 0) {
                                $key .= ";TYPE=" . $this->types["KEY"]["TYPE"];
                            }
                            if (strcmp($this->types["KEY"]["ENCODING"], "") != 0) {
                                $key .= ";ENCODING=" . $this->types["KEY"]["ENCODING"];
                            }
                            $key .= ":" . $this->types["KEY"]["KEY"];
                            $key = $this->fold($key) . "\n";
                        }
                    }
                    break;
                case "CLASS":
                    if (strcmp($this->types["CLASS"], "") != 0) {
                        $class = $this->fold("CLASS:" . $this->types["CLASS"]) . "\n";
                    } else {
                        $class = "";
                    }
                    break;
            }
        }
        $vcard .= $fn . $n . $nickname . $photo . $bday . $adr . $label . $tel . $email . $mailer .
            $tz . $geo . $title . $role . $logo . $agent . $org . $categories . $note . $prodid .
            $rev . $sortstring . $sound . $uid . $url . $class . $key;
        $vcard .= "END:vCard\n";
        return $vcard;
    }
    
    public function quoted_printable_encode($input, $line_max = 76)
    {
        $hex = array('0','1','2','3','4','5','6','7','8','9','A','B','C','D','E','F');
        $lines = preg_split("/(?:\r\n|\r|\n)/", $input);
        $eol = "\r\n";
        $linebreak = "=0D=0A";
        $escape = "=";
        $output = "";
    
        for ($j = 0;$j < count($lines);$j++) {
            $line = $lines[$j];
            $linlen = strlen($line);
            $newline = "";
            for ($i = 0; $i < $linlen; $i++) {
                $c = substr($line, $i, 1);
                $dec = ord($c);
                if (($dec == 32) && ($i == ($linlen - 1))) { // convert space at eol only
                    $c = "=20";
                } elseif (($dec == 61) || ($dec < 32) || ($dec > 126)) { // always encode "\t", which is *not* required
                    $h2 = floor($dec / 16);
                    $h1 = floor($dec % 16);
                    $c = $escape . $hex["$h2"] . $hex["$h1"];
                }
                if ((strlen($newline) + strlen($c)) >= $line_max) { // CRLF is not counted
                    $output .= $newline . $escape . $eol; // soft line break; " =\r\n" is okay
                    $newline = "    ";
                }
                $newline .= $c;
            } // end of for
            $output .= $newline;
            if ($j < count($lines) - 1) {
                $output .= $linebreak;
            }
        }
        return trim($output);
    }

    // Identification Types
//
    // These types are used in the vCard profile to capture information
    // associated with the identification and naming of the person or
    // resource associated with the vCard.
    
    public function setFormattedName($formatted_name)
    {
        $this->types["FN"] = $this->escape($formatted_name);
    }

    public function setName($family_name, $given_name = "", $additional_names = "", $honorific_prefixes = "", $honorific_suffixes = "")
    {
        $familynames = &$this->explodeVar($family_name);
        $givennames = &$this->explodeVar($given_name);
        $addnames = &$this->explodeVar($additional_names);
        $prefixes = &$this->explodeVar($honorific_prefixes);
        $suffixes = &$this->explodeVar($honorific_suffixes);

        $this->types["N"] =
            join(",", $familynames) .
            ";" .
            join(",", $givennames) .
            ";" .
            join(",", $addnames) .
            ";" .
            join(",", $prefixes) .
            ";" .
            join(",", $suffixes);

        $this->filename = "$given_name" . "_" . "$family_name" . ".vcf";
        if (strcmp($this->types["FN"], "") == 0) {
            $fn = trim("$honorific_prefixes $given_name $additional_names $family_name $honorific_suffixes");
            $fn = preg_replace("/\s{2,10}/", " ", $fn);
            $this->setFormattedName($fn);
        }
    }

    public function setNickname($nickname)
    {
        $nicknames = &$this->explodeVar($nickname);
        $this->types["NICKNAME"] = join(",", $nicknames);
    }
    
    public function setPhoto($photo, $type = "")
    {
        $value = "";
        $encoding = "";
        if (preg_match("/^http/", $photo)) {
            $value = $this->encode($photo);
        } else {
            $encoding = "b";
            $photo = base64_encode($photo);
        }
        $this->types["PHOTO"] = array(
            "VALUE" => $value,
            "TYPE" => $type,
            "ENCODING" => $encoding,
            "PHOTO" => $photo
        );
    }

    public function setBirthday($year, $month, $day)
    {
        if (($year < 1) or ($day < 1) or ($month < 1)) {
            $this->types["BDAY"] = "";
        } else {
            $this->types["BDAY"] = sprintf("%04d-%02d-%02d", $year, $month, $day);
        }
    }
    
    // Delivery Addressing Types
//
    // These types are concerned with information related to the delivery
    // addressing or label for the vCard object.

    public function setAddress(
        $po_box = "",
        $extended_address = "",
        $street_address = "",
        $locality = "",
        $region = "",
        $postal_code = "",
        $country = "",
        $type = ADR_TYPE_NONE
    ) {
        if ($type == ADR_TYPE_NONE) {
            $type = ADR_TYPE_INTL + ADR_TYPE_POSTAL + ADR_TYPE_PARCEL + ADR_TYPE_WORK;
        }
        $po_box = join(",", $this->explodeVar($po_box));
        $extended_address = join(",", $this->explodeVar($extended_address));
        $street_address = join(",", $this->explodeVar($street_address));
        $locality = join(",", $this->explodeVar($locality));
        $region = join(",", $this->explodeVar($region));
        $postal_code = join(",", $this->explodeVar($postal_code));
        $country = join(",", $this->explodeVar($country));
        array_push($this->types["ADR"], array(
            "POBOX" => $po_box,
            "EXTENDED_ADDRESS" => $extended_address,
            "STREET_ADDRESS" => $street_address,
            "LOCALITY" => $locality,
            "REGION" => $region,
            "POSTAL_CODE" => $postal_code,
            "COUNTRY" => $country,
            "TYPE" => $type
        ));
    }
    
    public function setLabel($label = "", $type = ADR_TYPE_NONE)
    {
        if ($type == ADR_TYPE_NONE) {
            $type = ADR_TYPE_INTL + ADR_TYPE_POSTAL + ADR_TYPE_PARCEL + ADR_TYPE_WORK;
        }
        $this->types["LABEL"] = array(
            "LABEL" => $this->escape($label),
            "TYPE" => $type
        );
    }

    // Telecommunications Addressing Types
//
    // These types are concerned with information associated with the
    // telecommunications addressing of the object the vCard represents.
    
    public function setPhone($number = "", $type = TEL_TYPE_VOICE)
    {
        array_push($this->types["TEL"], array(
            "TEL" => $this->escape($number),
            "TYPE" => $type
        ));
    }
    
    public function setEmail($address = "", $type = EMAIL_TYPE_INTERNET)
    {
        array_push($this->types["EMAIL"], array(
            "EMAIL" => $this->escape($address),
            "TYPE" => $type
        ));
    }
    
    public function setMailer($name = "")
    {
        $this->types["MAILER"] = $this->escape($name);
    }
    
    // Geographical Types
//
    // These types are concerned with information associated with
    // geographical positions or regions associated with the object the
    // vCard represents.

    public function setTimezone($zone = "")
    {
        $this->types["TZ"] = $this->escape($zone);
    }
    
    public function setPosition($latitude = "", $longitude = "")
    {
        $this->types["GEO"] = array(
            "LAT" => $latitude,
            "LON" => $longitude
        );
    }
    
    // Organizational Types
//
    // These types are concerned with information associated with
    // characteristics of the organization or organizational units of the
    // object the vCard represents.

    public function setTitle($title = "")
    {
        $this->types["TITLE"] = $this->escape($title);
    }
    
    public function setRole($role = "")
    {
        $this->types["ROLE"] = $this->escape($role);
    }
    
    public function setLogo($logo, $type = "")
    {
        $value = "";
        $encoding = "";
        if (preg_match("/^http/", $logo)) {
            $value = $this->encode($logo);
        } else {
            $encoding = "b";
            $logo = base64_encode($logo);
        }
        $this->types["LOGO"] = array(
            "VALUE" => $value,
            "TYPE" => $type,
            "ENCODING" => $encoding,
            "LOGO" => $logo
        );
    }
    
    public function setAgent($agent = "")
    {
        $this->types["AGENT"] = $this->escape($agent);
    }
    
    public function setOrganization($organization = "")
    {
        $organization = join(";", $this->explodeVar($organization, ";"));
        $this->types["ORG"] = $organization;
    }
    
    // Explanatory Types
//
    // These types are concerned with additional explanations, such as that
    // related to informational notes or revisions specific to the vCard.

    public function setCategories($categories)
    {
        $categories = join(",", $this->explodeVar($categories));
        $this->types["CATEGORIES"] = $categories;
    }
    
    public function setNote($note = "")
    {
        $this->types["NOTE"] = $this->escape($note);
    }
    
    public function setProductId($product_id = "")
    {
        $this->types["PRODID"] = $this->escape($product_id);
    }
    
    public function setRevision($revision_date = "")
    {
        $this->types["REV"] = $this->escape($revision_date);
    }
    
    public function setSortString($string = "")
    {
        $this->types["SORT-STRING"] = $this->escape($string);
    }
    
    public function setSound($sound = "", $type = "")
    {
        $value = "";
        $encoding = "";
        if (preg_match("/^http/", $sound)) {
            $value = $this->encode($sound);
        } else {
            $encoding = "b";
            $sound = base64_encode($sound);
        }
        $this->types["SOUND"] = array(
            "VALUE" => $value,
            "TYPE" => $type,
            "ENCODING" => $encoding,
            "SOUND" => $sound
        );
    }
    
    public function setUID($uid = "", $type = "")
    {
        $this->types["UID"] = array(
            "UID" => $this->escape($uid),
            "TYPE" => $type
        );
    }
    
    public function setURL($uri = "")
    {
        $this->types["URL"] = $this->escape($uri);
    }
    
    public function setVersion($version = "3.0")
    {
        $this->types["VERSION"] = $version;
    }
    
    // Security Types
//
    // These types are concerned with the security of communication pathways
    // or access to the vCard.

    public function setClassification($classification = "")
    {
        $this->types["CLASS"] = $this->escape($classification);
    }
    
    public function setKey($key = "", $type = "")
    {
        $encoding = "b";
        $key = base64_encode($key);
        $this->types["KEY"] = array(
            "KEY" => $key,
            "TYPE" => $type,
            "ENCODING" => $encoding
        );
    }
    
    public function getFilename()
    {
        if (strcmp($this->filename, "") == 0) {
            return "vcard.vcf";
        } else {
            return $this->filename;
        }
    }
    
    public function getMimetype()
    {
        return "text/x-vcard";
    }
}