inc/vcard.php

   1 <?php
   2 /**
   3 * Extend the vComponent to specifically handle VCARD resources
   4 */
   5
   6 require_once('AwlQuery.php');
   7 require_once('vComponent.php');
   8
   9 class VCard extends vComponent {
  10
  11   /**
  12 CREATE TABLE addressbook_resource (
  13   dav_id INT8 NOT NULL REFERENCES caldav_data(dav_id) ON UPDATE CASCADE ON DELETE CASCADE PRIMARY KEY,
  14   version TEXT,
  15   uid TEXT,
  16   nickname TEXT,
  17   fn TEXT, -- fullname
  18   n TEXT, -- Name Surname;First names
  19   note TEXT,
  20   org TEXT,
  21   url TEXT,
  22   fburl TEXT,
  23   caluri TEXT
  24 );
  25   */
  26   function Write( $dav_id, $exists = true ) {
  27     $qry = new AwlQuery();
  28
  29     // Only run a local transaction if we're not in one already.
  30     $in_transaction = ($qry->TransactionState() == 1);
  31     if ( ! $in_transaction ) $qry->Begin();
  32
  33     if ( $exists ) {
  34       $sql = 'UPDATE addressbook_resource SET version=:version, uid=:uid, nickname=:nickname, fn=:fn, n=:name,
  35 note=:note, org=:org, url=:url, fburl=:fburl, caladruri=:caladruri, caluri=:caluri WHERE dav_id=:dav_id';
  36     }
  37     else {
  38       $sql = 'INSERT INTO addressbook_resource ( dav_id, version, uid, nickname, fn, n, note, org, url, fburl, caladruri, caluri )
  39 VALUES( :dav_id, :version, :uid, :nickname, :fn, :name, :note, :org, :url, :fburl, :caladruri, :caluri )';
  40     }
  41
  42     $params = array( ':dav_id' => $dav_id );
  43
  44     $wanted = array('VERSION' => true, 'UID' => true, 'NICKNAME' => true, 'FN' => true, 'N' => true,
  45                     'NOTE'=> true, 'ORG' => true, 'URL' => true, 'FBURL' => true, 'CALADRURI' => true, 'CALURI' => true);
  46     $properties = $this->GetProperties( $wanted );
  47     foreach( $wanted AS $k => $v ) {
  48       $pname = ':' . strtolower($k);
  49       if ( $pname == ':n' ) $pname = ':name';
  50       $params[$pname] = null;
  51     }
  52     foreach( $properties AS $k => $v ) {
  53       $pname = ':' . strtolower($v->Name());
  54       if ( $pname == ':n' ) $pname = ':name';
  55       if ( !isset($params[$pname]) /** @todo or this is one is in the user's language */ ) $params[$pname] = $v->Value();
  56     }
  57
  58     $qry->QDo( $sql, $params );
  59
  60     $this->WriteAddresses($dav_id);
  61     $this->WritePhones($dav_id);
  62     $this->WriteEmails($dav_id);
  63
  64     if ( ! $in_transaction ) $qry->Commit();
  65   }
  66
  67
  68   /**
  69 CREATE TABLE addressbook_address_adr (
  70   dav_id INT8 NOT NULL REFERENCES caldav_data(dav_id) ON UPDATE CASCADE ON DELETE CASCADE,
  71   type TEXT,
  72   box_no TEXT,
  73   unit_no TEXT,
  74   street_address TEXT,
  75   locality TEXT,
  76   region TEXT,
  77   postcode TEXT,
  78   country TEXT,
  79   property TEXT -- The full text of the property
  80 );
  81   */
  82   function WriteAddresses( $dav_id ) {
  83     $addresses = $this->GetProperties('ADR');
  84     $qry = new AwlQuery();
  85
  86     // Only run a local transaction if we're not in one already.
  87     $in_transaction = ($qry->TransactionState() == 1);
  88     if ( ! $in_transaction ) $qry->Begin();
  89
  90     $params = array( ':dav_id' => $dav_id );
  91     $qry->QDo('DELETE FROM addressbook_address_adr WHERE dav_id = :dav_id', $params );
  92     foreach( $addresses AS $adr ) {
  93       $params[':type'] = $adr->GetParameterValue('TYPE');
  94       $address = explode(';',$adr->Value());
  95
  96       // We use @ to suppress the warnings here, because the NULL in the database suits us well.
  97       @$params[':box_no']   = $address[0];
  98       @$params[':unit_no']  = $address[1];
  99       @$params[':street_address'] = $address[2];
 100       @$params[':locality'] = $address[3];
 101       @$params[':region']   = $address[4];
 102       @$params[':postcode'] = $address[5];
 103       @$params[':country']  = $address[6];
 104       $params[':property'] = $adr->Render();
 105       $qry->QDo( 'INSERT INTO addressbook_address_adr (dav_id, type, box_no, unit_no, street_address, locality, region, postcode, country, property)
 106 VALUES( :dav_id, :type, :box_no, :unit_no, :street_address, :locality, :region, :postcode, :country, :property)', $params );
 107     }
 108     if ( ! $in_transaction ) $qry->Commit();
 109   }
 110
 111
 112   /**
 113 CREATE TABLE addressbook_address_tel (
 114   dav_id INT8 NOT NULL REFERENCES caldav_data(dav_id) ON UPDATE CASCADE ON DELETE CASCADE,
 115   type TEXT,
 116   tel TEXT,
 117   property TEXT -- The full text of the property
 118 );
 119   */
 120   function WritePhones( $dav_id ) {
 121     $telephones = $this->GetProperties('TEL');
 122     $qry = new AwlQuery();
 123
 124     // Only run a local transaction if we're not in one already.
 125     $in_transaction = ($qry->TransactionState() == 1);
 126     if ( ! $in_transaction ) $qry->Begin();
 127
 128     $params = array( ':dav_id' => $dav_id );
 129     $qry->QDo('DELETE FROM addressbook_address_tel WHERE dav_id = :dav_id', $params );
 130     foreach( $telephones AS $tel ) {
 131       $params[':type'] = $tel->GetParameterValue('TYPE');
 132       if ( ! isset($params[':type']) ) $params[':type'] = 'voice';
 133       $params[':tel'] = $tel->Value();
 134       $params[':property'] = $tel->Render();
 135       $qry->QDo( 'INSERT INTO addressbook_address_tel (dav_id, type, tel, property) VALUES( :dav_id, :type, :tel, :property)', $params );
 136     }
 137     if ( ! $in_transaction ) $qry->Commit();
 138   }
 139
 140
 141   /**
 142 CREATE TABLE addressbook_address_email (
 143   dav_id INT8 NOT NULL REFERENCES caldav_data(dav_id) ON UPDATE CASCADE ON DELETE CASCADE,
 144   type TEXT,
 145   email TEXT,
 146   property TEXT -- The full text of the property
 147 );
 148   */
 149   function WriteEmails( $dav_id ) {
 150     $emails = $this->GetProperties('EMAIL');
 151     $qry = new AwlQuery();
 152
 153     // Only run a local transaction if we're not in one already.
 154     $in_transaction = ($qry->TransactionState() == 1);
 155     if ( ! $in_transaction ) $qry->Begin();
 156
 157     $params = array( ':dav_id' => $dav_id );
 158     $qry->QDo('DELETE FROM addressbook_address_email WHERE dav_id = :dav_id', $params );
 159     foreach( $emails AS $email ) {
 160       $params[':type'] = $email->GetParameterValue('TYPE');
 161       $params[':email'] = $email->Value();
 162       $params[':property'] = $email->Render();
 163       $qry->QDo( 'INSERT INTO addressbook_address_email (dav_id, type, email, property) VALUES( :dav_id, :type, :email, :property)', $params );
 164     }
 165     if ( ! $in_transaction ) $qry->Commit();
 166   }
 167
 168 }