diff --git a/docs/api/awl/caldav/CalDAVClient.html b/docs/api/awl/caldav/CalDAVClient.html new file mode 100644 index 00000000..ae6e6a04 --- /dev/null +++ b/docs/api/awl/caldav/CalDAVClient.html @@ -0,0 +1,956 @@ + + + + + + Docs For Class CalDAVClient + + + + +
+

 Class CalDAVClient

+ + +
+
Description
+ +
+ +

A class for accessing DAViCal via CalDAV, as a client

+

+ Located in /inc/caldav-client.php (line 55) +

+ + +

+	
+			
+
+ + + + +
+
Variable Summary
+ +
+
+
+  + string + $base_url +
+
+  + mixed + $body +
+
+  + mixed + $calendar +
+
+  + resource + $curl +
+
+  + mixed + $entry +
+
+  + mixed + $headers +
+
+  + mixed + $pass +
+
+  + mixed + $user +
+
+  + string + $user_agent +
+
+
+
+ + +
+
Method Summary
+ +
+
+
+  + CalDAVClient + CalDAVClient + (string $base_url, string $user, string $pass, string $calendar) +
+
+  + array + DoCalendarQuery + (string $filter, [string $relative_url = ''], [ $reponse_type = 'data'], string $report_type) +
+
+  + int + DoDELETERequest + (string $relative_url, [string $etag = null]) +
+
+  + void + DoGETRequest + (string $relative_url) +
+
+  + array + DoOptionsRequest + ([string $relative_url = ""]) +
+
+  + string + DoPUTRequest + (string $relative_url, string $icalendar, [string $etag = null]) +
+
+  + string + DoRequest + ([string $relative_url = ""]) +
+
+  + array + DoXMLRequest + ( $request_method, string $xml, [string $relative_url = ''], string $method) +
+
+  + string + GetEntryByHref + (string $href, [string $relative_url = '']) +
+
+  + array + GetEntryByUid + (uid $uid, [string $relative_url = '']) +
+
+  + array + GetEvents + (timestamp $start, timestamp $finish, [string $relative_url = '']) +
+
+  + array + GetTodos + (timestamp $start, timestamp $finish, [boolean $completed = false], [boolean $cancelled = false], [string $relative_url = ""]) +
+
+  + void + SetContentType + (int $type) +
+
+  + void + SetDepth + ([int $depth = 'infinity']) +
+
+  + void + SetMatch + (bool $match, [string $etag = '*']) +
+
+  + void + SetUserAgent + ([ $user_agent = null], int $depth) +
+
+
+
+ + +
+
Variables
+ +
+ + +
+ +
+ + + string + $base_url + (line 61) + +
+ + +

Server, username, password, calendar, $entry

+ + + + + +
+ +
+ +
+ + + mixed + $body + = "" (line 71) + +
+ + + + + + + +
+ +
+ +
+ + + mixed + $calendar + (line 61) + +
+ + + + + + + +
+ +
+ +
+ + + resource + $curl + (line 78) + +
+ + +

Our cURL connection

+ + + + + +
+ +
+ +
+ + + mixed + $entry + (line 61) + +
+ + + + + + + +
+ +
+ +
+ + + mixed + $headers + = array() (line 70) + +
+ + + + + + + +
+ +
+ +
+ + + mixed + $pass + (line 61) + +
+ + + + + + + +
+ +
+ +
+ + + mixed + $user + (line 61) + +
+ + + + + + + +
+ +
+ +
+ + + string + $user_agent + = 'DAViCalClient' (line 68) + +
+ + +

The useragent which is send to the caldav server

+ + + + + +
+ +
+
+ + +
+
Methods
+ +
+ + +
+ +
+ + Constructor CalDAVClient (line 89) +
+ + +

Constructor, initialises the class

+ +
+ CalDAVClient + + CalDAVClient + + (string $base_url, string $user, string $pass, string $calendar) +
+ +
    +
  • + string + $base_url: The URL for the calendar server
  • +
  • + string + $user: The name of the user logging in
  • +
  • + string + $pass: The password for that user
  • +
  • + string + $calendar: The name of the calendar (not currently used)
  • +
+ + +
+ +
+ +
+ + DoCalendarQuery (line 301) +
+ + +

