Introduction

Introduction – Construit et récupère des blocs de texte vCard 2.1 et 3.0.

Description de Contact_Vcard_Build

Permet de créer une vCard, version 2.1 ou 3.0, et de récupérer le texte vCard.

Instructions

  • Téléchargez et décompressez Contact_Vcard_Build depuis l'archive PEAR.

  • Incluez le fichier Contact_Vcard_Build.php dans votre script PHP.

  • Instanciez un nouvel objet Contact_Vcard_Build (par défaut, la version vCard est 3.0, mais les vCards 2.1 sont également supportées).

  • Définissez ou ajoutez des valeurs et des paramètres que vous désirez dans la vCard.

  • Récupérez la vCard complète et utilisez la fonction print_r() pour voire le résultat.

Exemple de code

<?php

// inclut le fichier de la classe
require_once 'Contact_Vcard_Build.php';

// instancie un nouvel objet
// (par défaut, en version 3.0)
$vcard = new Contact_Vcard_Build();

// définission d'un nom formaté
$vcard->setFormattedName('Bolivar Shagnasty');

// définission de la partie structurée du nom
$vcard->setName('Shagnasty''Bolivar''Odysseus',
    
'Mr.''III');

// ajout d'un email de travail. Notez que nous ajoutons la valeur
// d'abord, et le paramètre ensuite -- Contact_Vcard_Build
// est capable d'ajouter le paramètre à son emplacement correct.
$vcard->addEmail('boshag@example.com');
$vcard->addParam('TYPE''WORK');

// ajout d'un email de domicile/préféré
$vcard->addEmail('bolivar@example.net');
$vcard->addParam('TYPE''HOME');
$vcard->addParam('TYPE''PREF');

// ajout d'une adresse de travail
$vcard->addAddress('POB 101''Suite 202''123 Main',
    
'Beverly Hills''CA''90210''US');
$vcard->addParam('TYPE''WORK');

// récupération de la vCard et affichage
$text $vcard->fetch();
echo 
'<pre>';
print_r($text);
echo 
'</pre>';
?>

Differences entre vCard 2.1 et vCard 3.0

La spécification 2.1 utilise les CRLF pour terminer les lignes (\r\n). Elle permet les composants et les paramètres suivants :

  • Paramètres :

    • TYPE : parmis DOM, INTL, POSTAL, PARCEL, HOME, WORK, PREF, VOICE, FAX, MSG, CELL, PAGER, BBS, MODEM, CAR, ISDN, VIDEO, AOL, APPLELINK, ATTMAIL, CIS, EWORLD, INTERNET, IBMMAIL, MCIMAIL, POWERSHARE, PRODIGY, TLX, X400, GIF, CGM, WMF, BMP, MET, PMB, DIB, PICT, TIFF, PDF, PS, JPEG, QTIME, MPEG, MPEG2, AVI, WAVE, AIFF, PCM, X509, ou PGP.

    • ENCODING : 7BIT, 8BIT, BASE64 ou QUOTED-PRINTABLE

    • VALUE : INLINE, CONTENT-ID, CID, URL, VCARD

    • CHARSET : un des jeux de caractères ISO.

    • LANGUAGE : représente le langage, en utilisant les caractères a-z, A-Z, 0-9, et le tiret (-).

  • COmposants et méthodes

    • VERSION (setVersion())

    • FN (setFormattedName())

    • N (setName())

    • PHOTO (setPhoto())

    • BDAY (setBirthday())

    • ADR (addAddress())

    • LABEL (addLabel())

    • TEL (addTelephone())

    • EMAIL (addEmail())

    • MAILER (setMailer())

    • TZ (setTZ())

    • GEO (setGeo())

    • TITLE (setTitle())

    • ROLE (setRole())

    • LOGO (setLogo())

    • AGENT (setAgent())

    • ORG (addOrganization())

    • NOTE (setNote())

    • REV (setRevision())

    • SOUND (setSound())

    • URL (setURL())

    • KEY (setKey())

La spécification 3.0 utilisent les LF pour terminer les lignes (\n). Elle permet les composants et les paramètres suivants :

  • Paramètres :

    • TYPE : n'importe quel type de la version 2.1, ou bien n'importe quelle valeur utilisant les caractères a-z, A-Z, 0-9, et le tiret (-).

    • ENCODING : 8BIT et B ("binary").

    • VALUE : BINARY, PHONE-NUMBER, TEXT, URI, UTC-OFFSET, ou VCARD.

  • Composants et méthodes :

    • VERSION (setVersion())

    • FN (setFormattedName())

    • N (setName())

    • NAME (setSourceName())

    • SOURCE (setSource())

    • NICKNAME (addNickname())

    • PHOTO (setPhoto())

    • BDAY (setBirthday())

    • ADR (addAddress())

    • LABEL (addLabel())

    • TEL (addTelephone())

    • EMAIL (addEmail())

    • MAILER (setMailer())

    • TZ (setTZ())

    • GEO (setGeo())

    • TITLE (setTitle())

    • ROLE (setRole())

    • LOGO (setLogo())

    • AGENT (setAgent())

    • ORG (addOrganization())

    • CATEGORIES (addCategories())

    • NOTE (setNote())

    • PRODID (setProductID())

    • REV (setRevision())

    • SORT-STRING (setSortString())

    • SOUND (setSound())

    • UID (setUniqueID())

    • URL (setURL())

    • CLASS (setClass())

    • KEY (setKey())

Contact_Vcard_Build (Previous) How to use Contact_VCard_Build (Next)
Last updated: Sun, 29 Aug 2010 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

There are no user contributed notes for this page.