@@ -13,261 +13,261 @@ |
||
| 13 | 13 | */ |
| 14 | 14 | interface BackendInterface |
| 15 | 15 | { |
| 16 | - /** |
|
| 17 | - * Returns a list of calendars for a principal. |
|
| 18 | - * |
|
| 19 | - * Every project is an array with the following keys: |
|
| 20 | - * * id, a unique id that will be used by other functions to modify the |
|
| 21 | - * calendar. This can be the same as the uri or a database key. |
|
| 22 | - * * uri, which is the basename of the uri with which the calendar is |
|
| 23 | - * accessed. |
|
| 24 | - * * principaluri. The owner of the calendar. Almost always the same as |
|
| 25 | - * principalUri passed to this method. |
|
| 26 | - * |
|
| 27 | - * Furthermore it can contain webdav properties in clark notation. A very |
|
| 28 | - * common one is '{DAV:}displayname'. |
|
| 29 | - * |
|
| 30 | - * Many clients also require: |
|
| 31 | - * {urn:ietf:params:xml:ns:caldav}supported-calendar-component-set |
|
| 32 | - * For this property, you can just return an instance of |
|
| 33 | - * Sabre\CalDAV\Property\SupportedCalendarComponentSet. |
|
| 34 | - * |
|
| 35 | - * If you return {http://sabredav.org/ns}read-only and set the value to 1, |
|
| 36 | - * ACL will automatically be put in read-only mode. |
|
| 37 | - * |
|
| 38 | - * @param string $principalUri |
|
| 39 | - * |
|
| 40 | - * @return array |
|
| 41 | - */ |
|
| 42 | - public function getCalendarsForUser($principalUri); |
|
| 16 | + /** |
|
| 17 | + * Returns a list of calendars for a principal. |
|
| 18 | + * |
|
| 19 | + * Every project is an array with the following keys: |
|
| 20 | + * * id, a unique id that will be used by other functions to modify the |
|
| 21 | + * calendar. This can be the same as the uri or a database key. |
|
| 22 | + * * uri, which is the basename of the uri with which the calendar is |
|
| 23 | + * accessed. |
|
| 24 | + * * principaluri. The owner of the calendar. Almost always the same as |
|
| 25 | + * principalUri passed to this method. |
|
| 26 | + * |
|
| 27 | + * Furthermore it can contain webdav properties in clark notation. A very |
|
| 28 | + * common one is '{DAV:}displayname'. |
|
| 29 | + * |
|
| 30 | + * Many clients also require: |
|
| 31 | + * {urn:ietf:params:xml:ns:caldav}supported-calendar-component-set |
|
| 32 | + * For this property, you can just return an instance of |
|
| 33 | + * Sabre\CalDAV\Property\SupportedCalendarComponentSet. |
|
| 34 | + * |
|
| 35 | + * If you return {http://sabredav.org/ns}read-only and set the value to 1, |
|
| 36 | + * ACL will automatically be put in read-only mode. |
|
| 37 | + * |
|
| 38 | + * @param string $principalUri |
|
| 39 | + * |
|
| 40 | + * @return array |
|
| 41 | + */ |
|
| 42 | + public function getCalendarsForUser($principalUri); |
|
| 43 | 43 | |
| 44 | - /** |
|
| 45 | - * Creates a new calendar for a principal. |
|
| 46 | - * |
|
| 47 | - * If the creation was a success, an id must be returned that can be used to |
|
| 48 | - * reference this calendar in other methods, such as updateCalendar. |
|
| 49 | - * |
|
| 50 | - * The id can be any type, including ints, strings, objects or array. |
|
| 51 | - * |
|
| 52 | - * @param string $principalUri |
|
| 53 | - * @param string $calendarUri |
|
| 54 | - * |
|
| 55 | - * @return mixed |
|
| 56 | - */ |
|
| 57 | - public function createCalendar($principalUri, $calendarUri, array $properties); |
|
| 44 | + /** |
|
| 45 | + * Creates a new calendar for a principal. |
|
| 46 | + * |
|
| 47 | + * If the creation was a success, an id must be returned that can be used to |
|
| 48 | + * reference this calendar in other methods, such as updateCalendar. |
|
| 49 | + * |
|
| 50 | + * The id can be any type, including ints, strings, objects or array. |
|
| 51 | + * |
|
| 52 | + * @param string $principalUri |
|
| 53 | + * @param string $calendarUri |
|
| 54 | + * |
|
| 55 | + * @return mixed |
|
| 56 | + */ |
|
| 57 | + public function createCalendar($principalUri, $calendarUri, array $properties); |
|
| 58 | 58 | |
| 59 | - /** |
|
| 60 | - * Updates properties for a calendar. |
|
| 61 | - * |
|
| 62 | - * The list of mutations is stored in a Sabre\DAV\PropPatch object. |
|
| 63 | - * To do the actual updates, you must tell this object which properties |
|
| 64 | - * you're going to process with the handle() method. |
|
| 65 | - * |
|
| 66 | - * Calling the handle method is like telling the PropPatch object "I |
|
| 67 | - * promise I can handle updating this property". |
|
| 68 | - * |
|
| 69 | - * Read the PropPatch documentation for more info and examples. |
|
| 70 | - * |
|
| 71 | - * @param mixed $calendarId |
|
| 72 | - */ |
|
| 73 | - public function updateCalendar($calendarId, \Sabre\DAV\PropPatch $propPatch); |
|
| 59 | + /** |
|
| 60 | + * Updates properties for a calendar. |
|
| 61 | + * |
|
| 62 | + * The list of mutations is stored in a Sabre\DAV\PropPatch object. |
|
| 63 | + * To do the actual updates, you must tell this object which properties |
|
| 64 | + * you're going to process with the handle() method. |
|
| 65 | + * |
|
| 66 | + * Calling the handle method is like telling the PropPatch object "I |
|
| 67 | + * promise I can handle updating this property". |
|
| 68 | + * |
|
| 69 | + * Read the PropPatch documentation for more info and examples. |
|
| 70 | + * |
|
| 71 | + * @param mixed $calendarId |
|
| 72 | + */ |
|
| 73 | + public function updateCalendar($calendarId, \Sabre\DAV\PropPatch $propPatch); |
|
| 74 | 74 | |
| 75 | - /** |
|
| 76 | - * Delete a calendar and all its objects. |
|
| 77 | - * |
|
| 78 | - * @param mixed $calendarId |
|
| 79 | - */ |
|
| 80 | - public function deleteCalendar($calendarId); |
|
| 75 | + /** |
|
| 76 | + * Delete a calendar and all its objects. |
|
| 77 | + * |
|
| 78 | + * @param mixed $calendarId |
|
| 79 | + */ |
|
| 80 | + public function deleteCalendar($calendarId); |
|
| 81 | 81 | |
| 82 | - /** |
|
| 83 | - * Returns all calendar objects within a calendar. |
|
| 84 | - * |
|
| 85 | - * Every item contains an array with the following keys: |
|
| 86 | - * * calendardata - The iCalendar-compatible calendar data |
|
| 87 | - * * uri - a unique key which will be used to construct the uri. This can |
|
| 88 | - * be any arbitrary string, but making sure it ends with '.ics' is a |
|
| 89 | - * good idea. This is only the basename, or filename, not the full |
|
| 90 | - * path. |
|
| 91 | - * * lastmodified - a timestamp of the last modification time |
|
| 92 | - * * etag - An arbitrary string, surrounded by double-quotes. (e.g.: |
|
| 93 | - * '"abcdef"') |
|
| 94 | - * * size - The size of the calendar objects, in bytes. |
|
| 95 | - * * component - optional, a string containing the type of object, such |
|
| 96 | - * as 'vevent' or 'vtodo'. If specified, this will be used to populate |
|
| 97 | - * the Content-Type header. |
|
| 98 | - * |
|
| 99 | - * Note that the etag is optional, but it's highly encouraged to return for |
|
| 100 | - * speed reasons. |
|
| 101 | - * |
|
| 102 | - * The calendardata is also optional. If it's not returned |
|
| 103 | - * 'getCalendarObject' will be called later, which *is* expected to return |
|
| 104 | - * calendardata. |
|
| 105 | - * |
|
| 106 | - * If neither etag or size are specified, the calendardata will be |
|
| 107 | - * used/fetched to determine these numbers. If both are specified the |
|
| 108 | - * amount of times this is needed is reduced by a great degree. |
|
| 109 | - * |
|
| 110 | - * @param mixed $calendarId |
|
| 111 | - * |
|
| 112 | - * @return array |
|
| 113 | - */ |
|
| 114 | - public function getCalendarObjects($calendarId); |
|
| 82 | + /** |
|
| 83 | + * Returns all calendar objects within a calendar. |
|
| 84 | + * |
|
| 85 | + * Every item contains an array with the following keys: |
|
| 86 | + * * calendardata - The iCalendar-compatible calendar data |
|
| 87 | + * * uri - a unique key which will be used to construct the uri. This can |
|
| 88 | + * be any arbitrary string, but making sure it ends with '.ics' is a |
|
| 89 | + * good idea. This is only the basename, or filename, not the full |
|
| 90 | + * path. |
|
| 91 | + * * lastmodified - a timestamp of the last modification time |
|
| 92 | + * * etag - An arbitrary string, surrounded by double-quotes. (e.g.: |
|
| 93 | + * '"abcdef"') |
|
| 94 | + * * size - The size of the calendar objects, in bytes. |
|
| 95 | + * * component - optional, a string containing the type of object, such |
|
| 96 | + * as 'vevent' or 'vtodo'. If specified, this will be used to populate |
|
| 97 | + * the Content-Type header. |
|
| 98 | + * |
|
| 99 | + * Note that the etag is optional, but it's highly encouraged to return for |
|
| 100 | + * speed reasons. |
|
| 101 | + * |
|
| 102 | + * The calendardata is also optional. If it's not returned |
|
| 103 | + * 'getCalendarObject' will be called later, which *is* expected to return |
|
| 104 | + * calendardata. |
|
| 105 | + * |
|
| 106 | + * If neither etag or size are specified, the calendardata will be |
|
| 107 | + * used/fetched to determine these numbers. If both are specified the |
|
| 108 | + * amount of times this is needed is reduced by a great degree. |
|
| 109 | + * |
|
| 110 | + * @param mixed $calendarId |
|
| 111 | + * |
|
| 112 | + * @return array |
|
| 113 | + */ |
|
| 114 | + public function getCalendarObjects($calendarId); |
|
| 115 | 115 | |
| 116 | - /** |
|
| 117 | - * Returns information from a single calendar object, based on it's object |
|
| 118 | - * uri. |
|
| 119 | - * |
|
| 120 | - * The object uri is only the basename, or filename and not a full path. |
|
| 121 | - * |
|
| 122 | - * The returned array must have the same keys as getCalendarObjects. The |
|
| 123 | - * 'calendardata' object is required here though, while it's not required |
|
| 124 | - * for getCalendarObjects. |
|
| 125 | - * |
|
| 126 | - * This method must return null if the object did not exist. |
|
| 127 | - * |
|
| 128 | - * @param mixed $calendarId |
|
| 129 | - * @param string $objectUri |
|
| 130 | - * |
|
| 131 | - * @return array|null |
|
| 132 | - */ |
|
| 133 | - public function getCalendarObject($calendarId, $objectUri); |
|
| 116 | + /** |
|
| 117 | + * Returns information from a single calendar object, based on it's object |
|
| 118 | + * uri. |
|
| 119 | + * |
|
| 120 | + * The object uri is only the basename, or filename and not a full path. |
|
| 121 | + * |
|
| 122 | + * The returned array must have the same keys as getCalendarObjects. The |
|
| 123 | + * 'calendardata' object is required here though, while it's not required |
|
| 124 | + * for getCalendarObjects. |
|
| 125 | + * |
|
| 126 | + * This method must return null if the object did not exist. |
|
| 127 | + * |
|
| 128 | + * @param mixed $calendarId |
|
| 129 | + * @param string $objectUri |
|
| 130 | + * |
|
| 131 | + * @return array|null |
|
| 132 | + */ |
|
| 133 | + public function getCalendarObject($calendarId, $objectUri); |
|
| 134 | 134 | |
| 135 | - /** |
|
| 136 | - * Returns a list of calendar objects. |
|
| 137 | - * |
|
| 138 | - * This method should work identical to getCalendarObject, but instead |
|
| 139 | - * return all the calendar objects in the list as an array. |
|
| 140 | - * |
|
| 141 | - * If the backend supports this, it may allow for some speed-ups. |
|
| 142 | - * |
|
| 143 | - * @param mixed $calendarId |
|
| 144 | - * |
|
| 145 | - * @return array |
|
| 146 | - */ |
|
| 147 | - public function getMultipleCalendarObjects($calendarId, array $uris); |
|
| 135 | + /** |
|
| 136 | + * Returns a list of calendar objects. |
|
| 137 | + * |
|
| 138 | + * This method should work identical to getCalendarObject, but instead |
|
| 139 | + * return all the calendar objects in the list as an array. |
|
| 140 | + * |
|
| 141 | + * If the backend supports this, it may allow for some speed-ups. |
|
| 142 | + * |
|
| 143 | + * @param mixed $calendarId |
|
| 144 | + * |
|
| 145 | + * @return array |
|
| 146 | + */ |
|
| 147 | + public function getMultipleCalendarObjects($calendarId, array $uris); |
|
| 148 | 148 | |
| 149 | - /** |
|
| 150 | - * Creates a new calendar object. |
|
| 151 | - * |
|
| 152 | - * The object uri is only the basename, or filename and not a full path. |
|
| 153 | - * |
|
| 154 | - * It is possible to return an etag from this function, which will be used |
|
| 155 | - * in the response to this PUT request. Note that the ETag must be |
|
| 156 | - * surrounded by double-quotes. |
|
| 157 | - * |
|
| 158 | - * However, you should only really return this ETag if you don't mangle the |
|
| 159 | - * calendar-data. If the result of a subsequent GET to this object is not |
|
| 160 | - * the exact same as this request body, you should omit the ETag. |
|
| 161 | - * |
|
| 162 | - * @param mixed $calendarId |
|
| 163 | - * @param string $objectUri |
|
| 164 | - * @param string $calendarData |
|
| 165 | - * |
|
| 166 | - * @return string|null |
|
| 167 | - */ |
|
| 168 | - public function createCalendarObject($calendarId, $objectUri, $calendarData); |
|
| 149 | + /** |
|
| 150 | + * Creates a new calendar object. |
|
| 151 | + * |
|
| 152 | + * The object uri is only the basename, or filename and not a full path. |
|
| 153 | + * |
|
| 154 | + * It is possible to return an etag from this function, which will be used |
|
| 155 | + * in the response to this PUT request. Note that the ETag must be |
|
| 156 | + * surrounded by double-quotes. |
|
| 157 | + * |
|
| 158 | + * However, you should only really return this ETag if you don't mangle the |
|
| 159 | + * calendar-data. If the result of a subsequent GET to this object is not |
|
| 160 | + * the exact same as this request body, you should omit the ETag. |
|
| 161 | + * |
|
| 162 | + * @param mixed $calendarId |
|
| 163 | + * @param string $objectUri |
|
| 164 | + * @param string $calendarData |
|
| 165 | + * |
|
| 166 | + * @return string|null |
|
| 167 | + */ |
|
| 168 | + public function createCalendarObject($calendarId, $objectUri, $calendarData); |
|
| 169 | 169 | |
| 170 | - /** |
|
| 171 | - * Updates an existing calendarobject, based on it's uri. |
|
| 172 | - * |
|
| 173 | - * The object uri is only the basename, or filename and not a full path. |
|
| 174 | - * |
|
| 175 | - * It is possible return an etag from this function, which will be used in |
|
| 176 | - * the response to this PUT request. Note that the ETag must be surrounded |
|
| 177 | - * by double-quotes. |
|
| 178 | - * |
|
| 179 | - * However, you should only really return this ETag if you don't mangle the |
|
| 180 | - * calendar-data. If the result of a subsequent GET to this object is not |
|
| 181 | - * the exact same as this request body, you should omit the ETag. |
|
| 182 | - * |
|
| 183 | - * @param mixed $calendarId |
|
| 184 | - * @param string $objectUri |
|
| 185 | - * @param string $calendarData |
|
| 186 | - * |
|
| 187 | - * @return string|null |
|
| 188 | - */ |
|
| 189 | - public function updateCalendarObject($calendarId, $objectUri, $calendarData); |
|
| 170 | + /** |
|
| 171 | + * Updates an existing calendarobject, based on it's uri. |
|
| 172 | + * |
|
| 173 | + * The object uri is only the basename, or filename and not a full path. |
|
| 174 | + * |
|
| 175 | + * It is possible return an etag from this function, which will be used in |
|
| 176 | + * the response to this PUT request. Note that the ETag must be surrounded |
|
| 177 | + * by double-quotes. |
|
| 178 | + * |
|
| 179 | + * However, you should only really return this ETag if you don't mangle the |
|
| 180 | + * calendar-data. If the result of a subsequent GET to this object is not |
|
| 181 | + * the exact same as this request body, you should omit the ETag. |
|
| 182 | + * |
|
| 183 | + * @param mixed $calendarId |
|
| 184 | + * @param string $objectUri |
|
| 185 | + * @param string $calendarData |
|
| 186 | + * |
|
| 187 | + * @return string|null |
|
| 188 | + */ |
|
| 189 | + public function updateCalendarObject($calendarId, $objectUri, $calendarData); |
|
| 190 | 190 | |
| 191 | - /** |
|
| 192 | - * Deletes an existing calendar object. |
|
| 193 | - * |
|
| 194 | - * The object uri is only the basename, or filename and not a full path. |
|
| 195 | - * |
|
| 196 | - * @param mixed $calendarId |
|
| 197 | - * @param string $objectUri |
|
| 198 | - */ |
|
| 199 | - public function deleteCalendarObject($calendarId, $objectUri); |
|
| 191 | + /** |
|
| 192 | + * Deletes an existing calendar object. |
|
| 193 | + * |
|
| 194 | + * The object uri is only the basename, or filename and not a full path. |
|
| 195 | + * |
|
| 196 | + * @param mixed $calendarId |
|
| 197 | + * @param string $objectUri |
|
| 198 | + */ |
|
| 199 | + public function deleteCalendarObject($calendarId, $objectUri); |
|
| 200 | 200 | |
| 201 | - /** |
|
| 202 | - * Performs a calendar-query on the contents of this calendar. |
|
| 203 | - * |
|
| 204 | - * The calendar-query is defined in RFC4791 : CalDAV. Using the |
|
| 205 | - * calendar-query it is possible for a client to request a specific set of |
|
| 206 | - * object, based on contents of iCalendar properties, date-ranges and |
|
| 207 | - * iCalendar component types (VTODO, VEVENT). |
|
| 208 | - * |
|
| 209 | - * This method should just return a list of (relative) urls that match this |
|
| 210 | - * query. |
|
| 211 | - * |
|
| 212 | - * The list of filters are specified as an array. The exact array is |
|
| 213 | - * documented by Sabre\CalDAV\CalendarQueryParser. |
|
| 214 | - * |
|
| 215 | - * Note that it is extremely likely that getCalendarObject for every path |
|
| 216 | - * returned from this method will be called almost immediately after. You |
|
| 217 | - * may want to anticipate this to speed up these requests. |
|
| 218 | - * |
|
| 219 | - * This method provides a default implementation, which parses *all* the |
|
| 220 | - * iCalendar objects in the specified calendar. |
|
| 221 | - * |
|
| 222 | - * This default may well be good enough for personal use, and calendars |
|
| 223 | - * that aren't very large. But if you anticipate high usage, big calendars |
|
| 224 | - * or high loads, you are strongly adviced to optimize certain paths. |
|
| 225 | - * |
|
| 226 | - * The best way to do so is override this method and to optimize |
|
| 227 | - * specifically for 'common filters'. |
|
| 228 | - * |
|
| 229 | - * Requests that are extremely common are: |
|
| 230 | - * * requests for just VEVENTS |
|
| 231 | - * * requests for just VTODO |
|
| 232 | - * * requests with a time-range-filter on either VEVENT or VTODO. |
|
| 233 | - * |
|
| 234 | - * ..and combinations of these requests. It may not be worth it to try to |
|
| 235 | - * handle every possible situation and just rely on the (relatively |
|
| 236 | - * easy to use) CalendarQueryValidator to handle the rest. |
|
| 237 | - * |
|
| 238 | - * Note that especially time-range-filters may be difficult to parse. A |
|
| 239 | - * time-range filter specified on a VEVENT must for instance also handle |
|
| 240 | - * recurrence rules correctly. |
|
| 241 | - * A good example of how to interprete all these filters can also simply |
|
| 242 | - * be found in Sabre\CalDAV\CalendarQueryFilter. This class is as correct |
|
| 243 | - * as possible, so it gives you a good idea on what type of stuff you need |
|
| 244 | - * to think of. |
|
| 245 | - * |
|
| 246 | - * @param mixed $calendarId |
|
| 247 | - * |
|
| 248 | - * @return array |
|
| 249 | - */ |
|
| 250 | - public function calendarQuery($calendarId, array $filters); |
|
| 201 | + /** |
|
| 202 | + * Performs a calendar-query on the contents of this calendar. |
|
| 203 | + * |
|
| 204 | + * The calendar-query is defined in RFC4791 : CalDAV. Using the |
|
| 205 | + * calendar-query it is possible for a client to request a specific set of |
|
| 206 | + * object, based on contents of iCalendar properties, date-ranges and |
|
| 207 | + * iCalendar component types (VTODO, VEVENT). |
|
| 208 | + * |
|
| 209 | + * This method should just return a list of (relative) urls that match this |
|
| 210 | + * query. |
|
| 211 | + * |
|
| 212 | + * The list of filters are specified as an array. The exact array is |
|
| 213 | + * documented by Sabre\CalDAV\CalendarQueryParser. |
|
| 214 | + * |
|
| 215 | + * Note that it is extremely likely that getCalendarObject for every path |
|
| 216 | + * returned from this method will be called almost immediately after. You |
|
| 217 | + * may want to anticipate this to speed up these requests. |
|
| 218 | + * |
|
| 219 | + * This method provides a default implementation, which parses *all* the |
|
| 220 | + * iCalendar objects in the specified calendar. |
|
| 221 | + * |
|
| 222 | + * This default may well be good enough for personal use, and calendars |
|
| 223 | + * that aren't very large. But if you anticipate high usage, big calendars |
|
| 224 | + * or high loads, you are strongly adviced to optimize certain paths. |
|
| 225 | + * |
|
| 226 | + * The best way to do so is override this method and to optimize |
|
| 227 | + * specifically for 'common filters'. |
|
| 228 | + * |
|
| 229 | + * Requests that are extremely common are: |
|
| 230 | + * * requests for just VEVENTS |
|
| 231 | + * * requests for just VTODO |
|
| 232 | + * * requests with a time-range-filter on either VEVENT or VTODO. |
|
| 233 | + * |
|
| 234 | + * ..and combinations of these requests. It may not be worth it to try to |
|
| 235 | + * handle every possible situation and just rely on the (relatively |
|
| 236 | + * easy to use) CalendarQueryValidator to handle the rest. |
|
| 237 | + * |
|
| 238 | + * Note that especially time-range-filters may be difficult to parse. A |
|
| 239 | + * time-range filter specified on a VEVENT must for instance also handle |
|
| 240 | + * recurrence rules correctly. |
|
| 241 | + * A good example of how to interprete all these filters can also simply |
|
| 242 | + * be found in Sabre\CalDAV\CalendarQueryFilter. This class is as correct |
|
| 243 | + * as possible, so it gives you a good idea on what type of stuff you need |
|
| 244 | + * to think of. |
|
| 245 | + * |
|
| 246 | + * @param mixed $calendarId |
|
| 247 | + * |
|
| 248 | + * @return array |
|
| 249 | + */ |
|
| 250 | + public function calendarQuery($calendarId, array $filters); |
|
| 251 | 251 | |
| 252 | - /** |
|
| 253 | - * Searches through all of a users calendars and calendar objects to find |
|
| 254 | - * an object with a specific UID. |
|
| 255 | - * |
|
| 256 | - * This method should return the path to this object, relative to the |
|
| 257 | - * calendar home, so this path usually only contains two parts: |
|
| 258 | - * |
|
| 259 | - * calendarpath/objectpath.ics |
|
| 260 | - * |
|
| 261 | - * If the uid is not found, return null. |
|
| 262 | - * |
|
| 263 | - * This method should only consider * objects that the principal owns, so |
|
| 264 | - * any calendars owned by other principals that also appear in this |
|
| 265 | - * collection should be ignored. |
|
| 266 | - * |
|
| 267 | - * @param string $principalUri |
|
| 268 | - * @param string $uid |
|
| 269 | - * |
|
| 270 | - * @return string|null |
|
| 271 | - */ |
|
| 272 | - public function getCalendarObjectByUID($principalUri, $uid); |
|
| 252 | + /** |
|
| 253 | + * Searches through all of a users calendars and calendar objects to find |
|
| 254 | + * an object with a specific UID. |
|
| 255 | + * |
|
| 256 | + * This method should return the path to this object, relative to the |
|
| 257 | + * calendar home, so this path usually only contains two parts: |
|
| 258 | + * |
|
| 259 | + * calendarpath/objectpath.ics |
|
| 260 | + * |
|
| 261 | + * If the uid is not found, return null. |
|
| 262 | + * |
|
| 263 | + * This method should only consider * objects that the principal owns, so |
|
| 264 | + * any calendars owned by other principals that also appear in this |
|
| 265 | + * collection should be ignored. |
|
| 266 | + * |
|
| 267 | + * @param string $principalUri |
|
| 268 | + * @param string $uid |
|
| 269 | + * |
|
| 270 | + * @return string|null |
|
| 271 | + */ |
|
| 272 | + public function getCalendarObjectByUID($principalUri, $uid); |
|
| 273 | 273 | } |
@@ -26,37 +26,37 @@ |
||
| 26 | 26 | */ |
| 27 | 27 | interface NotificationSupport extends BackendInterface |
| 28 | 28 | { |
| 29 | - /** |
|
| 30 | - * Returns a list of notifications for a given principal url. |
|
| 31 | - * |
|
| 32 | - * @param string $principalUri |
|
| 33 | - * |
|
| 34 | - * @return NotificationInterface[] |
|
| 35 | - */ |
|
| 36 | - public function getNotificationsForPrincipal($principalUri); |
|
| 29 | + /** |
|
| 30 | + * Returns a list of notifications for a given principal url. |
|
| 31 | + * |
|
| 32 | + * @param string $principalUri |
|
| 33 | + * |
|
| 34 | + * @return NotificationInterface[] |
|
| 35 | + */ |
|
| 36 | + public function getNotificationsForPrincipal($principalUri); |
|
| 37 | 37 | |
| 38 | - /** |
|
| 39 | - * This deletes a specific notifcation. |
|
| 40 | - * |
|
| 41 | - * This may be called by a client once it deems a notification handled. |
|
| 42 | - * |
|
| 43 | - * @param string $principalUri |
|
| 44 | - */ |
|
| 45 | - public function deleteNotification($principalUri, NotificationInterface $notification); |
|
| 38 | + /** |
|
| 39 | + * This deletes a specific notifcation. |
|
| 40 | + * |
|
| 41 | + * This may be called by a client once it deems a notification handled. |
|
| 42 | + * |
|
| 43 | + * @param string $principalUri |
|
| 44 | + */ |
|
| 45 | + public function deleteNotification($principalUri, NotificationInterface $notification); |
|
| 46 | 46 | |
| 47 | - /** |
|
| 48 | - * This method is called when a user replied to a request to share. |
|
| 49 | - * |
|
| 50 | - * If the user chose to accept the share, this method should return the |
|
| 51 | - * newly created calendar url. |
|
| 52 | - * |
|
| 53 | - * @param string $href The sharee who is replying (often a mailto: address) |
|
| 54 | - * @param int $status One of the SharingPlugin::STATUS_* constants |
|
| 55 | - * @param string $calendarUri The url to the calendar thats being shared |
|
| 56 | - * @param string $inReplyTo The unique id this message is a response to |
|
| 57 | - * @param string $summary A description of the reply |
|
| 58 | - * |
|
| 59 | - * @return string|null |
|
| 60 | - */ |
|
| 61 | - public function shareReply($href, $status, $calendarUri, $inReplyTo, $summary = null); |
|
| 47 | + /** |
|
| 48 | + * This method is called when a user replied to a request to share. |
|
| 49 | + * |
|
| 50 | + * If the user chose to accept the share, this method should return the |
|
| 51 | + * newly created calendar url. |
|
| 52 | + * |
|
| 53 | + * @param string $href The sharee who is replying (often a mailto: address) |
|
| 54 | + * @param int $status One of the SharingPlugin::STATUS_* constants |
|
| 55 | + * @param string $calendarUri The url to the calendar thats being shared |
|
| 56 | + * @param string $inReplyTo The unique id this message is a response to |
|
| 57 | + * @param string $summary A description of the reply |
|
| 58 | + * |
|
| 59 | + * @return string|null |
|
| 60 | + */ |
|
| 61 | + public function shareReply($href, $status, $calendarUri, $inReplyTo, $summary = null); |
|
| 62 | 62 | } |
@@ -35,255 +35,255 @@ |
||
| 35 | 35 | */ |
| 36 | 36 | class SimplePDO extends AbstractBackend |
| 37 | 37 | { |
| 38 | - /** |
|
| 39 | - * pdo. |
|
| 40 | - * |
|
| 41 | - * @var \PDO |
|
| 42 | - */ |
|
| 43 | - protected $pdo; |
|
| 38 | + /** |
|
| 39 | + * pdo. |
|
| 40 | + * |
|
| 41 | + * @var \PDO |
|
| 42 | + */ |
|
| 43 | + protected $pdo; |
|
| 44 | 44 | |
| 45 | - /** |
|
| 46 | - * Creates the backend. |
|
| 47 | - */ |
|
| 48 | - public function __construct(\PDO $pdo) |
|
| 49 | - { |
|
| 50 | - $this->pdo = $pdo; |
|
| 51 | - } |
|
| 45 | + /** |
|
| 46 | + * Creates the backend. |
|
| 47 | + */ |
|
| 48 | + public function __construct(\PDO $pdo) |
|
| 49 | + { |
|
| 50 | + $this->pdo = $pdo; |
|
| 51 | + } |
|
| 52 | 52 | |
| 53 | - /** |
|
| 54 | - * Returns a list of calendars for a principal. |
|
| 55 | - * |
|
| 56 | - * Every project is an array with the following keys: |
|
| 57 | - * * id, a unique id that will be used by other functions to modify the |
|
| 58 | - * calendar. This can be the same as the uri or a database key. |
|
| 59 | - * * uri. This is just the 'base uri' or 'filename' of the calendar. |
|
| 60 | - * * principaluri. The owner of the calendar. Almost always the same as |
|
| 61 | - * principalUri passed to this method. |
|
| 62 | - * |
|
| 63 | - * Furthermore it can contain webdav properties in clark notation. A very |
|
| 64 | - * common one is '{DAV:}displayname'. |
|
| 65 | - * |
|
| 66 | - * Many clients also require: |
|
| 67 | - * {urn:ietf:params:xml:ns:caldav}supported-calendar-component-set |
|
| 68 | - * For this property, you can just return an instance of |
|
| 69 | - * Sabre\CalDAV\Xml\Property\SupportedCalendarComponentSet. |
|
| 70 | - * |
|
| 71 | - * If you return {http://sabredav.org/ns}read-only and set the value to 1, |
|
| 72 | - * ACL will automatically be put in read-only mode. |
|
| 73 | - * |
|
| 74 | - * @param string $principalUri |
|
| 75 | - * |
|
| 76 | - * @return array |
|
| 77 | - */ |
|
| 78 | - public function getCalendarsForUser($principalUri) |
|
| 79 | - { |
|
| 80 | - // Making fields a comma-delimited list |
|
| 81 | - $stmt = $this->pdo->prepare('SELECT id, uri FROM simple_calendars WHERE principaluri = ? ORDER BY id ASC'); |
|
| 82 | - $stmt->execute([$principalUri]); |
|
| 53 | + /** |
|
| 54 | + * Returns a list of calendars for a principal. |
|
| 55 | + * |
|
| 56 | + * Every project is an array with the following keys: |
|
| 57 | + * * id, a unique id that will be used by other functions to modify the |
|
| 58 | + * calendar. This can be the same as the uri or a database key. |
|
| 59 | + * * uri. This is just the 'base uri' or 'filename' of the calendar. |
|
| 60 | + * * principaluri. The owner of the calendar. Almost always the same as |
|
| 61 | + * principalUri passed to this method. |
|
| 62 | + * |
|
| 63 | + * Furthermore it can contain webdav properties in clark notation. A very |
|
| 64 | + * common one is '{DAV:}displayname'. |
|
| 65 | + * |
|
| 66 | + * Many clients also require: |
|
| 67 | + * {urn:ietf:params:xml:ns:caldav}supported-calendar-component-set |
|
| 68 | + * For this property, you can just return an instance of |
|
| 69 | + * Sabre\CalDAV\Xml\Property\SupportedCalendarComponentSet. |
|
| 70 | + * |
|
| 71 | + * If you return {http://sabredav.org/ns}read-only and set the value to 1, |
|
| 72 | + * ACL will automatically be put in read-only mode. |
|
| 73 | + * |
|
| 74 | + * @param string $principalUri |
|
| 75 | + * |
|
| 76 | + * @return array |
|
| 77 | + */ |
|
| 78 | + public function getCalendarsForUser($principalUri) |
|
| 79 | + { |
|
| 80 | + // Making fields a comma-delimited list |
|
| 81 | + $stmt = $this->pdo->prepare('SELECT id, uri FROM simple_calendars WHERE principaluri = ? ORDER BY id ASC'); |
|
| 82 | + $stmt->execute([$principalUri]); |
|
| 83 | 83 | |
| 84 | - $calendars = []; |
|
| 85 | - while ($row = $stmt->fetch(\PDO::FETCH_ASSOC)) { |
|
| 86 | - $calendars[] = [ |
|
| 87 | - 'id' => $row['id'], |
|
| 88 | - 'uri' => $row['uri'], |
|
| 89 | - 'principaluri' => $principalUri, |
|
| 90 | - ]; |
|
| 91 | - } |
|
| 84 | + $calendars = []; |
|
| 85 | + while ($row = $stmt->fetch(\PDO::FETCH_ASSOC)) { |
|
| 86 | + $calendars[] = [ |
|
| 87 | + 'id' => $row['id'], |
|
| 88 | + 'uri' => $row['uri'], |
|
| 89 | + 'principaluri' => $principalUri, |
|
| 90 | + ]; |
|
| 91 | + } |
|
| 92 | 92 | |
| 93 | - return $calendars; |
|
| 94 | - } |
|
| 93 | + return $calendars; |
|
| 94 | + } |
|
| 95 | 95 | |
| 96 | - /** |
|
| 97 | - * Creates a new calendar for a principal. |
|
| 98 | - * |
|
| 99 | - * If the creation was a success, an id must be returned that can be used |
|
| 100 | - * to reference this calendar in other methods, such as updateCalendar. |
|
| 101 | - * |
|
| 102 | - * @param string $principalUri |
|
| 103 | - * @param string $calendarUri |
|
| 104 | - * |
|
| 105 | - * @return string |
|
| 106 | - */ |
|
| 107 | - public function createCalendar($principalUri, $calendarUri, array $properties) |
|
| 108 | - { |
|
| 109 | - $stmt = $this->pdo->prepare('INSERT INTO simple_calendars (principaluri, uri) VALUES (?, ?)'); |
|
| 110 | - $stmt->execute([$principalUri, $calendarUri]); |
|
| 96 | + /** |
|
| 97 | + * Creates a new calendar for a principal. |
|
| 98 | + * |
|
| 99 | + * If the creation was a success, an id must be returned that can be used |
|
| 100 | + * to reference this calendar in other methods, such as updateCalendar. |
|
| 101 | + * |
|
| 102 | + * @param string $principalUri |
|
| 103 | + * @param string $calendarUri |
|
| 104 | + * |
|
| 105 | + * @return string |
|
| 106 | + */ |
|
| 107 | + public function createCalendar($principalUri, $calendarUri, array $properties) |
|
| 108 | + { |
|
| 109 | + $stmt = $this->pdo->prepare('INSERT INTO simple_calendars (principaluri, uri) VALUES (?, ?)'); |
|
| 110 | + $stmt->execute([$principalUri, $calendarUri]); |
|
| 111 | 111 | |
| 112 | - return $this->pdo->lastInsertId(); |
|
| 113 | - } |
|
| 112 | + return $this->pdo->lastInsertId(); |
|
| 113 | + } |
|
| 114 | 114 | |
| 115 | - /** |
|
| 116 | - * Delete a calendar and all it's objects. |
|
| 117 | - * |
|
| 118 | - * @param string $calendarId |
|
| 119 | - */ |
|
| 120 | - public function deleteCalendar($calendarId) |
|
| 121 | - { |
|
| 122 | - $stmt = $this->pdo->prepare('DELETE FROM simple_calendarobjects WHERE calendarid = ?'); |
|
| 123 | - $stmt->execute([$calendarId]); |
|
| 115 | + /** |
|
| 116 | + * Delete a calendar and all it's objects. |
|
| 117 | + * |
|
| 118 | + * @param string $calendarId |
|
| 119 | + */ |
|
| 120 | + public function deleteCalendar($calendarId) |
|
| 121 | + { |
|
| 122 | + $stmt = $this->pdo->prepare('DELETE FROM simple_calendarobjects WHERE calendarid = ?'); |
|
| 123 | + $stmt->execute([$calendarId]); |
|
| 124 | 124 | |
| 125 | - $stmt = $this->pdo->prepare('DELETE FROM simple_calendars WHERE id = ?'); |
|
| 126 | - $stmt->execute([$calendarId]); |
|
| 127 | - } |
|
| 125 | + $stmt = $this->pdo->prepare('DELETE FROM simple_calendars WHERE id = ?'); |
|
| 126 | + $stmt->execute([$calendarId]); |
|
| 127 | + } |
|
| 128 | 128 | |
| 129 | - /** |
|
| 130 | - * Returns all calendar objects within a calendar. |
|
| 131 | - * |
|
| 132 | - * Every item contains an array with the following keys: |
|
| 133 | - * * calendardata - The iCalendar-compatible calendar data |
|
| 134 | - * * uri - a unique key which will be used to construct the uri. This can |
|
| 135 | - * be any arbitrary string, but making sure it ends with '.ics' is a |
|
| 136 | - * good idea. This is only the basename, or filename, not the full |
|
| 137 | - * path. |
|
| 138 | - * * lastmodified - a timestamp of the last modification time |
|
| 139 | - * * etag - An arbitrary string, surrounded by double-quotes. (e.g.: |
|
| 140 | - * ' "abcdef"') |
|
| 141 | - * * size - The size of the calendar objects, in bytes. |
|
| 142 | - * * component - optional, a string containing the type of object, such |
|
| 143 | - * as 'vevent' or 'vtodo'. If specified, this will be used to populate |
|
| 144 | - * the Content-Type header. |
|
| 145 | - * |
|
| 146 | - * Note that the etag is optional, but it's highly encouraged to return for |
|
| 147 | - * speed reasons. |
|
| 148 | - * |
|
| 149 | - * The calendardata is also optional. If it's not returned |
|
| 150 | - * 'getCalendarObject' will be called later, which *is* expected to return |
|
| 151 | - * calendardata. |
|
| 152 | - * |
|
| 153 | - * If neither etag or size are specified, the calendardata will be |
|
| 154 | - * used/fetched to determine these numbers. If both are specified the |
|
| 155 | - * amount of times this is needed is reduced by a great degree. |
|
| 156 | - * |
|
| 157 | - * @param string $calendarId |
|
| 158 | - * |
|
| 159 | - * @return array |
|
| 160 | - */ |
|
| 161 | - public function getCalendarObjects($calendarId) |
|
| 162 | - { |
|
| 163 | - $stmt = $this->pdo->prepare('SELECT id, uri, calendardata FROM simple_calendarobjects WHERE calendarid = ?'); |
|
| 164 | - $stmt->execute([$calendarId]); |
|
| 129 | + /** |
|
| 130 | + * Returns all calendar objects within a calendar. |
|
| 131 | + * |
|
| 132 | + * Every item contains an array with the following keys: |
|
| 133 | + * * calendardata - The iCalendar-compatible calendar data |
|
| 134 | + * * uri - a unique key which will be used to construct the uri. This can |
|
| 135 | + * be any arbitrary string, but making sure it ends with '.ics' is a |
|
| 136 | + * good idea. This is only the basename, or filename, not the full |
|
| 137 | + * path. |
|
| 138 | + * * lastmodified - a timestamp of the last modification time |
|
| 139 | + * * etag - An arbitrary string, surrounded by double-quotes. (e.g.: |
|
| 140 | + * ' "abcdef"') |
|
| 141 | + * * size - The size of the calendar objects, in bytes. |
|
| 142 | + * * component - optional, a string containing the type of object, such |
|
| 143 | + * as 'vevent' or 'vtodo'. If specified, this will be used to populate |
|
| 144 | + * the Content-Type header. |
|
| 145 | + * |
|
| 146 | + * Note that the etag is optional, but it's highly encouraged to return for |
|
| 147 | + * speed reasons. |
|
| 148 | + * |
|
| 149 | + * The calendardata is also optional. If it's not returned |
|
| 150 | + * 'getCalendarObject' will be called later, which *is* expected to return |
|
| 151 | + * calendardata. |
|
| 152 | + * |
|
| 153 | + * If neither etag or size are specified, the calendardata will be |
|
| 154 | + * used/fetched to determine these numbers. If both are specified the |
|
| 155 | + * amount of times this is needed is reduced by a great degree. |
|
| 156 | + * |
|
| 157 | + * @param string $calendarId |
|
| 158 | + * |
|
| 159 | + * @return array |
|
| 160 | + */ |
|
| 161 | + public function getCalendarObjects($calendarId) |
|
| 162 | + { |
|
| 163 | + $stmt = $this->pdo->prepare('SELECT id, uri, calendardata FROM simple_calendarobjects WHERE calendarid = ?'); |
|
| 164 | + $stmt->execute([$calendarId]); |
|
| 165 | 165 | |
| 166 | - $result = []; |
|
| 167 | - foreach ($stmt->fetchAll(\PDO::FETCH_ASSOC) as $row) { |
|
| 168 | - $result[] = [ |
|
| 169 | - 'id' => $row['id'], |
|
| 170 | - 'uri' => $row['uri'], |
|
| 171 | - 'etag' => '"'.md5($row['calendardata']).'"', |
|
| 172 | - 'calendarid' => $calendarId, |
|
| 173 | - 'size' => strlen($row['calendardata']), |
|
| 174 | - 'calendardata' => $row['calendardata'], |
|
| 175 | - ]; |
|
| 176 | - } |
|
| 166 | + $result = []; |
|
| 167 | + foreach ($stmt->fetchAll(\PDO::FETCH_ASSOC) as $row) { |
|
| 168 | + $result[] = [ |
|
| 169 | + 'id' => $row['id'], |
|
| 170 | + 'uri' => $row['uri'], |
|
| 171 | + 'etag' => '"'.md5($row['calendardata']).'"', |
|
| 172 | + 'calendarid' => $calendarId, |
|
| 173 | + 'size' => strlen($row['calendardata']), |
|
| 174 | + 'calendardata' => $row['calendardata'], |
|
| 175 | + ]; |
|
| 176 | + } |
|
| 177 | 177 | |
| 178 | - return $result; |
|
| 179 | - } |
|
| 178 | + return $result; |
|
| 179 | + } |
|
| 180 | 180 | |
| 181 | - /** |
|
| 182 | - * Returns information from a single calendar object, based on it's object |
|
| 183 | - * uri. |
|
| 184 | - * |
|
| 185 | - * The object uri is only the basename, or filename and not a full path. |
|
| 186 | - * |
|
| 187 | - * The returned array must have the same keys as getCalendarObjects. The |
|
| 188 | - * 'calendardata' object is required here though, while it's not required |
|
| 189 | - * for getCalendarObjects. |
|
| 190 | - * |
|
| 191 | - * This method must return null if the object did not exist. |
|
| 192 | - * |
|
| 193 | - * @param string $calendarId |
|
| 194 | - * @param string $objectUri |
|
| 195 | - * |
|
| 196 | - * @return array|null |
|
| 197 | - */ |
|
| 198 | - public function getCalendarObject($calendarId, $objectUri) |
|
| 199 | - { |
|
| 200 | - $stmt = $this->pdo->prepare('SELECT id, uri, calendardata FROM simple_calendarobjects WHERE calendarid = ? AND uri = ?'); |
|
| 201 | - $stmt->execute([$calendarId, $objectUri]); |
|
| 202 | - $row = $stmt->fetch(\PDO::FETCH_ASSOC); |
|
| 181 | + /** |
|
| 182 | + * Returns information from a single calendar object, based on it's object |
|
| 183 | + * uri. |
|
| 184 | + * |
|
| 185 | + * The object uri is only the basename, or filename and not a full path. |
|
| 186 | + * |
|
| 187 | + * The returned array must have the same keys as getCalendarObjects. The |
|
| 188 | + * 'calendardata' object is required here though, while it's not required |
|
| 189 | + * for getCalendarObjects. |
|
| 190 | + * |
|
| 191 | + * This method must return null if the object did not exist. |
|
| 192 | + * |
|
| 193 | + * @param string $calendarId |
|
| 194 | + * @param string $objectUri |
|
| 195 | + * |
|
| 196 | + * @return array|null |
|
| 197 | + */ |
|
| 198 | + public function getCalendarObject($calendarId, $objectUri) |
|
| 199 | + { |
|
| 200 | + $stmt = $this->pdo->prepare('SELECT id, uri, calendardata FROM simple_calendarobjects WHERE calendarid = ? AND uri = ?'); |
|
| 201 | + $stmt->execute([$calendarId, $objectUri]); |
|
| 202 | + $row = $stmt->fetch(\PDO::FETCH_ASSOC); |
|
| 203 | 203 | |
| 204 | - if (!$row) { |
|
| 205 | - return null; |
|
| 206 | - } |
|
| 204 | + if (!$row) { |
|
| 205 | + return null; |
|
| 206 | + } |
|
| 207 | 207 | |
| 208 | - return [ |
|
| 209 | - 'id' => $row['id'], |
|
| 210 | - 'uri' => $row['uri'], |
|
| 211 | - 'etag' => '"'.md5($row['calendardata']).'"', |
|
| 212 | - 'calendarid' => $calendarId, |
|
| 213 | - 'size' => strlen($row['calendardata']), |
|
| 214 | - 'calendardata' => $row['calendardata'], |
|
| 215 | - ]; |
|
| 216 | - } |
|
| 208 | + return [ |
|
| 209 | + 'id' => $row['id'], |
|
| 210 | + 'uri' => $row['uri'], |
|
| 211 | + 'etag' => '"'.md5($row['calendardata']).'"', |
|
| 212 | + 'calendarid' => $calendarId, |
|
| 213 | + 'size' => strlen($row['calendardata']), |
|
| 214 | + 'calendardata' => $row['calendardata'], |
|
| 215 | + ]; |
|
| 216 | + } |
|
| 217 | 217 | |
| 218 | - /** |
|
| 219 | - * Creates a new calendar object. |
|
| 220 | - * |
|
| 221 | - * The object uri is only the basename, or filename and not a full path. |
|
| 222 | - * |
|
| 223 | - * It is possible return an etag from this function, which will be used in |
|
| 224 | - * the response to this PUT request. Note that the ETag must be surrounded |
|
| 225 | - * by double-quotes. |
|
| 226 | - * |
|
| 227 | - * However, you should only really return this ETag if you don't mangle the |
|
| 228 | - * calendar-data. If the result of a subsequent GET to this object is not |
|
| 229 | - * the exact same as this request body, you should omit the ETag. |
|
| 230 | - * |
|
| 231 | - * @param mixed $calendarId |
|
| 232 | - * @param string $objectUri |
|
| 233 | - * @param string $calendarData |
|
| 234 | - * |
|
| 235 | - * @return string|null |
|
| 236 | - */ |
|
| 237 | - public function createCalendarObject($calendarId, $objectUri, $calendarData) |
|
| 238 | - { |
|
| 239 | - $stmt = $this->pdo->prepare('INSERT INTO simple_calendarobjects (calendarid, uri, calendardata) VALUES (?,?,?)'); |
|
| 240 | - $stmt->execute([ |
|
| 241 | - $calendarId, |
|
| 242 | - $objectUri, |
|
| 243 | - $calendarData, |
|
| 244 | - ]); |
|
| 218 | + /** |
|
| 219 | + * Creates a new calendar object. |
|
| 220 | + * |
|
| 221 | + * The object uri is only the basename, or filename and not a full path. |
|
| 222 | + * |
|
| 223 | + * It is possible return an etag from this function, which will be used in |
|
| 224 | + * the response to this PUT request. Note that the ETag must be surrounded |
|
| 225 | + * by double-quotes. |
|
| 226 | + * |
|
| 227 | + * However, you should only really return this ETag if you don't mangle the |
|
| 228 | + * calendar-data. If the result of a subsequent GET to this object is not |
|
| 229 | + * the exact same as this request body, you should omit the ETag. |
|
| 230 | + * |
|
| 231 | + * @param mixed $calendarId |
|
| 232 | + * @param string $objectUri |
|
| 233 | + * @param string $calendarData |
|
| 234 | + * |
|
| 235 | + * @return string|null |
|
| 236 | + */ |
|
| 237 | + public function createCalendarObject($calendarId, $objectUri, $calendarData) |
|
| 238 | + { |
|
| 239 | + $stmt = $this->pdo->prepare('INSERT INTO simple_calendarobjects (calendarid, uri, calendardata) VALUES (?,?,?)'); |
|
| 240 | + $stmt->execute([ |
|
| 241 | + $calendarId, |
|
| 242 | + $objectUri, |
|
| 243 | + $calendarData, |
|
| 244 | + ]); |
|
| 245 | 245 | |
| 246 | - return '"'.md5($calendarData).'"'; |
|
| 247 | - } |
|
| 246 | + return '"'.md5($calendarData).'"'; |
|
| 247 | + } |
|
| 248 | 248 | |
| 249 | - /** |
|
| 250 | - * Updates an existing calendarobject, based on it's uri. |
|
| 251 | - * |
|
| 252 | - * The object uri is only the basename, or filename and not a full path. |
|
| 253 | - * |
|
| 254 | - * It is possible return an etag from this function, which will be used in |
|
| 255 | - * the response to this PUT request. Note that the ETag must be surrounded |
|
| 256 | - * by double-quotes. |
|
| 257 | - * |
|
| 258 | - * However, you should only really return this ETag if you don't mangle the |
|
| 259 | - * calendar-data. If the result of a subsequent GET to this object is not |
|
| 260 | - * the exact same as this request body, you should omit the ETag. |
|
| 261 | - * |
|
| 262 | - * @param mixed $calendarId |
|
| 263 | - * @param string $objectUri |
|
| 264 | - * @param string $calendarData |
|
| 265 | - * |
|
| 266 | - * @return string|null |
|
| 267 | - */ |
|
| 268 | - public function updateCalendarObject($calendarId, $objectUri, $calendarData) |
|
| 269 | - { |
|
| 270 | - $stmt = $this->pdo->prepare('UPDATE simple_calendarobjects SET calendardata = ? WHERE calendarid = ? AND uri = ?'); |
|
| 271 | - $stmt->execute([$calendarData, $calendarId, $objectUri]); |
|
| 249 | + /** |
|
| 250 | + * Updates an existing calendarobject, based on it's uri. |
|
| 251 | + * |
|
| 252 | + * The object uri is only the basename, or filename and not a full path. |
|
| 253 | + * |
|
| 254 | + * It is possible return an etag from this function, which will be used in |
|
| 255 | + * the response to this PUT request. Note that the ETag must be surrounded |
|
| 256 | + * by double-quotes. |
|
| 257 | + * |
|
| 258 | + * However, you should only really return this ETag if you don't mangle the |
|
| 259 | + * calendar-data. If the result of a subsequent GET to this object is not |
|
| 260 | + * the exact same as this request body, you should omit the ETag. |
|
| 261 | + * |
|
| 262 | + * @param mixed $calendarId |
|
| 263 | + * @param string $objectUri |
|
| 264 | + * @param string $calendarData |
|
| 265 | + * |
|
| 266 | + * @return string|null |
|
| 267 | + */ |
|
| 268 | + public function updateCalendarObject($calendarId, $objectUri, $calendarData) |
|
| 269 | + { |
|
| 270 | + $stmt = $this->pdo->prepare('UPDATE simple_calendarobjects SET calendardata = ? WHERE calendarid = ? AND uri = ?'); |
|
| 271 | + $stmt->execute([$calendarData, $calendarId, $objectUri]); |
|
| 272 | 272 | |
| 273 | - return '"'.md5($calendarData).'"'; |
|
| 274 | - } |
|
| 273 | + return '"'.md5($calendarData).'"'; |
|
| 274 | + } |
|
| 275 | 275 | |
| 276 | - /** |
|
| 277 | - * Deletes an existing calendar object. |
|
| 278 | - * |
|
| 279 | - * The object uri is only the basename, or filename and not a full path. |
|
| 280 | - * |
|
| 281 | - * @param string $calendarId |
|
| 282 | - * @param string $objectUri |
|
| 283 | - */ |
|
| 284 | - public function deleteCalendarObject($calendarId, $objectUri) |
|
| 285 | - { |
|
| 286 | - $stmt = $this->pdo->prepare('DELETE FROM simple_calendarobjects WHERE calendarid = ? AND uri = ?'); |
|
| 287 | - $stmt->execute([$calendarId, $objectUri]); |
|
| 288 | - } |
|
| 276 | + /** |
|
| 277 | + * Deletes an existing calendar object. |
|
| 278 | + * |
|
| 279 | + * The object uri is only the basename, or filename and not a full path. |
|
| 280 | + * |
|
| 281 | + * @param string $calendarId |
|
| 282 | + * @param string $objectUri |
|
| 283 | + */ |
|
| 284 | + public function deleteCalendarObject($calendarId, $objectUri) |
|
| 285 | + { |
|
| 286 | + $stmt = $this->pdo->prepare('DELETE FROM simple_calendarobjects WHERE calendarid = ? AND uri = ?'); |
|
| 287 | + $stmt->execute([$calendarId, $objectUri]); |
|
| 288 | + } |
|
| 289 | 289 | } |
@@ -15,75 +15,75 @@ |
||
| 15 | 15 | */ |
| 16 | 16 | interface SubscriptionSupport extends BackendInterface |
| 17 | 17 | { |
| 18 | - /** |
|
| 19 | - * Returns a list of subscriptions for a principal. |
|
| 20 | - * |
|
| 21 | - * Every subscription is an array with the following keys: |
|
| 22 | - * * id, a unique id that will be used by other functions to modify the |
|
| 23 | - * subscription. This can be the same as the uri or a database key. |
|
| 24 | - * * uri. This is just the 'base uri' or 'filename' of the subscription. |
|
| 25 | - * * principaluri. The owner of the subscription. Almost always the same as |
|
| 26 | - * principalUri passed to this method. |
|
| 27 | - * |
|
| 28 | - * Furthermore, all the subscription info must be returned too: |
|
| 29 | - * |
|
| 30 | - * 1. {DAV:}displayname |
|
| 31 | - * 2. {http://apple.com/ns/ical/}refreshrate |
|
| 32 | - * 3. {http://calendarserver.org/ns/}subscribed-strip-todos (omit if todos |
|
| 33 | - * should not be stripped). |
|
| 34 | - * 4. {http://calendarserver.org/ns/}subscribed-strip-alarms (omit if alarms |
|
| 35 | - * should not be stripped). |
|
| 36 | - * 5. {http://calendarserver.org/ns/}subscribed-strip-attachments (omit if |
|
| 37 | - * attachments should not be stripped). |
|
| 38 | - * 6. {http://calendarserver.org/ns/}source (Must be a |
|
| 39 | - * Sabre\DAV\Property\Href). |
|
| 40 | - * 7. {http://apple.com/ns/ical/}calendar-color |
|
| 41 | - * 8. {http://apple.com/ns/ical/}calendar-order |
|
| 42 | - * 9. {urn:ietf:params:xml:ns:caldav}supported-calendar-component-set |
|
| 43 | - * (should just be an instance of |
|
| 44 | - * Sabre\CalDAV\Property\SupportedCalendarComponentSet, with a bunch of |
|
| 45 | - * default components). |
|
| 46 | - * |
|
| 47 | - * @param string $principalUri |
|
| 48 | - * |
|
| 49 | - * @return array |
|
| 50 | - */ |
|
| 51 | - public function getSubscriptionsForUser($principalUri); |
|
| 18 | + /** |
|
| 19 | + * Returns a list of subscriptions for a principal. |
|
| 20 | + * |
|
| 21 | + * Every subscription is an array with the following keys: |
|
| 22 | + * * id, a unique id that will be used by other functions to modify the |
|
| 23 | + * subscription. This can be the same as the uri or a database key. |
|
| 24 | + * * uri. This is just the 'base uri' or 'filename' of the subscription. |
|
| 25 | + * * principaluri. The owner of the subscription. Almost always the same as |
|
| 26 | + * principalUri passed to this method. |
|
| 27 | + * |
|
| 28 | + * Furthermore, all the subscription info must be returned too: |
|
| 29 | + * |
|
| 30 | + * 1. {DAV:}displayname |
|
| 31 | + * 2. {http://apple.com/ns/ical/}refreshrate |
|
| 32 | + * 3. {http://calendarserver.org/ns/}subscribed-strip-todos (omit if todos |
|
| 33 | + * should not be stripped). |
|
| 34 | + * 4. {http://calendarserver.org/ns/}subscribed-strip-alarms (omit if alarms |
|
| 35 | + * should not be stripped). |
|
| 36 | + * 5. {http://calendarserver.org/ns/}subscribed-strip-attachments (omit if |
|
| 37 | + * attachments should not be stripped). |
|
| 38 | + * 6. {http://calendarserver.org/ns/}source (Must be a |
|
| 39 | + * Sabre\DAV\Property\Href). |
|
| 40 | + * 7. {http://apple.com/ns/ical/}calendar-color |
|
| 41 | + * 8. {http://apple.com/ns/ical/}calendar-order |
|
| 42 | + * 9. {urn:ietf:params:xml:ns:caldav}supported-calendar-component-set |
|
| 43 | + * (should just be an instance of |
|
| 44 | + * Sabre\CalDAV\Property\SupportedCalendarComponentSet, with a bunch of |
|
| 45 | + * default components). |
|
| 46 | + * |
|
| 47 | + * @param string $principalUri |
|
| 48 | + * |
|
| 49 | + * @return array |
|
| 50 | + */ |
|
| 51 | + public function getSubscriptionsForUser($principalUri); |
|
| 52 | 52 | |
| 53 | - /** |
|
| 54 | - * Creates a new subscription for a principal. |
|
| 55 | - * |
|
| 56 | - * If the creation was a success, an id must be returned that can be used to reference |
|
| 57 | - * this subscription in other methods, such as updateSubscription. |
|
| 58 | - * |
|
| 59 | - * @param string $principalUri |
|
| 60 | - * @param string $uri |
|
| 61 | - * |
|
| 62 | - * @return mixed |
|
| 63 | - */ |
|
| 64 | - public function createSubscription($principalUri, $uri, array $properties); |
|
| 53 | + /** |
|
| 54 | + * Creates a new subscription for a principal. |
|
| 55 | + * |
|
| 56 | + * If the creation was a success, an id must be returned that can be used to reference |
|
| 57 | + * this subscription in other methods, such as updateSubscription. |
|
| 58 | + * |
|
| 59 | + * @param string $principalUri |
|
| 60 | + * @param string $uri |
|
| 61 | + * |
|
| 62 | + * @return mixed |
|
| 63 | + */ |
|
| 64 | + public function createSubscription($principalUri, $uri, array $properties); |
|
| 65 | 65 | |
| 66 | - /** |
|
| 67 | - * Updates a subscription. |
|
| 68 | - * |
|
| 69 | - * The list of mutations is stored in a Sabre\DAV\PropPatch object. |
|
| 70 | - * To do the actual updates, you must tell this object which properties |
|
| 71 | - * you're going to process with the handle() method. |
|
| 72 | - * |
|
| 73 | - * Calling the handle method is like telling the PropPatch object "I |
|
| 74 | - * promise I can handle updating this property". |
|
| 75 | - * |
|
| 76 | - * Read the PropPatch documentation for more info and examples. |
|
| 77 | - * |
|
| 78 | - * @param mixed $subscriptionId |
|
| 79 | - * @param \Sabre\DAV\PropPatch $propPatch |
|
| 80 | - */ |
|
| 81 | - public function updateSubscription($subscriptionId, DAV\PropPatch $propPatch); |
|
| 66 | + /** |
|
| 67 | + * Updates a subscription. |
|
| 68 | + * |
|
| 69 | + * The list of mutations is stored in a Sabre\DAV\PropPatch object. |
|
| 70 | + * To do the actual updates, you must tell this object which properties |
|
| 71 | + * you're going to process with the handle() method. |
|
| 72 | + * |
|
| 73 | + * Calling the handle method is like telling the PropPatch object "I |
|
| 74 | + * promise I can handle updating this property". |
|
| 75 | + * |
|
| 76 | + * Read the PropPatch documentation for more info and examples. |
|
| 77 | + * |
|
| 78 | + * @param mixed $subscriptionId |
|
| 79 | + * @param \Sabre\DAV\PropPatch $propPatch |
|
| 80 | + */ |
|
| 81 | + public function updateSubscription($subscriptionId, DAV\PropPatch $propPatch); |
|
| 82 | 82 | |
| 83 | - /** |
|
| 84 | - * Deletes a subscription. |
|
| 85 | - * |
|
| 86 | - * @param mixed $subscriptionId |
|
| 87 | - */ |
|
| 88 | - public function deleteSubscription($subscriptionId); |
|
| 83 | + /** |
|
| 84 | + * Deletes a subscription. |
|
| 85 | + * |
|
| 86 | + * @param mixed $subscriptionId |
|
| 87 | + */ |
|
| 88 | + public function deleteSubscription($subscriptionId); |
|
| 89 | 89 | } |
@@ -24,37 +24,37 @@ |
||
| 24 | 24 | */ |
| 25 | 25 | interface SharingSupport extends BackendInterface |
| 26 | 26 | { |
| 27 | - /** |
|
| 28 | - * Updates the list of shares. |
|
| 29 | - * |
|
| 30 | - * @param mixed $calendarId |
|
| 31 | - * @param \Sabre\DAV\Xml\Element\Sharee[] $sharees |
|
| 32 | - */ |
|
| 33 | - public function updateInvites($calendarId, array $sharees); |
|
| 27 | + /** |
|
| 28 | + * Updates the list of shares. |
|
| 29 | + * |
|
| 30 | + * @param mixed $calendarId |
|
| 31 | + * @param \Sabre\DAV\Xml\Element\Sharee[] $sharees |
|
| 32 | + */ |
|
| 33 | + public function updateInvites($calendarId, array $sharees); |
|
| 34 | 34 | |
| 35 | - /** |
|
| 36 | - * Returns the list of people whom this calendar is shared with. |
|
| 37 | - * |
|
| 38 | - * Every item in the returned list must be a Sharee object with at |
|
| 39 | - * least the following properties set: |
|
| 40 | - * $href |
|
| 41 | - * $shareAccess |
|
| 42 | - * $inviteStatus |
|
| 43 | - * |
|
| 44 | - * and optionally: |
|
| 45 | - * $properties |
|
| 46 | - * |
|
| 47 | - * @param mixed $calendarId |
|
| 48 | - * |
|
| 49 | - * @return \Sabre\DAV\Xml\Element\Sharee[] |
|
| 50 | - */ |
|
| 51 | - public function getInvites($calendarId); |
|
| 35 | + /** |
|
| 36 | + * Returns the list of people whom this calendar is shared with. |
|
| 37 | + * |
|
| 38 | + * Every item in the returned list must be a Sharee object with at |
|
| 39 | + * least the following properties set: |
|
| 40 | + * $href |
|
| 41 | + * $shareAccess |
|
| 42 | + * $inviteStatus |
|
| 43 | + * |
|
| 44 | + * and optionally: |
|
| 45 | + * $properties |
|
| 46 | + * |
|
| 47 | + * @param mixed $calendarId |
|
| 48 | + * |
|
| 49 | + * @return \Sabre\DAV\Xml\Element\Sharee[] |
|
| 50 | + */ |
|
| 51 | + public function getInvites($calendarId); |
|
| 52 | 52 | |
| 53 | - /** |
|
| 54 | - * Publishes a calendar. |
|
| 55 | - * |
|
| 56 | - * @param mixed $calendarId |
|
| 57 | - * @param bool $value |
|
| 58 | - */ |
|
| 59 | - public function setPublishStatus($calendarId, $value); |
|
| 53 | + /** |
|
| 54 | + * Publishes a calendar. |
|
| 55 | + * |
|
| 56 | + * @param mixed $calendarId |
|
| 57 | + * @param bool $value |
|
| 58 | + */ |
|
| 59 | + public function setPublishStatus($calendarId, $value); |
|
| 60 | 60 | } |
@@ -14,53 +14,53 @@ |
||
| 14 | 14 | */ |
| 15 | 15 | interface SchedulingSupport extends BackendInterface |
| 16 | 16 | { |
| 17 | - /** |
|
| 18 | - * Returns a single scheduling object for the inbox collection. |
|
| 19 | - * |
|
| 20 | - * The returned array should contain the following elements: |
|
| 21 | - * * uri - A unique basename for the object. This will be used to |
|
| 22 | - * construct a full uri. |
|
| 23 | - * * calendardata - The iCalendar object |
|
| 24 | - * * lastmodified - The last modification date. Can be an int for a unix |
|
| 25 | - * timestamp, or a PHP DateTime object. |
|
| 26 | - * * etag - A unique token that must change if the object changed. |
|
| 27 | - * * size - The size of the object, in bytes. |
|
| 28 | - * |
|
| 29 | - * @param string $principalUri |
|
| 30 | - * @param string $objectUri |
|
| 31 | - * |
|
| 32 | - * @return array |
|
| 33 | - */ |
|
| 34 | - public function getSchedulingObject($principalUri, $objectUri); |
|
| 17 | + /** |
|
| 18 | + * Returns a single scheduling object for the inbox collection. |
|
| 19 | + * |
|
| 20 | + * The returned array should contain the following elements: |
|
| 21 | + * * uri - A unique basename for the object. This will be used to |
|
| 22 | + * construct a full uri. |
|
| 23 | + * * calendardata - The iCalendar object |
|
| 24 | + * * lastmodified - The last modification date. Can be an int for a unix |
|
| 25 | + * timestamp, or a PHP DateTime object. |
|
| 26 | + * * etag - A unique token that must change if the object changed. |
|
| 27 | + * * size - The size of the object, in bytes. |
|
| 28 | + * |
|
| 29 | + * @param string $principalUri |
|
| 30 | + * @param string $objectUri |
|
| 31 | + * |
|
| 32 | + * @return array |
|
| 33 | + */ |
|
| 34 | + public function getSchedulingObject($principalUri, $objectUri); |
|
| 35 | 35 | |
| 36 | - /** |
|
| 37 | - * Returns all scheduling objects for the inbox collection. |
|
| 38 | - * |
|
| 39 | - * These objects should be returned as an array. Every item in the array |
|
| 40 | - * should follow the same structure as returned from getSchedulingObject. |
|
| 41 | - * |
|
| 42 | - * The main difference is that 'calendardata' is optional. |
|
| 43 | - * |
|
| 44 | - * @param string $principalUri |
|
| 45 | - * |
|
| 46 | - * @return array |
|
| 47 | - */ |
|
| 48 | - public function getSchedulingObjects($principalUri); |
|
| 36 | + /** |
|
| 37 | + * Returns all scheduling objects for the inbox collection. |
|
| 38 | + * |
|
| 39 | + * These objects should be returned as an array. Every item in the array |
|
| 40 | + * should follow the same structure as returned from getSchedulingObject. |
|
| 41 | + * |
|
| 42 | + * The main difference is that 'calendardata' is optional. |
|
| 43 | + * |
|
| 44 | + * @param string $principalUri |
|
| 45 | + * |
|
| 46 | + * @return array |
|
| 47 | + */ |
|
| 48 | + public function getSchedulingObjects($principalUri); |
|
| 49 | 49 | |
| 50 | - /** |
|
| 51 | - * Deletes a scheduling object from the inbox collection. |
|
| 52 | - * |
|
| 53 | - * @param string $principalUri |
|
| 54 | - * @param string $objectUri |
|
| 55 | - */ |
|
| 56 | - public function deleteSchedulingObject($principalUri, $objectUri); |
|
| 50 | + /** |
|
| 51 | + * Deletes a scheduling object from the inbox collection. |
|
| 52 | + * |
|
| 53 | + * @param string $principalUri |
|
| 54 | + * @param string $objectUri |
|
| 55 | + */ |
|
| 56 | + public function deleteSchedulingObject($principalUri, $objectUri); |
|
| 57 | 57 | |
| 58 | - /** |
|
| 59 | - * Creates a new scheduling object. This should land in a users' inbox. |
|
| 60 | - * |
|
| 61 | - * @param string $principalUri |
|
| 62 | - * @param string $objectUri |
|
| 63 | - * @param string|resource $objectData |
|
| 64 | - */ |
|
| 65 | - public function createSchedulingObject($principalUri, $objectUri, $objectData); |
|
| 58 | + /** |
|
| 59 | + * Creates a new scheduling object. This should land in a users' inbox. |
|
| 60 | + * |
|
| 61 | + * @param string $principalUri |
|
| 62 | + * @param string $objectUri |
|
| 63 | + * @param string|resource $objectData |
|
| 64 | + */ |
|
| 65 | + public function createSchedulingObject($principalUri, $objectUri, $objectData); |
|
| 66 | 66 | } |
@@ -21,55 +21,55 @@ |
||
| 21 | 21 | */ |
| 22 | 22 | class CalendarRoot extends \Sabre\DAVACL\AbstractPrincipalCollection |
| 23 | 23 | { |
| 24 | - /** |
|
| 25 | - * CalDAV backend. |
|
| 26 | - * |
|
| 27 | - * @var Backend\BackendInterface |
|
| 28 | - */ |
|
| 29 | - protected $caldavBackend; |
|
| 24 | + /** |
|
| 25 | + * CalDAV backend. |
|
| 26 | + * |
|
| 27 | + * @var Backend\BackendInterface |
|
| 28 | + */ |
|
| 29 | + protected $caldavBackend; |
|
| 30 | 30 | |
| 31 | - /** |
|
| 32 | - * Constructor. |
|
| 33 | - * |
|
| 34 | - * This constructor needs both an authentication and a caldav backend. |
|
| 35 | - * |
|
| 36 | - * By default this class will show a list of calendar collections for |
|
| 37 | - * principals in the 'principals' collection. If your main principals are |
|
| 38 | - * actually located in a different path, use the $principalPrefix argument |
|
| 39 | - * to override this. |
|
| 40 | - * |
|
| 41 | - * @param string $principalPrefix |
|
| 42 | - */ |
|
| 43 | - public function __construct(PrincipalBackend\BackendInterface $principalBackend, Backend\BackendInterface $caldavBackend, $principalPrefix = 'principals') |
|
| 44 | - { |
|
| 45 | - parent::__construct($principalBackend, $principalPrefix); |
|
| 46 | - $this->caldavBackend = $caldavBackend; |
|
| 47 | - } |
|
| 31 | + /** |
|
| 32 | + * Constructor. |
|
| 33 | + * |
|
| 34 | + * This constructor needs both an authentication and a caldav backend. |
|
| 35 | + * |
|
| 36 | + * By default this class will show a list of calendar collections for |
|
| 37 | + * principals in the 'principals' collection. If your main principals are |
|
| 38 | + * actually located in a different path, use the $principalPrefix argument |
|
| 39 | + * to override this. |
|
| 40 | + * |
|
| 41 | + * @param string $principalPrefix |
|
| 42 | + */ |
|
| 43 | + public function __construct(PrincipalBackend\BackendInterface $principalBackend, Backend\BackendInterface $caldavBackend, $principalPrefix = 'principals') |
|
| 44 | + { |
|
| 45 | + parent::__construct($principalBackend, $principalPrefix); |
|
| 46 | + $this->caldavBackend = $caldavBackend; |
|
| 47 | + } |
|
| 48 | 48 | |
| 49 | - /** |
|
| 50 | - * Returns the nodename. |
|
| 51 | - * |
|
| 52 | - * We're overriding this, because the default will be the 'principalPrefix', |
|
| 53 | - * and we want it to be Sabre\CalDAV\Plugin::CALENDAR_ROOT |
|
| 54 | - * |
|
| 55 | - * @return string |
|
| 56 | - */ |
|
| 57 | - public function getName() |
|
| 58 | - { |
|
| 59 | - return Plugin::CALENDAR_ROOT; |
|
| 60 | - } |
|
| 49 | + /** |
|
| 50 | + * Returns the nodename. |
|
| 51 | + * |
|
| 52 | + * We're overriding this, because the default will be the 'principalPrefix', |
|
| 53 | + * and we want it to be Sabre\CalDAV\Plugin::CALENDAR_ROOT |
|
| 54 | + * |
|
| 55 | + * @return string |
|
| 56 | + */ |
|
| 57 | + public function getName() |
|
| 58 | + { |
|
| 59 | + return Plugin::CALENDAR_ROOT; |
|
| 60 | + } |
|
| 61 | 61 | |
| 62 | - /** |
|
| 63 | - * This method returns a node for a principal. |
|
| 64 | - * |
|
| 65 | - * The passed array contains principal information, and is guaranteed to |
|
| 66 | - * at least contain a uri item. Other properties may or may not be |
|
| 67 | - * supplied by the authentication backend. |
|
| 68 | - * |
|
| 69 | - * @return \Sabre\DAV\INode |
|
| 70 | - */ |
|
| 71 | - public function getChildForPrincipal(array $principal) |
|
| 72 | - { |
|
| 73 | - return new CalendarHome($this->caldavBackend, $principal); |
|
| 74 | - } |
|
| 62 | + /** |
|
| 63 | + * This method returns a node for a principal. |
|
| 64 | + * |
|
| 65 | + * The passed array contains principal information, and is guaranteed to |
|
| 66 | + * at least contain a uri item. Other properties may or may not be |
|
| 67 | + * supplied by the authentication backend. |
|
| 68 | + * |
|
| 69 | + * @return \Sabre\DAV\INode |
|
| 70 | + */ |
|
| 71 | + public function getChildForPrincipal(array $principal) |
|
| 72 | + { |
|
| 73 | + return new CalendarHome($this->caldavBackend, $principal); |
|
| 74 | + } |
|
| 75 | 75 | } |
@@ -21,88 +21,88 @@ |
||
| 21 | 21 | */ |
| 22 | 22 | class Plugin extends ServerPlugin |
| 23 | 23 | { |
| 24 | - /** |
|
| 25 | - * This initializes the plugin. |
|
| 26 | - * |
|
| 27 | - * This function is called by Sabre\DAV\Server, after |
|
| 28 | - * addPlugin is called. |
|
| 29 | - * |
|
| 30 | - * This method should set up the required event subscriptions. |
|
| 31 | - */ |
|
| 32 | - public function initialize(Server $server) |
|
| 33 | - { |
|
| 34 | - $server->resourceTypeMapping['Sabre\\CalDAV\\Subscriptions\\ISubscription'] = |
|
| 35 | - '{http://calendarserver.org/ns/}subscribed'; |
|
| 24 | + /** |
|
| 25 | + * This initializes the plugin. |
|
| 26 | + * |
|
| 27 | + * This function is called by Sabre\DAV\Server, after |
|
| 28 | + * addPlugin is called. |
|
| 29 | + * |
|
| 30 | + * This method should set up the required event subscriptions. |
|
| 31 | + */ |
|
| 32 | + public function initialize(Server $server) |
|
| 33 | + { |
|
| 34 | + $server->resourceTypeMapping['Sabre\\CalDAV\\Subscriptions\\ISubscription'] = |
|
| 35 | + '{http://calendarserver.org/ns/}subscribed'; |
|
| 36 | 36 | |
| 37 | - $server->xml->elementMap['{http://calendarserver.org/ns/}source'] = |
|
| 38 | - 'Sabre\\DAV\\Xml\\Property\\Href'; |
|
| 37 | + $server->xml->elementMap['{http://calendarserver.org/ns/}source'] = |
|
| 38 | + 'Sabre\\DAV\\Xml\\Property\\Href'; |
|
| 39 | 39 | |
| 40 | - $server->on('propFind', [$this, 'propFind'], 150); |
|
| 41 | - } |
|
| 40 | + $server->on('propFind', [$this, 'propFind'], 150); |
|
| 41 | + } |
|
| 42 | 42 | |
| 43 | - /** |
|
| 44 | - * This method should return a list of server-features. |
|
| 45 | - * |
|
| 46 | - * This is for example 'versioning' and is added to the DAV: header |
|
| 47 | - * in an OPTIONS response. |
|
| 48 | - * |
|
| 49 | - * @return array |
|
| 50 | - */ |
|
| 51 | - public function getFeatures() |
|
| 52 | - { |
|
| 53 | - return ['calendarserver-subscribed']; |
|
| 54 | - } |
|
| 43 | + /** |
|
| 44 | + * This method should return a list of server-features. |
|
| 45 | + * |
|
| 46 | + * This is for example 'versioning' and is added to the DAV: header |
|
| 47 | + * in an OPTIONS response. |
|
| 48 | + * |
|
| 49 | + * @return array |
|
| 50 | + */ |
|
| 51 | + public function getFeatures() |
|
| 52 | + { |
|
| 53 | + return ['calendarserver-subscribed']; |
|
| 54 | + } |
|
| 55 | 55 | |
| 56 | - /** |
|
| 57 | - * Triggered after properties have been fetched. |
|
| 58 | - */ |
|
| 59 | - public function propFind(PropFind $propFind, INode $node) |
|
| 60 | - { |
|
| 61 | - // There's a bunch of properties that must appear as a self-closing |
|
| 62 | - // xml-element. This event handler ensures that this will be the case. |
|
| 63 | - $props = [ |
|
| 64 | - '{http://calendarserver.org/ns/}subscribed-strip-alarms', |
|
| 65 | - '{http://calendarserver.org/ns/}subscribed-strip-attachments', |
|
| 66 | - '{http://calendarserver.org/ns/}subscribed-strip-todos', |
|
| 67 | - ]; |
|
| 56 | + /** |
|
| 57 | + * Triggered after properties have been fetched. |
|
| 58 | + */ |
|
| 59 | + public function propFind(PropFind $propFind, INode $node) |
|
| 60 | + { |
|
| 61 | + // There's a bunch of properties that must appear as a self-closing |
|
| 62 | + // xml-element. This event handler ensures that this will be the case. |
|
| 63 | + $props = [ |
|
| 64 | + '{http://calendarserver.org/ns/}subscribed-strip-alarms', |
|
| 65 | + '{http://calendarserver.org/ns/}subscribed-strip-attachments', |
|
| 66 | + '{http://calendarserver.org/ns/}subscribed-strip-todos', |
|
| 67 | + ]; |
|
| 68 | 68 | |
| 69 | - foreach ($props as $prop) { |
|
| 70 | - if (200 === $propFind->getStatus($prop)) { |
|
| 71 | - $propFind->set($prop, '', 200); |
|
| 72 | - } |
|
| 73 | - } |
|
| 74 | - } |
|
| 69 | + foreach ($props as $prop) { |
|
| 70 | + if (200 === $propFind->getStatus($prop)) { |
|
| 71 | + $propFind->set($prop, '', 200); |
|
| 72 | + } |
|
| 73 | + } |
|
| 74 | + } |
|
| 75 | 75 | |
| 76 | - /** |
|
| 77 | - * Returns a plugin name. |
|
| 78 | - * |
|
| 79 | - * Using this name other plugins will be able to access other plugins |
|
| 80 | - * using \Sabre\DAV\Server::getPlugin |
|
| 81 | - * |
|
| 82 | - * @return string |
|
| 83 | - */ |
|
| 84 | - public function getPluginName() |
|
| 85 | - { |
|
| 86 | - return 'subscriptions'; |
|
| 87 | - } |
|
| 76 | + /** |
|
| 77 | + * Returns a plugin name. |
|
| 78 | + * |
|
| 79 | + * Using this name other plugins will be able to access other plugins |
|
| 80 | + * using \Sabre\DAV\Server::getPlugin |
|
| 81 | + * |
|
| 82 | + * @return string |
|
| 83 | + */ |
|
| 84 | + public function getPluginName() |
|
| 85 | + { |
|
| 86 | + return 'subscriptions'; |
|
| 87 | + } |
|
| 88 | 88 | |
| 89 | - /** |
|
| 90 | - * Returns a bunch of meta-data about the plugin. |
|
| 91 | - * |
|
| 92 | - * Providing this information is optional, and is mainly displayed by the |
|
| 93 | - * Browser plugin. |
|
| 94 | - * |
|
| 95 | - * The description key in the returned array may contain html and will not |
|
| 96 | - * be sanitized. |
|
| 97 | - * |
|
| 98 | - * @return array |
|
| 99 | - */ |
|
| 100 | - public function getPluginInfo() |
|
| 101 | - { |
|
| 102 | - return [ |
|
| 103 | - 'name' => $this->getPluginName(), |
|
| 104 | - 'description' => 'This plugin allows users to store iCalendar subscriptions in their calendar-home.', |
|
| 105 | - 'link' => null, |
|
| 106 | - ]; |
|
| 107 | - } |
|
| 89 | + /** |
|
| 90 | + * Returns a bunch of meta-data about the plugin. |
|
| 91 | + * |
|
| 92 | + * Providing this information is optional, and is mainly displayed by the |
|
| 93 | + * Browser plugin. |
|
| 94 | + * |
|
| 95 | + * The description key in the returned array may contain html and will not |
|
| 96 | + * be sanitized. |
|
| 97 | + * |
|
| 98 | + * @return array |
|
| 99 | + */ |
|
| 100 | + public function getPluginInfo() |
|
| 101 | + { |
|
| 102 | + return [ |
|
| 103 | + 'name' => $this->getPluginName(), |
|
| 104 | + 'description' => 'This plugin allows users to store iCalendar subscriptions in their calendar-home.', |
|
| 105 | + 'link' => null, |
|
| 106 | + ]; |
|
| 107 | + } |
|
| 108 | 108 | } |
@@ -22,183 +22,183 @@ |
||
| 22 | 22 | */ |
| 23 | 23 | class Subscription extends Collection implements ISubscription, IACL |
| 24 | 24 | { |
| 25 | - use ACLTrait; |
|
| 26 | - |
|
| 27 | - /** |
|
| 28 | - * caldavBackend. |
|
| 29 | - * |
|
| 30 | - * @var SubscriptionSupport |
|
| 31 | - */ |
|
| 32 | - protected $caldavBackend; |
|
| 33 | - |
|
| 34 | - /** |
|
| 35 | - * subscriptionInfo. |
|
| 36 | - * |
|
| 37 | - * @var array |
|
| 38 | - */ |
|
| 39 | - protected $subscriptionInfo; |
|
| 40 | - |
|
| 41 | - /** |
|
| 42 | - * Constructor. |
|
| 43 | - */ |
|
| 44 | - public function __construct(SubscriptionSupport $caldavBackend, array $subscriptionInfo) |
|
| 45 | - { |
|
| 46 | - $this->caldavBackend = $caldavBackend; |
|
| 47 | - $this->subscriptionInfo = $subscriptionInfo; |
|
| 48 | - |
|
| 49 | - $required = [ |
|
| 50 | - 'id', |
|
| 51 | - 'uri', |
|
| 52 | - 'principaluri', |
|
| 53 | - 'source', |
|
| 54 | - ]; |
|
| 55 | - |
|
| 56 | - foreach ($required as $r) { |
|
| 57 | - if (!isset($subscriptionInfo[$r])) { |
|
| 58 | - throw new \InvalidArgumentException('The '.$r.' field is required when creating a subscription node'); |
|
| 59 | - } |
|
| 60 | - } |
|
| 61 | - } |
|
| 62 | - |
|
| 63 | - /** |
|
| 64 | - * Returns the name of the node. |
|
| 65 | - * |
|
| 66 | - * This is used to generate the url. |
|
| 67 | - * |
|
| 68 | - * @return string |
|
| 69 | - */ |
|
| 70 | - public function getName() |
|
| 71 | - { |
|
| 72 | - return $this->subscriptionInfo['uri']; |
|
| 73 | - } |
|
| 74 | - |
|
| 75 | - /** |
|
| 76 | - * Returns the last modification time. |
|
| 77 | - * |
|
| 78 | - * @return int|null |
|
| 79 | - */ |
|
| 80 | - public function getLastModified() |
|
| 81 | - { |
|
| 82 | - if (isset($this->subscriptionInfo['lastmodified'])) { |
|
| 83 | - return $this->subscriptionInfo['lastmodified']; |
|
| 84 | - } |
|
| 85 | - } |
|
| 86 | - |
|
| 87 | - /** |
|
| 88 | - * Deletes the current node. |
|
| 89 | - */ |
|
| 90 | - public function delete() |
|
| 91 | - { |
|
| 92 | - $this->caldavBackend->deleteSubscription( |
|
| 93 | - $this->subscriptionInfo['id'] |
|
| 94 | - ); |
|
| 95 | - } |
|
| 96 | - |
|
| 97 | - /** |
|
| 98 | - * Returns an array with all the child nodes. |
|
| 99 | - * |
|
| 100 | - * @return \Sabre\DAV\INode[] |
|
| 101 | - */ |
|
| 102 | - public function getChildren() |
|
| 103 | - { |
|
| 104 | - return []; |
|
| 105 | - } |
|
| 106 | - |
|
| 107 | - /** |
|
| 108 | - * Updates properties on this node. |
|
| 109 | - * |
|
| 110 | - * This method received a PropPatch object, which contains all the |
|
| 111 | - * information about the update. |
|
| 112 | - * |
|
| 113 | - * To update specific properties, call the 'handle' method on this object. |
|
| 114 | - * Read the PropPatch documentation for more information. |
|
| 115 | - */ |
|
| 116 | - public function propPatch(PropPatch $propPatch) |
|
| 117 | - { |
|
| 118 | - return $this->caldavBackend->updateSubscription( |
|
| 119 | - $this->subscriptionInfo['id'], |
|
| 120 | - $propPatch |
|
| 121 | - ); |
|
| 122 | - } |
|
| 123 | - |
|
| 124 | - /** |
|
| 125 | - * Returns a list of properties for this nodes. |
|
| 126 | - * |
|
| 127 | - * The properties list is a list of propertynames the client requested, |
|
| 128 | - * encoded in clark-notation {xmlnamespace}tagname. |
|
| 129 | - * |
|
| 130 | - * If the array is empty, it means 'all properties' were requested. |
|
| 131 | - * |
|
| 132 | - * Note that it's fine to liberally give properties back, instead of |
|
| 133 | - * conforming to the list of requested properties. |
|
| 134 | - * The Server class will filter out the extra. |
|
| 135 | - * |
|
| 136 | - * @param array $properties |
|
| 137 | - * |
|
| 138 | - * @return array |
|
| 139 | - */ |
|
| 140 | - public function getProperties($properties) |
|
| 141 | - { |
|
| 142 | - $r = []; |
|
| 143 | - |
|
| 144 | - foreach ($properties as $prop) { |
|
| 145 | - switch ($prop) { |
|
| 146 | - case '{http://calendarserver.org/ns/}source': |
|
| 147 | - $r[$prop] = new Href($this->subscriptionInfo['source']); |
|
| 148 | - break; |
|
| 149 | - default: |
|
| 150 | - if (array_key_exists($prop, $this->subscriptionInfo)) { |
|
| 151 | - $r[$prop] = $this->subscriptionInfo[$prop]; |
|
| 152 | - } |
|
| 153 | - break; |
|
| 154 | - } |
|
| 155 | - } |
|
| 156 | - |
|
| 157 | - return $r; |
|
| 158 | - } |
|
| 159 | - |
|
| 160 | - /** |
|
| 161 | - * Returns the owner principal. |
|
| 162 | - * |
|
| 163 | - * This must be a url to a principal, or null if there's no owner |
|
| 164 | - * |
|
| 165 | - * @return string|null |
|
| 166 | - */ |
|
| 167 | - public function getOwner() |
|
| 168 | - { |
|
| 169 | - return $this->subscriptionInfo['principaluri']; |
|
| 170 | - } |
|
| 171 | - |
|
| 172 | - /** |
|
| 173 | - * Returns a list of ACE's for this node. |
|
| 174 | - * |
|
| 175 | - * Each ACE has the following properties: |
|
| 176 | - * * 'privilege', a string such as {DAV:}read or {DAV:}write. These are |
|
| 177 | - * currently the only supported privileges |
|
| 178 | - * * 'principal', a url to the principal who owns the node |
|
| 179 | - * * 'protected' (optional), indicating that this ACE is not allowed to |
|
| 180 | - * be updated. |
|
| 181 | - * |
|
| 182 | - * @return array |
|
| 183 | - */ |
|
| 184 | - public function getACL() |
|
| 185 | - { |
|
| 186 | - return [ |
|
| 187 | - [ |
|
| 188 | - 'privilege' => '{DAV:}all', |
|
| 189 | - 'principal' => $this->getOwner(), |
|
| 190 | - 'protected' => true, |
|
| 191 | - ], |
|
| 192 | - [ |
|
| 193 | - 'privilege' => '{DAV:}all', |
|
| 194 | - 'principal' => $this->getOwner().'/calendar-proxy-write', |
|
| 195 | - 'protected' => true, |
|
| 196 | - ], |
|
| 197 | - [ |
|
| 198 | - 'privilege' => '{DAV:}read', |
|
| 199 | - 'principal' => $this->getOwner().'/calendar-proxy-read', |
|
| 200 | - 'protected' => true, |
|
| 201 | - ], |
|
| 202 | - ]; |
|
| 203 | - } |
|
| 25 | + use ACLTrait; |
|
| 26 | + |
|
| 27 | + /** |
|
| 28 | + * caldavBackend. |
|
| 29 | + * |
|
| 30 | + * @var SubscriptionSupport |
|
| 31 | + */ |
|
| 32 | + protected $caldavBackend; |
|
| 33 | + |
|
| 34 | + /** |
|
| 35 | + * subscriptionInfo. |
|
| 36 | + * |
|
| 37 | + * @var array |
|
| 38 | + */ |
|
| 39 | + protected $subscriptionInfo; |
|
| 40 | + |
|
| 41 | + /** |
|
| 42 | + * Constructor. |
|
| 43 | + */ |
|
| 44 | + public function __construct(SubscriptionSupport $caldavBackend, array $subscriptionInfo) |
|
| 45 | + { |
|
| 46 | + $this->caldavBackend = $caldavBackend; |
|
| 47 | + $this->subscriptionInfo = $subscriptionInfo; |
|
| 48 | + |
|
| 49 | + $required = [ |
|
| 50 | + 'id', |
|
| 51 | + 'uri', |
|
| 52 | + 'principaluri', |
|
| 53 | + 'source', |
|
| 54 | + ]; |
|
| 55 | + |
|
| 56 | + foreach ($required as $r) { |
|
| 57 | + if (!isset($subscriptionInfo[$r])) { |
|
| 58 | + throw new \InvalidArgumentException('The '.$r.' field is required when creating a subscription node'); |
|
| 59 | + } |
|
| 60 | + } |
|
| 61 | + } |
|
| 62 | + |
|
| 63 | + /** |
|
| 64 | + * Returns the name of the node. |
|
| 65 | + * |
|
| 66 | + * This is used to generate the url. |
|
| 67 | + * |
|
| 68 | + * @return string |
|
| 69 | + */ |
|
| 70 | + public function getName() |
|
| 71 | + { |
|
| 72 | + return $this->subscriptionInfo['uri']; |
|
| 73 | + } |
|
| 74 | + |
|
| 75 | + /** |
|
| 76 | + * Returns the last modification time. |
|
| 77 | + * |
|
| 78 | + * @return int|null |
|
| 79 | + */ |
|
| 80 | + public function getLastModified() |
|
| 81 | + { |
|
| 82 | + if (isset($this->subscriptionInfo['lastmodified'])) { |
|
| 83 | + return $this->subscriptionInfo['lastmodified']; |
|
| 84 | + } |
|
| 85 | + } |
|
| 86 | + |
|
| 87 | + /** |
|
| 88 | + * Deletes the current node. |
|
| 89 | + */ |
|
| 90 | + public function delete() |
|
| 91 | + { |
|
| 92 | + $this->caldavBackend->deleteSubscription( |
|
| 93 | + $this->subscriptionInfo['id'] |
|
| 94 | + ); |
|
| 95 | + } |
|
| 96 | + |
|
| 97 | + /** |
|
| 98 | + * Returns an array with all the child nodes. |
|
| 99 | + * |
|
| 100 | + * @return \Sabre\DAV\INode[] |
|
| 101 | + */ |
|
| 102 | + public function getChildren() |
|
| 103 | + { |
|
| 104 | + return []; |
|
| 105 | + } |
|
| 106 | + |
|
| 107 | + /** |
|
| 108 | + * Updates properties on this node. |
|
| 109 | + * |
|
| 110 | + * This method received a PropPatch object, which contains all the |
|
| 111 | + * information about the update. |
|
| 112 | + * |
|
| 113 | + * To update specific properties, call the 'handle' method on this object. |
|
| 114 | + * Read the PropPatch documentation for more information. |
|
| 115 | + */ |
|
| 116 | + public function propPatch(PropPatch $propPatch) |
|
| 117 | + { |
|
| 118 | + return $this->caldavBackend->updateSubscription( |
|
| 119 | + $this->subscriptionInfo['id'], |
|
| 120 | + $propPatch |
|
| 121 | + ); |
|
| 122 | + } |
|
| 123 | + |
|
| 124 | + /** |
|
| 125 | + * Returns a list of properties for this nodes. |
|
| 126 | + * |
|
| 127 | + * The properties list is a list of propertynames the client requested, |
|
| 128 | + * encoded in clark-notation {xmlnamespace}tagname. |
|
| 129 | + * |
|
| 130 | + * If the array is empty, it means 'all properties' were requested. |
|
| 131 | + * |
|
| 132 | + * Note that it's fine to liberally give properties back, instead of |
|
| 133 | + * conforming to the list of requested properties. |
|
| 134 | + * The Server class will filter out the extra. |
|
| 135 | + * |
|
| 136 | + * @param array $properties |
|
| 137 | + * |
|
| 138 | + * @return array |
|
| 139 | + */ |
|
| 140 | + public function getProperties($properties) |
|
| 141 | + { |
|
| 142 | + $r = []; |
|
| 143 | + |
|
| 144 | + foreach ($properties as $prop) { |
|
| 145 | + switch ($prop) { |
|
| 146 | + case '{http://calendarserver.org/ns/}source': |
|
| 147 | + $r[$prop] = new Href($this->subscriptionInfo['source']); |
|
| 148 | + break; |
|
| 149 | + default: |
|
| 150 | + if (array_key_exists($prop, $this->subscriptionInfo)) { |
|
| 151 | + $r[$prop] = $this->subscriptionInfo[$prop]; |
|
| 152 | + } |
|
| 153 | + break; |
|
| 154 | + } |
|
| 155 | + } |
|
| 156 | + |
|
| 157 | + return $r; |
|
| 158 | + } |
|
| 159 | + |
|
| 160 | + /** |
|
| 161 | + * Returns the owner principal. |
|
| 162 | + * |
|
| 163 | + * This must be a url to a principal, or null if there's no owner |
|
| 164 | + * |
|
| 165 | + * @return string|null |
|
| 166 | + */ |
|
| 167 | + public function getOwner() |
|
| 168 | + { |
|
| 169 | + return $this->subscriptionInfo['principaluri']; |
|
| 170 | + } |
|
| 171 | + |
|
| 172 | + /** |
|
| 173 | + * Returns a list of ACE's for this node. |
|
| 174 | + * |
|
| 175 | + * Each ACE has the following properties: |
|
| 176 | + * * 'privilege', a string such as {DAV:}read or {DAV:}write. These are |
|
| 177 | + * currently the only supported privileges |
|
| 178 | + * * 'principal', a url to the principal who owns the node |
|
| 179 | + * * 'protected' (optional), indicating that this ACE is not allowed to |
|
| 180 | + * be updated. |
|
| 181 | + * |
|
| 182 | + * @return array |
|
| 183 | + */ |
|
| 184 | + public function getACL() |
|
| 185 | + { |
|
| 186 | + return [ |
|
| 187 | + [ |
|
| 188 | + 'privilege' => '{DAV:}all', |
|
| 189 | + 'principal' => $this->getOwner(), |
|
| 190 | + 'protected' => true, |
|
| 191 | + ], |
|
| 192 | + [ |
|
| 193 | + 'privilege' => '{DAV:}all', |
|
| 194 | + 'principal' => $this->getOwner().'/calendar-proxy-write', |
|
| 195 | + 'protected' => true, |
|
| 196 | + ], |
|
| 197 | + [ |
|
| 198 | + 'privilege' => '{DAV:}read', |
|
| 199 | + 'principal' => $this->getOwner().'/calendar-proxy-read', |
|
| 200 | + 'protected' => true, |
|
| 201 | + ], |
|
| 202 | + ]; |
|
| 203 | + } |
|
| 204 | 204 | } |