Given XML for a calendar query, return an array of the events (/todos) in the response. Each event in the array will have a 'href', 'etag' and '$response_type' part, where the 'href' is relative to the calendar and the '$response_type' contains the definition of the calendar data in iCalendar format.

+
    +
  • return: An array of the relative URLs, etags, and events from the server. Each element of the array will be an array with 'href', 'etag' and 'data' elements, corresponding to the URL, the server-supplied etag (which only varies when the data changes) and the calendar data in iCalendar format.
  • +
+ +
+ array + + DoCalendarQuery + + (string $filter, [string $relative_url = ''], [ $reponse_type = 'data'], string $report_type) +
+ +
    +
  • + string + $filter: XML fragment which is the <filter> element of a calendar-query
  • +
  • + string + $relative_url: The URL relative to the base_url specified when the calendar was opened. Default ''.
  • +
  • + string + $report_type: Used as a name for the array element containing the calendar data. @deprecated
  • +
  • + + $reponse_type
  • +
+ + +
+ +
+ +
+ + DoDELETERequest (line 274) +
+ + +

DELETE a text/icalendar resource

+
    +
  • return: The HTTP Result Code for the DELETE
  • +
+ +
+ int + + DoDELETERequest + + (string $relative_url, [string $etag = null]) +
+ +
    +
  • + string + $relative_url: The URL to make the request to, relative to $base_url
  • +
  • + string + $etag: The etag of an existing resource to be deleted, or '*' for any resource at that URL.
  • +
+ + +
+ +
+ +
+ + DoGETRequest (line 229) +
+ + +

Get a single item from the server.

+ +
+ void + + DoGETRequest + + (string $relative_url) +
+ +
    +
  • + string + $relative_url: The part of the URL after the calendar
  • +
+ + +
+ +
+ +
+ + DoOptionsRequest (line 192) +
+ + +

Send an OPTIONS request to the server

+
    +
  • return: The allowed options
  • +
+ +
+ array + + DoOptionsRequest + + ([string $relative_url = ""]) +
+ +
    +
  • + string + $relative_url: The URL to make the request to, relative to $base_url
  • +
+ + +
+ +
+ +
+ + DoPUTRequest (line 246) +
+ + +

PUT a text/icalendar resource, returning the etag

+
    +
  • return: The content of the response from the server
  • +
+ +
+ string + + DoPUTRequest + + (string $relative_url, string $icalendar, [string $etag = null]) +
+ +
    +
  • + string + $relative_url: The URL to make the request to, relative to $base_url
  • +
  • + string + $icalendar: The iCalendar resource to send to the server
  • +
  • + string + $etag: The etag of an existing resource to be overwritten, or '*' for a new resource.
  • +
+ + +
+ +
+ +
+ + DoRequest (line 151) +
+ + +

Send a request to the server

+
    +
  • return: The content of the response from the server
  • +
+ +
+ string + + DoRequest + + ([string $relative_url = ""]) +
+ +
    +
  • + string + $relative_url: The URL to make the request to, relative to $base_url
  • +
+ + +
+ +
+ +
+ + DoXMLRequest (line 213) +
+ + +

Send an XML request to the server (e.g. PROPFIND, REPORT, MKCALENDAR)

+
    +
  • return: An array of the allowed methods
  • +
+ +
+ array + + DoXMLRequest + + ( $request_method, string $xml, [string $relative_url = ''], string $method) +
+ +
    +
  • + string + $method: The method (PROPFIND, REPORT, etc) to use with the request
  • +
  • + string + $xml: The XML to send along with the request
  • +
  • + string + $relative_url: The URL to make the request to, relative to $base_url
  • +
  • + + $request_method
  • +
+ + +
+ +
+ +
+ + GetEntryByHref (line 457) +
+ + +

Get the calendar entry by HREF

+
    +
  • return: The iCalendar of the calendar entry
  • +
+ +
+ string + + GetEntryByHref + + (string $href, [string $relative_url = '']) +
+ +
    +
  • + string + $href: The href from a call to GetEvents or GetTodos etc.
  • +
  • + string + $relative_url: The URL relative to the base_url specified when the calendar was opened. Default ''.
  • +
+ + +
+ +
+ +
+ + GetEntryByUid (line 430) +
+ + +

Get the calendar entry by UID

+
    +
  • return: An array of the relative URL, etag, and calendar data returned from DoCalendarQuery() @see DoCalendarQuery()
  • +
