[Summary view] [Print] [Text view]

   1  <?php // $Id: iCalendar_parameters.php,v 1.7 2005/07/21 23:17:21 defacer Exp $
   2  
   3  class iCalendar_parameter {
   4      function multiple_values_allowed($parameter) {
   5          switch($parameter) {
   6              case 'DELEGATED-FROM':
   7              case 'DELEGATED-TO':
   8              case 'MEMBER':
   9                  return true;
  10              default:
  11                  return false;
  12          }
  13      }
  14  
  15      function default_value($parameter) {
  16          switch($parameter) {
  17              case 'CUTYPE':   return 'INDIVIDUAL';
  18              case 'FBTYPE':   return 'BUSY';
  19              case 'PARTSTAT': return 'NEEDS-ACTION';
  20              case 'RELATED':  return 'START';
  21              case 'RELTYPE':  return 'PARENT';
  22              case 'ROLE':     return 'REQ-PARTICIPANT';
  23              case 'RSVP':     return 'FALSE';
  24              default:         return NULL;
  25          }
  26      }
  27  
  28      function is_valid_value(&$parent_property, $parameter, $value) {
  29          switch($parameter) {
  30              // These must all be a URI
  31              case 'ALTREP':
  32              case 'DIR':
  33                  return rfc2445_is_valid_value($value, RFC2445_TYPE_URI);
  34              break;
  35  
  36              // These must be CAL-ADDRESS, which is equivalent to URI
  37              case 'DELEGATED-FROM':
  38              case 'DELEGATED-TO':
  39              case 'MEMBER':
  40              case 'SENT-BY':
  41                  return rfc2445_is_valid_value($value, RFC2445_TYPE_CAL_ADDRESS);
  42              break;
  43  
  44              // These are textual parameters, so the MUST NOT contain double quotes
  45              case 'CN':
  46                  return (strpos($value, '"') === false);
  47              break;
  48  
  49              // These have enumerated legal values
  50              case 'CUTYPE':
  51                  $value = strtoupper($value);
  52                  return ($value == 'INDIVIDUAL' || $value == 'GROUP' || $value == 'RESOURCE' || $value == 'ROOM' || $value == 'UNKNOWN' || rfc2445_is_xname($value));
  53              break;
  54  
  55              case 'ENCODING':
  56                  $value = strtoupper($value);
  57                  return ($value == '8BIT' || $value == 'BASE64' || rfc2445_is_xname($value));
  58              break;
  59  
  60              case 'FBTYPE':
  61                  $value = strtoupper($value);
  62                  return ($value == 'FREE' || $value == 'BUSY' || $value == 'BUSY-UNAVAILABLE' || $value == 'BUSY-TENTATIVE' || rfc2445_is_xname($value));
  63              break;
  64  
  65              case 'FMTTYPE':
  66                  $fmttypes = array(
  67                          'TEXT'        => array('PLAIN', 'RICHTEXT', 'ENRICHED', 'TAB-SEPARATED-VALUES', 'HTML', 'SGML',
  68                                                 'VND.LATEX-Z', 'VND.FMI.FLEXSTOR'),
  69                          'MULTIPART'   => array('MIXED', 'ALTERNATIVE', 'DIGEST', 'PARALLEL', 'APPLEDOUBLE', 'HEADER-SET',
  70                                                 'FORM-DATA', 'RELATED', 'REPORT', 'VOICE-MESSAGE', 'SIGNED', 'ENCRYPTED',
  71                                                 'BYTERANGES'),
  72                          'MESSAGE'     => array('RFC822', 'PARTIAL', 'EXTERNAL-BODY', 'NEWS', 'HTTP'),
  73                          'APPLICATION' => array('OCTET-STREAM', 'POSTSCRIPT', 'ODA', 'ATOMICMAIL', 'ANDREW-INSET', 'SLATE',
  74                                                 'WITA', 'DEC-DX', 'DCA-RFT', 'ACTIVEMESSAGE', 'RTF', 'APPLEFILE',
  75                                                 'MAC-BINHEX40', 'NEWS-MESSAGE-ID', 'NEWS-TRANSMISSION', 'WORDPERFECT5.1',
  76                                                 'PDF', 'ZIP', 'MACWRITEII', 'MSWORD', 'REMOTE-PRINTING', 'MATHEMATICA',
  77                                                 'CYBERCASH', 'COMMONGROUND', 'IGES', 'RISCOS', 'ESHOP', 'X400-BP', 'SGML',
  78                                                 'CALS-1840', 'PGP-ENCRYPTED', 'PGP-SIGNATURE', 'PGP-KEYS', 'VND.FRAMEMAKER',
  79                                                 'VND.MIF', 'VND.MS-EXCEL', 'VND.MS-POWERPOINT', 'VND.MS-PROJECT',
  80                                                 'VND.MS-WORKS', 'VND.MS-TNEF', 'VND.SVD', 'VND.MUSIC-NIFF', 'VND.MS-ARTGALRY',
  81                                                 'VND.TRUEDOC', 'VND.KOAN', 'VND.STREET-STREAM', 'VND.FDF',
  82                                                 'SET-PAYMENT-INITIATION', 'SET-PAYMENT', 'SET-REGISTRATION-INITIATION',
  83                                                 'SET-REGISTRATION', 'VND.SEEMAIL', 'VND.BUSINESSOBJECTS',
  84                                                 'VND.MERIDIAN-SLINGSHOT', 'VND.XARA', 'SGML-OPEN-CATALOG', 'VND.RAPID',
  85                                                 'VND.ENLIVEN', 'VND.JAPANNET-REGISTRATION-WAKEUP', 
  86                                                 'VND.JAPANNET-VERIFICATION-WAKEUP', 'VND.JAPANNET-PAYMENT-WAKEUP',
  87                                                 'VND.JAPANNET-DIRECTORY-SERVICE', 'VND.INTERTRUST.DIGIBOX', 'VND.INTERTRUST.NNCP'),
  88                          'IMAGE'       => array('JPEG', 'GIF', 'IEF', 'G3FAX', 'TIFF', 'CGM', 'NAPLPS', 'VND.DWG', 'VND.SVF',
  89                                                 'VND.DXF', 'PNG', 'VND.FPX', 'VND.NET-FPX'),
  90                          'AUDIO'       => array('BASIC', '32KADPCM', 'VND.QCELP'),
  91                          'VIDEO'       => array('MPEG', 'QUICKTIME', 'VND.VIVO', 'VND.MOTOROLA.VIDEO', 'VND.MOTOROLA.VIDEOP')
  92                  );
  93                  $value = strtoupper($value);
  94                  if(rfc2445_is_xname($value)) {
  95                      return true;
  96                  }
  97                  @list($type, $subtype) = explode('/', $value);
  98                  if(empty($type) || empty($subtype)) {
  99                      return false;
 100                  }
 101                  if(!isset($fmttypes[$type]) || !in_array($subtype, $fmttypes[$type])) {
 102                      return false;
 103                  }
 104                  return true;
 105              break;
 106  
 107              case 'LANGUAGE':
 108                  $value = strtoupper($value);
 109                  $parts = explode('-', $value);
 110                  foreach($parts as $part) {
 111                      if(empty($part)) {
 112                          return false;
 113                      }
 114                      if(strspn($part, 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789') != strlen($part)) {
 115                          return false;
 116                      }
 117                  }
 118                  return true;
 119              break;
 120  
 121              case 'PARTSTAT':
 122                  $value = strtoupper($value);
 123                  switch($parent_property->parent_component) {
 124                      case 'VEVENT':
 125                          return ($value == 'NEEDS-ACTION' || $value == 'ACCEPTED' || $value == 'DECLINED' || $value == 'TENTATIVE'
 126                                  || $value == 'DELEGATED' || rfc2445_is_xname($value));
 127                      break;
 128                      case 'VTODO':
 129                          return ($value == 'NEEDS-ACTION' || $value == 'ACCEPTED' || $value == 'DECLINED' || $value == 'TENTATIVE'
 130                                  || $value == 'DELEGATED' || $value == 'COMPLETED' || $value == 'IN-PROCESS' || rfc2445_is_xname($value));
 131                      break;
 132                      case 'VJOURNAL':
 133                          return ($value == 'NEEDS-ACTION' || $value == 'ACCEPTED' || $value == 'DECLINED' || rfc2445_is_xname($value));
 134                      break;
 135                  }
 136                  return false;
 137              break;
 138  
 139              case 'RANGE':
 140                  $value = strtoupper($value);
 141                  return ($value == 'THISANDPRIOR' || $value == 'THISANDFUTURE');
 142              break;
 143  
 144              case 'RELATED':
 145                  $value = strtoupper($value);
 146                  return ($value == 'START' || $value == 'END');
 147              break;
 148  
 149              case 'RELTYPE':
 150                  $value = strtoupper($value);
 151                  return ($value == 'PARENT' || $value == 'CHILD' || $value == 'SIBLING' || rfc2445_is_xname($value));
 152              break;
 153  
 154              case 'ROLE':
 155                  $value = strtoupper($value);
 156                  return ($value == 'CHAIR' || $value == 'REQ-PARTICIPANT' || $value == 'OPT-PARTICIPANT' || $value == 'NON-PARTICIPANT' || rfc2445_is_xname($value));
 157              break;
 158  
 159              case 'RSVP':
 160                  $value = strtoupper($value);
 161                  return ($value == 'TRUE' || $value == 'FALSE');
 162              break;
 163  
 164              case 'TZID':
 165                  if(empty($value)) {
 166                      return false;
 167                  }
 168                  return (strcspn($value, '";:,') == strlen($value));
 169              break;
 170  
 171              case 'VALUE':
 172                  $value = strtoupper($value);
 173                  return ($value == 'BINARY'    || $value == 'BOOLEAN'    || $value == 'CAL-ADDRESS' || $value == 'DATE'    ||
 174                          $value == 'DATE-TIME' || $value == 'DURATION'   || $value == 'FLOAT'       || $value == 'INTEGER' ||
 175                          $value == 'PERIOD'    || $value == 'RECUR'      || $value == 'TEXT'        || $value == 'TIME'    ||
 176                          $value == 'URI'       || $value == 'UTC-OFFSET' || rfc2445_is_xname($value));
 177              break;
 178          }
 179      }
 180  
 181      function do_value_formatting($parameter, $value) {
 182          switch($parameter) {
 183              // Parameters of type CAL-ADDRESS or URI MUST be double-quoted
 184              case 'ALTREP':
 185              case 'DIR':
 186              case 'DELEGATED-FROM':
 187              case 'DELEGATED-TO':
 188              case 'MEMBER':
 189              case 'SENT-BY':
 190                  return '"'.$value.'"';
 191              break;
 192  
 193              // Textual parameter types must be double quoted if they contain COLON, SEMICOLON
 194              // or COMMA. Quoting always sounds easier and standards-conformant though.
 195              case 'CN':
 196                  return '"'.$value.'"';
 197              break;
 198  
 199              // Parameters with enumerated legal values, just make them all caps
 200              case 'CUTYPE':
 201              case 'ENCODING':
 202              case 'FBTYPE':
 203              case 'FMTTYPE':
 204              case 'LANGUAGE':
 205              case 'PARTSTAT':
 206              case 'RANGE':
 207              case 'RELATED':
 208              case 'RELTYPE':
 209              case 'ROLE':
 210              case 'RSVP':
 211              case 'VALUE':
 212                  return strtoupper($value);
 213              break;
 214  
 215              // Parameters we shouldn't be messing with
 216              case 'TZID':
 217                  return $value;
 218              break;
 219          }
 220      }
 221  
 222      function undo_value_formatting($parameter, $value) {
 223      }
 224  
 225  }
 226  
 227  ?>