The CalDAV scheduling inbox. More...

Inheritance diagram for Sabre\CalDAV\Schedule\Inbox:

Collaboration diagram for Sabre\CalDAV\Schedule\Inbox:

Public Member Functions
	__construct (Backend\SchedulingSupport $caldavBackend, $principalUri)
	Constructor. More...

	getName ()
	Returns the name of the node. More...

	getChildren ()
	Returns an array with all the child nodes. More...

	createFile ($name, $data=null)
	Creates a new file in the directory. More...

	getOwner ()
	Returns the owner principal. More...

	getACL ()
	Returns a list of ACE's for this node. More...

	calendarQuery (array $filters)
	Performs a calendar-query on the contents of this calendar. More...

Public Member Functions inherited from Sabre\DAV\Collection
	getChild ($name)
	Returns a child object, by its name. More...

	childExists ($name)
	Checks is a child-node exists. More...

	createFile ($name, $data=null)
	Creates a new file in the directory. More...

	createDirectory ($name)
	Creates a new subdirectory. More...

Public Member Functions inherited from Sabre\DAV\Node
	getLastModified ()
	Returns the last modification time as a unix timestamp. More...

	delete ()
	Deletes the current node. More...

	setName ($name)
	Renames the node. More...

Public Member Functions inherited from Sabre\DAVACL\IACL
	getGroup ()
	Returns a group principal. More...

	setACL (array $acl)
	Updates the ACL. More...

	getSupportedPrivilegeSet ()
	Returns the list of supported privileges for this node. More...

Protected Attributes
	$caldavBackend

	$principalUri

Detailed Description

The CalDAV scheduling inbox.