+ +
+ array + + GetEntryByUid + + (uid $uid, [string $relative_url = '']) +
+ +
    +
  • + string + $relative_url: The URL relative to the base_url specified when the calendar was opened. Default ''.
  • +
  • + uid + $uid
  • +
+ + +
+ +
+ +
+ + GetEvents (line 360) +
+ + +

Get the events in a range from $start to $finish. The dates should be in the

+

format yyyymmddThhmmssZ and should be in GMT. The events are returned as an array of event arrays. Each event array will have a 'href', 'etag' and 'event' part, where the 'href' is relative to the calendar and the event contains the definition of the event in iCalendar format.

+
    +
  • return: An array of the relative URLs, etags, and events, returned from DoCalendarQuery() @see DoCalendarQuery()
  • +
+ +
+ array + + GetEvents + + (timestamp $start, timestamp $finish, [string $relative_url = '']) +
+ +
    +
  • + timestamp + $start: The start time for the period
  • +
  • + timestamp + $finish: The finish time for the period
  • +
  • + string + $relative_url: The URL relative to the base_url specified when the calendar was opened. Default ''.
  • +
+ + +
+ +
+ +
+ + GetTodos (line 393) +
+ + +

Get the todo's in a range from $start to $finish. The dates should be in the

+

format yyyymmddThhmmssZ and should be in GMT. The events are returned as an array of event arrays. Each event array will have a 'href', 'etag' and 'event' part, where the 'href' is relative to the calendar and the event contains the definition of the event in iCalendar format.

+
    +
  • return: An array of the relative URLs, etags, and events, returned from DoCalendarQuery() @see DoCalendarQuery()
  • +
+ +
+ array + + GetTodos + + (timestamp $start, timestamp $finish, [boolean $completed = false], [boolean $cancelled = false], [string $relative_url = ""]) +
+ +
    +
  • + timestamp + $start: The start time for the period
  • +
  • + timestamp + $finish: The finish time for the period
  • +
  • + boolean + $completed: Whether to include completed tasks
  • +
  • + boolean + $cancelled: Whether to include cancelled tasks
  • +
  • + string + $relative_url: The URL relative to the base_url specified when the calendar was opened. Default ''.
  • +
+ + +
+ +
+ +
+ + SetContentType (line 139) +
+ + +

Add a Content-type: header.

+ +
+ void + + SetContentType + + (int $type) +
+ +
    +
  • + int + $type: The content type
  • +
+ + +
+ +
+ +
+ + SetDepth (line 120) +
+ + +

Add a Depth: header. Valid values are 1 or infinity

+ +
+ void + + SetDepth + + ([int $depth = 'infinity']) +
+ +
    +
  • + int + $depth: The depth, default to infinity
  • +
+ + +
+ +
+ +
+ + SetMatch (line 111) +
+ + +

Adds an If-Match or If-None-Match header

+ +
+ void + + SetMatch + + (bool $match, [string $etag = '*']) +
+ +
    +
  • + bool + $match: to Match or Not to Match, that is the question!
  • +
  • + string + $etag: The etag to match / not match against.
  • +
+ + +
+ +
+ +
+ + SetUserAgent (line 129) +
+ + +

Add a Depth: header. Valid values are 1 or infinity

+ +
+ void + + SetUserAgent + + ([ $user_agent = null], int $depth) +
+ +
    +
  • + int + $depth: The depth, default to infinity
  • +
  • + + $user_agent
  • +
+ + +
+ +
+
+ + +

+ Documentation generated on Sun, 19 Oct 2008 21:25:37 +1300 by phpDocumentor 1.3.2 +

+
+ \ No newline at end of file diff --git a/docs/api/awl/caldav/_inc---caldav-client.php.html b/docs/api/awl/caldav/_inc---caldav-client.php.html new file mode 100644 index 00000000..e61bd398 --- /dev/null +++ b/docs/api/awl/caldav/_inc---caldav-client.php.html @@ -0,0 +1,142 @@ + + + + + + Docs for page caldav-client.php + + + + +
+

File/inc/caldav-client.php

+ + +
+
Description
+ +
+ +

A Class for connecting to a caldav server

+ + +
+
+ + +
+
Classes
+ +
+ + + + + + + + + +
ClassDescription
+  class + CalDAVClient + + A class for accessing DAViCal via CalDAV, as a client +
+
+
+ + + + + +
+
Functions
+ +
+ +
+ +
+ + __curl_init_callback (line 24) +
+ + +

