[Jann Hendrik]

Dieses Tutorial erklärt die Nutzung einer (bestimmten) vCard-Klasse

Ich gehe bei diesem Tutorial explizit von der Klasse vCard PHP Parser aus, welche
bei sourceforge.net zu finden ist.

Projektseite:
sourceforge.net

download:
sourceforge.net

Zu der Lizenz sagt der Autor:

I don't have the time to read through all the licences to find out what the exactly say. But it's simple. It's free for non commercial projects, but as soon as you make money with it, i want my share

Allgemeins zu vCard:

Zitat von wikipedia

Eine vCard ist eine „elektronische Visitenkarte“, die ein Benutzer mit einem Mausklick direkt in das Adressbuch seines E-Mail-Programms übernehmen kann. vCards können in HTML-Seiten eingebettet oder als Dateianhängen zu einer E-Mail verschickt werden. Mobiltelefone und PDAs verwenden auch vCards, um Kontaktinformationen zu speichern und mit IrDA oder Bluetooth auszutauschen.

Die übliche Dateinamenserweiterung für vCard-Dateien ist *.vcf = „vCard file“.

Der Inhalt und Aufbau von vCards sind vom Internet Mail Consortium (IMC) standardisiert, und viele E-Mail-Programme können Kontaktdaten als vCard lesen und exportieren.

Quelle: wikipedia.org


Nun kann man z.B. seine online-Adress-Datenbank mit dem feature ausstatten, dass die Daten als *.vcf exportiert werden können.

Ich setze also voraus, dass die notwendigen Daten bereits in irgendeiner Form, z.B. in einer Datenbank vorliegen.

Der tar.gz liegt ein Beispiel bei.

Als erstes muss natürlich die Klassen-Datei eingebunden werden und die Klasse initialisiert werden.

PHP-Code:

<?php
  error_reporting(E_ALL & ~E_NOTICE);
  include_once 'class.vCard.inc.php';

  $vCard = new vCard('','');
?>

Dann werden die einzelnen Variablen für die verschiedenen Werte gesetzt:

PHP-Code:

<?php
  // Vorname
  $vCard->setFirstName('Erika');

  // Nachname
  $vCard->setLastName('Mustermann');

  // Straße
  $vCard->setHomeStreet('Heidestraße 17');

  // Postleitzahl
  $vCard->setHomeZIP('81739');

  // Wohnort
  $vCard->setHomeCity('München');

  // Telefon (privat)
  $vCard->setTelephoneHome1('+49 (0) 89 12345');

  // Geburtstag 12.09.1945 (YYYYMMDD)
  $vCard->setBirthday('19450912');

  // ...
?>

Weitere 37 Angaben sind noch möglich, die ich hier aber nicht alle aufführen will.
Die Beispiel-Datei nennt insgesamt:

PHP-Code:

$vCard->setFirstName('Max');
$vCard->setMiddleName('Mobil');
$vCard->setLastName('Mustermann');
$vCard->setEducationTitle('Doctor');
$vCard->setAddon('sen.');
$vCard->setNickname('Maxi');
$vCard->setCompany('Microsoft');
$vCard->setOrganisation('Linux');
$vCard->setDepartment('Product Placement');
$vCard->setJobTitle('CEO');
$vCard->setNote('Additional Note go here');
$vCard->setTelephoneWork1('+43 (05555) 000000');
$vCard->setTelephoneWork2('+43 (05555) 000000');
$vCard->setTelephoneHome1('+43 (05555) 000000');
$vCard->setTelephoneHome2('+43 (05555) 000000');
$vCard->setCellphone('+43 (05555) 000000');
$vCard->setCarphone('+43 (05555) 000000');
$vCard->setPager('+43 (05555) 000000');
$vCard->setAdditionalTelephone('+43 (05555) 000000');
$vCard->setFaxWork('+43 (05555) 000000');
$vCard->setFaxHome('+43 (05555) 000000');
$vCard->setISDN('+43 (05555) 000000');
$vCard->setPreferredTelephone('+43 (05555) 000000');
$vCard->setTelex('+43 (05555) 000000');
$vCard->setWorkStreet('123 Examplestreet');
$vCard->setWorkZIP('11111');
$vCard->setWorkCity('Testcity');
$vCard->setWorkRegion('PA');
$vCard->setWorkCountry('USA');
$vCard->setHomeStreet('123 Examplestreet');
$vCard->setHomeZIP('11111');
$vCard->setHomeCity('Testcity');
$vCard->setHomeRegion('PA');
$vCard->setHomeCountry('USA');
$vCard->setPostalStreet('123 Examplestreet');
$vCard->setPostalZIP('11111');
$vCard->setPostalCity('Testcity');
$vCard->setPostalRegion('PA');
$vCard->setPostalCountry('USA');
$vCard->setURLWork('http://flaimo.com');
$vCard->setRole('Student');
$vCard->setBirthday(time());
$vCard->setEMail('flaimo@gmx.net'); 


Zum Schluss wird die auszugebende Datei erstellt und zum download angeboten:

PHP-Code:

<?php
  $vCard->outputFile('vcf');
?>

Im Prinzip war es das schon!
Die Werte, die mit angegeben werden liegen also nun in eurer Entscheidung.

Hier nochmal das Beispiel in kompletter Form:

PHP-Code:

<?php
  error_reporting(E_ALL & ~E_NOTICE);
  include_once 'class.vCard.inc.php';

  $vCard = new vCard('','');

  // Vorname
  $vCard->setFirstName('Erika');

  // Nachname
  $vCard->setLastName('Mustermann');

  // Straße
  $vCard->setHomeStreet('Heidestraße 17');

  // Postleitzahl
  $vCard->setHomeZIP('81739');

  // Wohnort
  $vCard->setHomeCity('München');

  // Telefon (privat)
  $vCard->setTelephoneHome1('+49 (0) 89 12345');

  // Geburtstag 12.09.1945 (YYYYMMDD)
  $vCard->setBirthday('19450912');

  // ...

  $vCard->outputFile('vcf');
?>