Copyright: Copyright (C) fruux GmbH (https://fruux.com/)

Author: Evert Pot (http://evertpot.com/) http://sabre.io/license/ Modified BSD License

Definition at line 18 of file Inbox.php.

Constructor & Destructor Documentation

◆ __construct()

Sabre\CalDAV\Schedule\Inbox::__construct	(	Backend\SchedulingSupport	$caldavBackend,
			$principalUri
	)

Constructor.

Parameters

Backend\SchedulingSupport	$caldavBackend
string	$principalUri

Definition at line 42 of file Inbox.php.

References Sabre\CalDAV\Schedule\Inbox\$caldavBackend, and Sabre\CalDAV\Schedule\Inbox\$principalUri.

                                                                                   {
 
         $this->caldavBackend = $caldavBackend;
         $this->principalUri = $principalUri;
 
     }

Member Function Documentation

◆ calendarQuery()

Sabre\CalDAV\Schedule\Inbox::calendarQuery ( array $filters )

Performs a calendar-query on the contents of this calendar.

The calendar-query is defined in RFC4791 : CalDAV. Using the calendar-query it is possible for a client to request a specific set of object, based on contents of iCalendar properties, date-ranges and iCalendar component types (VTODO, VEVENT).

This method should just return a list of (relative) urls that match this query.

The list of filters are specified as an array. The exact array is documented by .

Parameters

array $filters

Returns: array

Implements Sabre\CalDAV\ICalendarObjectContainer.

Definition at line 184 of file Inbox.php.

References $result, and Sabre\VObject\Reader\read().

                                            {
 
         $result = [];
         $validator = new CalDAV\CalendarQueryValidator();
 
         $objects = $this->caldavBackend->getSchedulingObjects($this->principalUri);
         foreach ($objects as $object) {
             $vObject = VObject\Reader::read($object['calendardata']);
             if ($validator->validate($vObject, $filters)) {
                 $result[] = $object['uri'];
             }
 
             // Destroy circular references to PHP will GC the object.
             $vObject->destroy();
         }
         return $result;
 
     }

Here is the call graph for this function:

◆ createFile()

Sabre\CalDAV\Schedule\Inbox::createFile	(	$name,
		$data = `null`
	)

Creates a new file in the directory.

Data will either be supplied as a stream resource, or in certain cases as a string. Keep in mind that you may have to support either.

After successful creation of the file, you may choose to return the ETag of the new file here.

The returned ETag must be surrounded by double-quotes (The quotes should be part of the actual string).

If you cannot accurately determine the ETag, you should not return it. If you don't store the file exactly as-is (you're transforming it somehow) you should also not return an ETag.

This means that if a subsequent GET to this new file does not exactly return the same contents of what was submitted here, you are strongly recommended to omit the ETag.

Parameters

string	$name	Name of the file
resource \| string	$data	Initial payload

Returns: null|string

Implements Sabre\DAV\ICollection.

Definition at line 104 of file Inbox.php.

References $data, and $name.

                                              {
 
         $this->caldavBackend->createSchedulingObject($this->principalUri, $name, $data);
 
     }

◆ getACL()

Sabre\CalDAV\Schedule\Inbox::getACL ( )

Returns a list of ACE's for this node.

Each ACE has the following properties:

'privilege', a string such as {DAV:}read or {DAV:}write. These are currently the only supported privileges
'principal', a url to the principal who owns the node
'protected' (optional), indicating that this ACE is not allowed to be updated.

Returns: array

Implements Sabre\DAVACL\IACL.

Definition at line 135 of file Inbox.php.

References Sabre\CalDAV\Schedule\Inbox\getOwner(), and Sabre\CalDAV\Plugin\NS_CALDAV.

                       {
 
         return [
             [
                 'privilege' => '{DAV:}read',
                 'principal' => '{DAV:}authenticated',
                 'protected' => true,
             ],
             [
                 'privilege' => '{DAV:}write-properties',
                 'principal' => $this->getOwner(),
                 'protected' => true,
             ],
             [
                 'privilege' => '{DAV:}unbind',
                 'principal' => $this->getOwner(),
                 'protected' => true,
             ],
             [
                 'privilege' => '{DAV:}unbind',
                 'principal' => $this->getOwner() . '/calendar-proxy-write',
                 'protected' => true,
             ],
             [
                 'privilege' => '{' . CalDAV\Plugin::NS_CALDAV . '}schedule-deliver',
                 'principal' => '{DAV:}authenticated',
                 'protected' => true,
             ],
         ];
 
     }

Here is the call graph for this function:

◆ getChildren()

Sabre\CalDAV\Schedule\Inbox::getChildren ( )

Returns an array with all the child nodes.

Returns: []

Implements Sabre\DAV\ICollection.

Definition at line 67 of file Inbox.php.

References Sabre\CalDAV\Schedule\Inbox\$principalUri.

                            {
 
         $objs = $this->caldavBackend->getSchedulingObjects($this->principalUri);
         $children = [];
         foreach ($objs as $obj) {
             //$obj['acl'] = $this->getACL();
             $obj['principaluri'] = $this->principalUri;
             $children[] = new SchedulingObject($this->caldavBackend, $obj);
         }
         return $children;
 
     }

◆ getName()

Sabre\CalDAV\Schedule\Inbox::getName ( )

Returns the name of the node.

This is used to generate the url.

Returns: string

Implements Sabre\DAV\INode.

Definition at line 56 of file Inbox.php.

                        {
 
         return 'inbox';
 
     }

◆ getOwner()

Sabre\CalDAV\Schedule\Inbox::getOwner ( )

Returns the owner principal.

This must be a url to a principal, or null if there's no owner

Returns: string|null

Implements Sabre\DAVACL\IACL.

Definition at line 117 of file Inbox.php.

References Sabre\CalDAV\Schedule\Inbox\$principalUri.

Referenced by Sabre\CalDAV\Schedule\Inbox\getACL().

                         {
 
         return $this->principalUri;
 
     }

Here is the caller graph for this function:

Field Documentation

◆ $caldavBackend

Sabre\CalDAV\Schedule\Inbox::$caldavBackend

protected

Definition at line 27 of file Inbox.php.

Referenced by Sabre\CalDAV\Schedule\Inbox\__construct().

◆ $principalUri

Sabre\CalDAV\Schedule\Inbox::$principalUri

protected

Definition at line 34 of file Inbox.php.

Referenced by Sabre\CalDAV\Schedule\Inbox\__construct(), Sabre\CalDAV\Schedule\Inbox\getChildren(), and Sabre\CalDAV\Schedule\Inbox\getOwner().

The documentation for this class was generated from the following file:

libs/composer/vendor/sabre/dav/lib/CalDAV/Schedule/Inbox.php

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ calendarQuery()

◆ createFile()

◆ getACL()

◆ getChildren()

◆ getName()

◆ getOwner()

Field Documentation

◆ $caldavBackend

◆ $principalUri