I bet you find this hard to believe, but having to write this hack really annoys the crap out of me. WTF! Why does PHP/Curl not have a function which simply accepts a string as what the request will contain. Oh no. They only think of "POST" and "PUT a file". Crap.

+

So the following PoS code accepts that it will be called, and asked for $length bites of the $fd (which we ignore, because we get it all from the $_...data variable) and so it will eat it's way through the data.

+
+ void + + __curl_init_callback + + ( $data) +
+ +
    +
  • + + $data
  • +
+ + +
+ +
+ +
+ + __curl_read_callback (line 34) +
+ + +

As documented in the comments on this page(!)

+

http://nz2.php.net/curl_setopt

+
+ void + + __curl_read_callback + + ( $ch,  $fd,  $length) +
+ +
    +
  • + + $ch
  • +
  • + + $fd
  • +
  • + + $length
  • +
+ + +
+
+
+ +

+ Documentation generated on Sun, 19 Oct 2008 21:25:37 +1300 by phpDocumentor 1.3.2 +

+
+ \ No newline at end of file diff --git a/docs/api/davical/_inc---always.php.html b/docs/api/davical/_inc---always.php.html new file mode 100644 index 00000000..ba03b525 --- /dev/null +++ b/docs/api/davical/_inc---always.php.html @@ -0,0 +1,284 @@ + + + + + + Docs for page always.php + + + + +
+

File/inc/always.php

+ + +
+
Description
+ +
+ + + +
+
+ + + +
+
Includes
+ +
+ +
+ +
+  + + include_once + ("/etc/davical/config.php") + (line 71) + +
+ + + +
+ +
+ +
+  + + include_once + ("/etc/rscds/".$_SERVER['SERVER_NAME']."-conf.php") + (line 68) + +
+ + + +
+ +
+ +
+  + + include_once + ("../config/config.php") + (line 74) + +
+ + + +
+ +
+ +
+  + + include_once + ("davical_configuration_missing.php") + (line 77) + +
+ + + +
+ +
+ +
+  + + include_once + ("/etc/davical/".$_SERVER['SERVER_NAME']."-conf.php") + (line 65) + +
+ + +

We use @file_exists because things like open_basedir might noisily deny access which could break DAViCal completely by causing output to start too early.

+ +
+ +
+ +
+  + + include_once + ("PgQuery.php") + (line 114) + +
+ + +

Force the domain name to what was in the configuration file

+ +
+ +
+ +
+  + + require_once + ("AWLUtilities.php") + (line 43) + +
+ + + +
+
+
+ + + + +
+
Functions
+ +
+ +
+ +
+ + ConstructURL (line 231) +
+ + +

Construct a URL from the supplied dav_name

+
+ void + + ConstructURL + + (string $partial_path) +
+ +
    +
  • + string + $partial_path: The part of the path after the script name
  • +
+ + +
+ +
+ +
+ + getStatusMessage (line 175) +
+ + +

Return the HTTP status code description for a given code. Hopefully this is an efficient way to code this.

+
    +
  • return: The text for a give HTTP status code, in english
  • +
+
+ string + + getStatusMessage + + ( $status) +
+ +
    +
  • + + $status
  • +
+ + +
+ +
+ +
+ + getUserByID (line 154) +
+ + +

Return a user record identified by a user_no, caching it for any subsequent lookup

+
+ void + + getUserByID + + (int $user_no, [boolean $use_cache = true]) +
+ +
    +
  • + int + $user_no: The ID of the record to retrieve
  • +
  • + boolean + $use_cache: Whether or not to use the cache (default: yes)
  • +
+ + +
+ +
+ +
+ + getUserByName (line 133) +
+ + +

Return a user record identified by a username, caching it for any subsequent lookup

+
+ void + + getUserByName + + (string $username, [boolean $use_cache = true]) +
+ +
    +
  • + string + $username: The username of the record to retrieve
  • +
  • + boolean + $use_cache: Whether or not to use the cache (default: yes)
  • +
+ + +
+
+
+ +

+ Documentation generated on Sun, 19 Oct 2008 21:25:36 +1300 by phpDocumentor 1.3.2 +

+
+ \ No newline at end of file