mbk-lab
/
nextcloud
2
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

fix documentation style

This commit is contained in:
Georg Ehrke 2012-06-30 17:08:00 +02:00
parent 4ed55315e7
commit fa5b31ac9c
6 changed files with 186 additions and 101 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
apps/calendar/lib/app.php
View File

@ -13,22 +13,22 @@ OC_Calendar_App::$tz = OCP\Config::getUserValue(OCP\USER::getUser(), 'calendar',
class OC_Calendar_App{ class OC_Calendar_App{
const CALENDAR = 'calendar'; const CALENDAR = 'calendar';
const EVENT = 'event'; const EVENT = 'event';
/* /**
* @brief language object for calendar app * @brief language object for calendar app
*/ */
public static $l10n; public static $l10n;
/* /**
* @brief categories of the user * @brief categories of the user
*/ */
protected static $categories = null; protected static $categories = null;
/* /**
* @brief timezone of the user * @brief timezone of the user
*/ */
public static $tz; public static $tz;
/* /**
* @brief returns informations about a calendar * @brief returns informations about a calendar
* @param int $id - id of the calendar * @param int $id - id of the calendar
* @param bool $security - check access rights or not * @param bool $security - check access rights or not
@ -53,7 +53,7 @@ class OC_Calendar_App{
return $calendar; return $calendar;
} }
/* /**
* @brief returns informations about an event * @brief returns informations about an event
* @param int $id - id of the event * @param int $id - id of the event
* @param bool $security - check access rights or not * @param bool $security - check access rights or not
@ -79,7 +79,7 @@ class OC_Calendar_App{
return $event; return $event;
} }
/* /**
* @brief returns the parsed calendar data * @brief returns the parsed calendar data
* @param int $id - id of the event * @param int $id - id of the event
* @param bool $security - check access rights or not * @param bool $security - check access rights or not
@ -97,7 +97,7 @@ class OC_Calendar_App{
return $vobject; return $vobject;
} }
/* /**
* @brief checks if an event was edited and dies if it was * @brief checks if an event was edited and dies if it was
* @param (object) $vevent - vevent object of the event * @param (object) $vevent - vevent object of the event
* @param (int) $lastmodified - time of last modification as unix timestamp * @param (int) $lastmodified - time of last modification as unix timestamp
@ -112,7 +112,7 @@ class OC_Calendar_App{
return true; return true;
} }
/* /**
* @brief returns the default categories of ownCloud * @brief returns the default categories of ownCloud
* @return (array) $categories * @return (array) $categories
*/ */
@ -136,7 +136,7 @@ class OC_Calendar_App{
); );
} }
/* /**
* @brief returns the vcategories object of the user * @brief returns the vcategories object of the user
* @return (object) $vcategories * @return (object) $vcategories
*/ */
@ -147,7 +147,7 @@ class OC_Calendar_App{
return self::$categories; return self::$categories;
} }
/* /**
* @brief returns the categories of the vcategories object * @brief returns the categories of the vcategories object
* @return (array) $categories * @return (array) $categories
*/ */
@ -202,12 +202,16 @@ class OC_Calendar_App{
self::getVCategories()->loadFromVObject($object, true); self::getVCategories()->loadFromVObject($object, true);
} }
} }
/**
* @brief returns the options for the repeat rule of an repeating event
* @return array - valid inputs for the repeat rule of an repeating event
*/
public static function getRepeatOptions(){ public static function getRepeatOptions(){
return OC_Calendar_Object::getRepeatOptions(self::$l10n); return OC_Calendar_Object::getRepeatOptions(self::$l10n);
} }
/* /**
* @brief returns the options for the end of an repeating event * @brief returns the options for the end of an repeating event
* @return array - valid inputs for the end of an repeating events * @return array - valid inputs for the end of an repeating events
*/ */
@ -215,7 +219,7 @@ class OC_Calendar_App{
return OC_Calendar_Object::getEndOptions(self::$l10n); return OC_Calendar_Object::getEndOptions(self::$l10n);
} }
/* /**
* @brief returns the options for an monthly repeating event * @brief returns the options for an monthly repeating event
* @return array - valid inputs for monthly repeating events * @return array - valid inputs for monthly repeating events
*/ */
@ -223,7 +227,7 @@ class OC_Calendar_App{
return OC_Calendar_Object::getMonthOptions(self::$l10n); return OC_Calendar_Object::getMonthOptions(self::$l10n);
} }
/* /**
* @brief returns the options for an weekly repeating event * @brief returns the options for an weekly repeating event
* @return array - valid inputs for weekly repeating events * @return array - valid inputs for weekly repeating events
*/ */
@ -231,7 +235,7 @@ class OC_Calendar_App{
return OC_Calendar_Object::getWeeklyOptions(self::$l10n); return OC_Calendar_Object::getWeeklyOptions(self::$l10n);
} }
/* /**
* @brief returns the options for an yearly repeating event * @brief returns the options for an yearly repeating event
* @return array - valid inputs for yearly repeating events * @return array - valid inputs for yearly repeating events
*/ */
@ -239,7 +243,7 @@ class OC_Calendar_App{
return OC_Calendar_Object::getYearOptions(self::$l10n); return OC_Calendar_Object::getYearOptions(self::$l10n);
} }
/* /**
* @brief returns the options for an yearly repeating event which occurs on specific days of the year * @brief returns the options for an yearly repeating event which occurs on specific days of the year
* @return array - valid inputs for yearly repeating events * @return array - valid inputs for yearly repeating events
*/ */
@ -247,7 +251,7 @@ class OC_Calendar_App{
return OC_Calendar_Object::getByYearDayOptions(); return OC_Calendar_Object::getByYearDayOptions();
} }
/* /**
* @brief returns the options for an yearly repeating event which occurs on specific month of the year * @brief returns the options for an yearly repeating event which occurs on specific month of the year
* @return array - valid inputs for yearly repeating events * @return array - valid inputs for yearly repeating events
*/ */
@ -255,7 +259,7 @@ class OC_Calendar_App{
return OC_Calendar_Object::getByMonthOptions(self::$l10n); return OC_Calendar_Object::getByMonthOptions(self::$l10n);
} }
/* /**
* @brief returns the options for an yearly repeating event which occurs on specific week numbers of the year * @brief returns the options for an yearly repeating event which occurs on specific week numbers of the year
* @return array - valid inputs for yearly repeating events * @return array - valid inputs for yearly repeating events
*/ */
@ -263,7 +267,7 @@ class OC_Calendar_App{
return OC_Calendar_Object::getByWeekNoOptions(); return OC_Calendar_Object::getByWeekNoOptions();
} }
/* /**
* @brief returns the options for an yearly or monthly repeating event which occurs on specific days of the month * @brief returns the options for an yearly or monthly repeating event which occurs on specific days of the month
* @return array - valid inputs for yearly or monthly repeating events * @return array - valid inputs for yearly or monthly repeating events
*/ */
@ -271,7 +275,7 @@ class OC_Calendar_App{
return OC_Calendar_Object::getByMonthDayOptions(); return OC_Calendar_Object::getByMonthDayOptions();
} }
/* /**
* @brief returns the options for an monthly repeating event which occurs on specific weeks of the month * @brief returns the options for an monthly repeating event which occurs on specific weeks of the month
* @return array - valid inputs for monthly repeating events * @return array - valid inputs for monthly repeating events
*/ */
@ -279,7 +283,7 @@ class OC_Calendar_App{
return OC_Calendar_Object::getWeekofMonth(self::$l10n); return OC_Calendar_Object::getWeekofMonth(self::$l10n);
} }
/* /**
* @brief checks the access for a calendar / an event * @brief checks the access for a calendar / an event
* @param (int) $id - id of the calendar / event * @param (int) $id - id of the calendar / event
* @param (string) $type - type of the id (calendar/event) * @param (string) $type - type of the id (calendar/event)
@ -320,7 +324,7 @@ class OC_Calendar_App{
} }
} }
/* /**
* @brief analyses the parameter for calendar parameter and returns the objects * @brief analyses the parameter for calendar parameter and returns the objects
* @param (string) $calendarid - calendarid * @param (string) $calendarid - calendarid
* @param (int) $start - unixtimestamp of start * @param (int) $start - unixtimestamp of start
@ -360,7 +364,7 @@ class OC_Calendar_App{
return $events; return $events;
} }
/* /**
* @brief generates the output for an event which will be readable for our js * @brief generates the output for an event which will be readable for our js
* @param (mixed) $event - event object / array * @param (mixed) $event - event object / array
* @param (int) $start - DateTime object of start * @param (int) $start - DateTime object of start

8
apps/calendar/lib/calendar.php
View File

@ -5,7 +5,7 @@
* later. * later.
* See the COPYING-README file. * See the COPYING-README file.
*/ */
/* /**
* *
* The following SQL statement is just a help for developers and will not be * The following SQL statement is just a help for developers and will not be
* executed! * executed!
@ -201,7 +201,7 @@ class OC_Calendar_Calendar{
return true; return true;
} }
/* /**
* @brief merges two calendars * @brief merges two calendars
* @param integer $id1 * @param integer $id1
* @param integer $id2 * @param integer $id2
@ -240,7 +240,7 @@ class OC_Calendar_Calendar{
return $userid; return $userid;
} }
/* /**
* @brief returns the possible color for calendars * @brief returns the possible color for calendars
* @return array * @return array
*/ */
@ -257,7 +257,7 @@ class OC_Calendar_Calendar{
); );
} }
/* /**
* @brief generates the Event Source Info for our JS * @brief generates the Event Source Info for our JS
* @param array $calendar calendar data * @param array $calendar calendar data
* @return array * @return array

14
apps/calendar/lib/export.php
View File

@ -5,17 +5,17 @@
* later. * later.
* See the COPYING-README file. * See the COPYING-README file.
*/ */
/* /**
* This class does export and converts all times to UTC * This class does export and converts all times to UTC
*/ */
class OC_Calendar_Export{ class OC_Calendar_Export{
/* /**
* @brief Use one of these constants as second parameter if you call OC_Calendar_Export::export() * @brief Use one of these constants as second parameter if you call OC_Calendar_Export::export()
*/ */
const CALENDAR = 'calendar'; const CALENDAR = 'calendar';
const EVENT = 'event'; const EVENT = 'event';
/* /**
* @brief export a calendar or an event * @brief export a calendar or an event
* @param integer $id id of calendar / event * @param integer $id id of calendar / event
* @param string $type use OC_Calendar_Export constants * @param string $type use OC_Calendar_Export constants
@ -30,7 +30,7 @@ class OC_Calendar_Export{
return self::fixLineBreaks($return); return self::fixLineBreaks($return);
} }
/* /**
* @brief exports a calendar and convert all times to UTC * @brief exports a calendar and convert all times to UTC
* @param integer $id id of the calendar * @param integer $id id of the calendar
* @return string * @return string
@ -46,7 +46,7 @@ class OC_Calendar_Export{
return $return; return $return;
} }
/* /**
* @brief exports an event and convert all times to UTC * @brief exports an event and convert all times to UTC
* @param integer $id id of the event * @param integer $id id of the event
* @return string * @return string
@ -59,7 +59,7 @@ class OC_Calendar_Export{
return $return; return $return;
} }
/* /**
* @brief generates the VEVENT with UTC dates * @brief generates the VEVENT with UTC dates
* @param array $event * @param array $event
* @return string * @return string
@ -79,7 +79,7 @@ class OC_Calendar_Export{
return $object->VEVENT->serialize(); return $object->VEVENT->serialize();
} }
/* /**
* @brief fixes new line breaks * @brief fixes new line breaks
* (fixes problems with Apple iCal) * (fixes problems with Apple iCal)
* @param string $string to fix * @param string $string to fix

157
apps/calendar/lib/object.php
View File

@ -1,11 +1,13 @@
<?php <?php
/** /**
* Copyright (c) 2011 Jakob Sack <mail@jakobsack.de> * Copyright (c) 2011 Jakob Sack <mail@jakobsack.de>
* Copyright (c) 2012 Bart Visscher <bartv@thisnet.nl>
* Copyright (c) 2012 Georg Ehrke <ownclouddev at georgswebsite dot de>
* This file is licensed under the Affero General Public License version 3 or * This file is licensed under the Affero General Public License version 3 or
* later. * later.
* See the COPYING-README file. * See the COPYING-README file.
*/ */
/* /**
* *
* The following SQL statement is just a help for developers and will not be * The following SQL statement is just a help for developers and will not be
* executed! * executed!
@ -330,7 +332,12 @@ class OC_Calendar_Object{
public static function getUTCforMDB($datetime){ public static function getUTCforMDB($datetime){
return date('Y-m-d H:i', $datetime->format('U') - $datetime->getOffset()); return date('Y-m-d H:i', $datetime->format('U') - $datetime->getOffset());
} }
/**
* @brief returns the DTEND of an $vevent object
* @param object $vevent vevent object
* @return object
*/
public static function getDTEndFromVEvent($vevent){ public static function getDTEndFromVEvent($vevent){
if ($vevent->DTEND) { if ($vevent->DTEND) {
$dtend = $vevent->DTEND; $dtend = $vevent->DTEND;
@ -355,9 +362,12 @@ class OC_Calendar_Object{
} }
return $dtend; return $dtend;
} }
public static function getRepeatOptions($l10n) /**
{ * @brief returns the options for the repeat rule of an repeating event
* @return array - valid inputs for the repeat rule of an repeating event
*/
public static function getRepeatOptions($l10n){
return array( return array(
'doesnotrepeat' => $l10n->t('Does not repeat'), 'doesnotrepeat' => $l10n->t('Does not repeat'),
'daily' => $l10n->t('Daily'), 'daily' => $l10n->t('Daily'),
@ -368,26 +378,35 @@ class OC_Calendar_Object{
'yearly' => $l10n->t('Yearly') 'yearly' => $l10n->t('Yearly')
); );
} }
public static function getEndOptions($l10n) /**
{ * @brief returns the options for the end of an repeating event
* @return array - valid inputs for the end of an repeating events
*/
public static function getEndOptions($l10n){
return array( return array(
'never' => $l10n->t('never'), 'never' => $l10n->t('never'),
'count' => $l10n->t('by occurrences'), 'count' => $l10n->t('by occurrences'),
'date' => $l10n->t('by date') 'date' => $l10n->t('by date')
); );
} }
public static function getMonthOptions($l10n) /**
{ * @brief returns the options for an monthly repeating event
* @return array - valid inputs for monthly repeating events
*/
public static function getMonthOptions($l10n){
return array( return array(
'monthday' => $l10n->t('by monthday'), 'monthday' => $l10n->t('by monthday'),
'weekday' => $l10n->t('by weekday') 'weekday' => $l10n->t('by weekday')
); );
} }
public static function getWeeklyOptions($l10n) /**
{ * @brief returns the options for an weekly repeating event
* @return array - valid inputs for weekly repeating events
*/
public static function getWeeklyOptions($l10n){
return array( return array(
'MO' => $l10n->t('Monday'), 'MO' => $l10n->t('Monday'),
'TU' => $l10n->t('Tuesday'), 'TU' => $l10n->t('Tuesday'),
@ -398,9 +417,12 @@ class OC_Calendar_Object{
'SU' => $l10n->t('Sunday') 'SU' => $l10n->t('Sunday')
); );
} }
public static function getWeekofMonth($l10n) /**
{ * @brief returns the options for an monthly repeating event which occurs on specific weeks of the month
* @return array - valid inputs for monthly repeating events
*/
public static function getWeekofMonth($l10n){
return array( return array(
'auto' => $l10n->t('events week of month'), 'auto' => $l10n->t('events week of month'),
'1' => $l10n->t('first'), '1' => $l10n->t('first'),
@ -411,7 +433,11 @@ class OC_Calendar_Object{
'-1' => $l10n->t('last') '-1' => $l10n->t('last')
); );
} }
/**
* @brief returns the options for an yearly repeating event which occurs on specific days of the year
* @return array - valid inputs for yearly repeating events
*/
public static function getByYearDayOptions(){ public static function getByYearDayOptions(){
$return = array(); $return = array();
foreach(range(1,366) as $num){ foreach(range(1,366) as $num){
@ -419,7 +445,11 @@ class OC_Calendar_Object{
} }
return $return; return $return;
} }
/**
* @brief returns the options for an yearly or monthly repeating event which occurs on specific days of the month
* @return array - valid inputs for yearly or monthly repeating events
*/
public static function getByMonthDayOptions(){ public static function getByMonthDayOptions(){
$return = array(); $return = array();
foreach(range(1,31) as $num){ foreach(range(1,31) as $num){
@ -427,7 +457,11 @@ class OC_Calendar_Object{
} }
return $return; return $return;
} }
/**
* @brief returns the options for an yearly repeating event which occurs on specific month of the year
* @return array - valid inputs for yearly repeating events
*/
public static function getByMonthOptions($l10n){ public static function getByMonthOptions($l10n){
return array( return array(
'1' => $l10n->t('January'), '1' => $l10n->t('January'),
@ -444,7 +478,11 @@ class OC_Calendar_Object{
'12' => $l10n->t('December') '12' => $l10n->t('December')
); );
} }
/**
* @brief returns the options for an yearly repeating event
* @return array - valid inputs for yearly repeating events
*/
public static function getYearOptions($l10n){ public static function getYearOptions($l10n){
return array( return array(
'bydate' => $l10n->t('by events date'), 'bydate' => $l10n->t('by events date'),
@ -453,13 +491,21 @@ class OC_Calendar_Object{
'bydaymonth' => $l10n->t('by day and month') 'bydaymonth' => $l10n->t('by day and month')
); );
} }
/**
* @brief returns the options for an yearly repeating event which occurs on specific week numbers of the year
* @return array - valid inputs for yearly repeating events
*/
public static function getByWeekNoOptions(){ public static function getByWeekNoOptions(){
return range(1, 52); return range(1, 52);
} }
public static function validateRequest($request) /**
{ * @brief validates a request
* @param array $request
* @return mixed (array / boolean)
*/
public static function validateRequest($request){
$errnum = 0; $errnum = 0;
$errarr = array('title'=>'false', 'cal'=>'false', 'from'=>'false', 'fromtime'=>'false', 'to'=>'false', 'totime'=>'false', 'endbeforestart'=>'false'); $errarr = array('title'=>'false', 'cal'=>'false', 'from'=>'false', 'fromtime'=>'false', 'to'=>'false', 'totime'=>'false', 'endbeforestart'=>'false');
if($request['title'] == ''){ if($request['title'] == ''){
@ -606,17 +652,24 @@ class OC_Calendar_Object{
} }
return false; return false;
} }
protected static function checkTime($time) /**
{ * @brief validates time
* @param string $time
* @return boolean
*/
protected static function checkTime($time){
list($hours, $minutes) = explode(':', $time); list($hours, $minutes) = explode(':', $time);
return empty($time) return empty($time)
|| $hours < 0 || $hours > 24 || $hours < 0 || $hours > 24
|| $minutes < 0 || $minutes > 60; || $minutes < 0 || $minutes > 60;
} }
public static function createVCalendarFromRequest($request) /**
{ * @brief creates an VCalendar Object from the request data
* @param array $request
* @return object created $vcalendar
*/ public static function createVCalendarFromRequest($request){
$vcalendar = new OC_VObject('VCALENDAR'); $vcalendar = new OC_VObject('VCALENDAR');
$vcalendar->add('PRODID', 'ownCloud Calendar'); $vcalendar->add('PRODID', 'ownCloud Calendar');
$vcalendar->add('VERSION', '2.0'); $vcalendar->add('VERSION', '2.0');
@ -629,9 +682,14 @@ class OC_Calendar_Object{
$vevent->setUID(); $vevent->setUID();
return self::updateVCalendarFromRequest($request, $vcalendar); return self::updateVCalendarFromRequest($request, $vcalendar);
} }
public static function updateVCalendarFromRequest($request, $vcalendar) /**
{ * @brief updates an VCalendar Object from the request data
* @param array $request
* @param object $vcalendar
* @return object updated $vcalendar
*/
public static function updateVCalendarFromRequest($request, $vcalendar){
$title = $request["title"]; $title = $request["title"];
$location = $request["location"]; $location = $request["location"];
$categories = $request["categories"]; $categories = $request["categories"];
@ -811,29 +869,52 @@ class OC_Calendar_Object{
$vevent->setString('DESCRIPTION', $description); $vevent->setString('DESCRIPTION', $description);
$vevent->setString('CATEGORIES', $categories); $vevent->setString('CATEGORIES', $categories);
/*if($repeat == "true"){ /**if($repeat == "true"){
$vevent->RRULE = $repeat; $vevent->RRULE = $repeat;
}*/ }*/
return $vcalendar; return $vcalendar;
} }
/**
* @brief returns the owner of an object
* @param integer $id
* @return string
*/
public static function getowner($id){ public static function getowner($id){
$event = self::find($id); $event = self::find($id);
$cal = OC_Calendar_Calendar::find($event['calendarid']); $cal = OC_Calendar_Calendar::find($event['calendarid']);
return $cal['userid']; return $cal['userid'];
} }
/**
* @brief returns the calendarid of an object
* @param integer $id
* @return integer
*/
public static function getCalendarid($id){ public static function getCalendarid($id){
$event = self::find($id); $event = self::find($id);
return $event['calendarid']; return $event['calendarid'];
} }
/**
* @brief checks if an object is repeating
* @param integer $id
* @return boolean
*/
public static function isrepeating($id){ public static function isrepeating($id){
$event = self::find($id); $event = self::find($id);
return ($event['repeating'] == 1)?true:false; return ($event['repeating'] == 1)?true:false;
} }
/**
* @brief converts the start_dt and end_dt to a new timezone
* @param object $dtstart
* @param object $dtend
* @param boolean $allday
* @param string $tz
* @return array
*/
public static function generateStartEndDate($dtstart, $dtend, $allday, $tz){ public static function generateStartEndDate($dtstart, $dtend, $allday, $tz){
$start_dt = $dtstart->getDateTime(); $start_dt = $dtstart->getDateTime();
$end_dt = $dtend->getDateTime(); $end_dt = $dtend->getDateTime();

28
apps/calendar/lib/repeat.php
View File

@ -5,12 +5,12 @@
* later. * later.
* See the COPYING-README file. * See the COPYING-README file.
*/ */
/* /**
* This class manages the caching of repeating events * This class manages the caching of repeating events
* Events will be cached for the current year ± 5 years * Events will be cached for the current year ± 5 years
*/ */
class OC_Calendar_Repeat{ class OC_Calendar_Repeat{
/* /**
* @brief returns the cache of an event * @brief returns the cache of an event
* @param (int) $id - id of the event * @param (int) $id - id of the event
* @return (array) * @return (array)
@ -24,7 +24,7 @@ class OC_Calendar_Repeat{
} }
return $return; return $return;
} }
/* /**
* @brief returns the cache of an event in a specific peroid * @brief returns the cache of an event in a specific peroid
* @param (int) $id - id of the event * @param (int) $id - id of the event
* @param (DateTime) $from - start for period in UTC * @param (DateTime) $from - start for period in UTC
@ -44,7 +44,7 @@ class OC_Calendar_Repeat{
} }
return $return; return $return;
} }
/* /**
* @brief returns the cache of all repeating events of a calendar * @brief returns the cache of all repeating events of a calendar
* @param (int) $id - id of the calendar * @param (int) $id - id of the calendar
* @return (array) * @return (array)
@ -58,7 +58,7 @@ class OC_Calendar_Repeat{
} }
return $return; return $return;
} }
/* /**
* @brief returns the cache of all repeating events of a calendar in a specific period * @brief returns the cache of all repeating events of a calendar in a specific period
* @param (int) $id - id of the event * @param (int) $id - id of the event
* @param (string) $from - start for period in UTC * @param (string) $from - start for period in UTC
@ -78,7 +78,7 @@ class OC_Calendar_Repeat{
} }
return $return; return $return;
} }
/* /**
* @brief generates the cache the first time * @brief generates the cache the first time
* @param (int) id - id of the event * @param (int) id - id of the event
* @return (bool) * @return (bool)
@ -104,7 +104,7 @@ class OC_Calendar_Repeat{
} }
return true; return true;
} }
/* /**
* @brief generates the cache the first time for all repeating event of an calendar * @brief generates the cache the first time for all repeating event of an calendar
* @param (int) id - id of the calendar * @param (int) id - id of the calendar
* @return (bool) * @return (bool)
@ -116,7 +116,7 @@ class OC_Calendar_Repeat{
} }
return true; return true;
} }
/* /**
* @brief updates an event that is already cached * @brief updates an event that is already cached
* @param (int) id - id of the event * @param (int) id - id of the event
* @return (bool) * @return (bool)
@ -126,7 +126,7 @@ class OC_Calendar_Repeat{
self::generate($id); self::generate($id);
return true; return true;
} }
/* /**
* @brief updates all repating events of a calendar that are already cached * @brief updates all repating events of a calendar that are already cached
* @param (int) id - id of the calendar * @param (int) id - id of the calendar
* @return (bool) * @return (bool)
@ -136,7 +136,7 @@ class OC_Calendar_Repeat{
self::generateCalendar($id); self::generateCalendar($id);
return true; return true;
} }
/* /**
* @brief checks if an event is already cached * @brief checks if an event is already cached
* @param (int) id - id of the event * @param (int) id - id of the event
* @return (bool) * @return (bool)
@ -148,7 +148,7 @@ class OC_Calendar_Repeat{
return false; return false;
} }
} }
/* /**
* @brief checks if an event is already cached in a specific period * @brief checks if an event is already cached in a specific period
* @param (int) id - id of the event * @param (int) id - id of the event
* @param (DateTime) $from - start for period in UTC * @param (DateTime) $from - start for period in UTC
@ -163,7 +163,7 @@ class OC_Calendar_Repeat{
} }
} }
/* /**
* @brief checks if a whole calendar is already cached * @brief checks if a whole calendar is already cached
* @param (int) id - id of the calendar * @param (int) id - id of the calendar
* @return (bool) * @return (bool)
@ -183,7 +183,7 @@ class OC_Calendar_Repeat{
return true; return true;
} }
} }
/* /**
* @brief removes the cache of an event * @brief removes the cache of an event
* @param (int) id - id of the event * @param (int) id - id of the event
* @return (bool) * @return (bool)
@ -192,7 +192,7 @@ class OC_Calendar_Repeat{
$stmt = OCP\DB::prepare('DELETE FROM *PREFIX*calendar_repeat WHERE eventid = ?'); $stmt = OCP\DB::prepare('DELETE FROM *PREFIX*calendar_repeat WHERE eventid = ?');
$stmt->execute(array($id)); $stmt->execute(array($id));
} }
/* /**
* @brief removes the cache of all events of a calendar * @brief removes the cache of all events of a calendar
* @param (int) id - id of the calendar * @param (int) id - id of the calendar
* @return (bool) * @return (bool)

30
apps/calendar/lib/share.php
View File

@ -5,13 +5,13 @@
* later. * later.
* See the COPYING-README file. * See the COPYING-README file.
*/ */
/* /**
* This class manages shared calendars * This class manages shared calendars
*/ */
class OC_Calendar_Share{ class OC_Calendar_Share{
const CALENDAR = 'calendar'; const CALENDAR = 'calendar';
const EVENT = 'event'; const EVENT = 'event';
/* /**
* @brief: returns informations about all calendar or events which users are sharing with the user - userid * @brief: returns informations about all calendar or events which users are sharing with the user - userid
* @param: string $userid - id of the user * @param: string $userid - id of the user
* @param: string $type - use const self::CALENDAR or self::EVENT * @param: string $type - use const self::CALENDAR or self::EVENT
@ -33,7 +33,7 @@ class OC_Calendar_Share{
} }
return $return; return $return;
} }
/* /**
* @brief: returns all users a calendar / event is shared with * @brief: returns all users a calendar / event is shared with
* @param: integer id - id of the calendar / event * @param: integer id - id of the calendar / event
* @param: string $type - use const self::CALENDAR or self::EVENT * @param: string $type - use const self::CALENDAR or self::EVENT
@ -48,7 +48,7 @@ class OC_Calendar_Share{
} }
return $users; return $users;
} }
/* /**
* @brief: shares a calendar / event * @brief: shares a calendar / event
* @param: string $owner - userid of the owner * @param: string $owner - userid of the owner
* @param: string $share - userid (if $sharetype == user) / groupid (if $sharetype == group) / token (if $sharetype == public) * @param: string $share - userid (if $sharetype == user) / groupid (if $sharetype == group) / token (if $sharetype == public)
@ -80,7 +80,7 @@ class OC_Calendar_Share{
return true; return true;
} }
} }
/* /**
* @brief: stops sharing a calendar / event * @brief: stops sharing a calendar / event
* @param: string $owner - userid of the owner * @param: string $owner - userid of the owner
* @param: string $share - userid (if $sharetype == user) / groupid (if $sharetype == group) / token (if $sharetype == public) * @param: string $share - userid (if $sharetype == user) / groupid (if $sharetype == group) / token (if $sharetype == public)
@ -98,7 +98,7 @@ class OC_Calendar_Share{
} }
return true; return true;
} }
/* /**
* @brief: changes the permission for a calendar / event * @brief: changes the permission for a calendar / event
* @param: string $share - userid (if $sharetype == user) / groupid (if $sharetype == group) / token (if $sharetype == public) * @param: string $share - userid (if $sharetype == user) / groupid (if $sharetype == group) / token (if $sharetype == public)
* @param: string $sharetype - type of sharing (can be: user/group/public) * @param: string $sharetype - type of sharing (can be: user/group/public)
@ -115,7 +115,7 @@ class OC_Calendar_Share{
$stmt->execute(array($permission, $share, $sharetype, $id)); $stmt->execute(array($permission, $share, $sharetype, $id));
return true; return true;
} }
/* /**
* @brief: generates a token for public calendars / events * @brief: generates a token for public calendars / events
* @return: string $token * @return: string $token
*/ */
@ -138,7 +138,7 @@ class OC_Calendar_Share{
$token = md5($string); $token = md5($string);
return substr($token, rand(0,16), 15); return substr($token, rand(0,16), 15);
} }
/* /**
* @brief: checks if it is already shared * @brief: checks if it is already shared
* @param: string $owner - userid of the owner * @param: string $owner - userid of the owner
* @param: string $share - userid (if $sharetype == user) / groupid (if $sharetype == group) / token (if $sharetype == public) * @param: string $share - userid (if $sharetype == user) / groupid (if $sharetype == group) / token (if $sharetype == public)
@ -181,7 +181,7 @@ class OC_Calendar_Share{
} }
return $active_where; return $active_where;
} }
/* /**
* @brief: checks the permission for editing an event * @brief: checks the permission for editing an event
* @param: string $share - userid (if $sharetype == user) / groupid (if $sharetype == group) / token (if $sharetype == public) * @param: string $share - userid (if $sharetype == user) / groupid (if $sharetype == group) / token (if $sharetype == public)
* @param: string $id - id of the calendar / event * @param: string $id - id of the calendar / event
@ -202,7 +202,7 @@ class OC_Calendar_Share{
} }
return false; return false;
} }
/* /**
* @brief: checks the access of * @brief: checks the access of
* @param: string $share - userid (if $sharetype == user) / groupid (if $sharetype == group) / token (if $sharetype == public) * @param: string $share - userid (if $sharetype == user) / groupid (if $sharetype == group) / token (if $sharetype == public)
* @param: string $id - id of the calendar / event * @param: string $id - id of the calendar / event
@ -223,7 +223,7 @@ class OC_Calendar_Share{
return false; return false;
} }
} }
/* /**
* @brief: returns the calendardata of an event or a calendar * @brief: returns the calendardata of an event or a calendar
* @param: string $token - token which should be searched * @param: string $token - token which should be searched
* @return: mixed - bool if false, array with type and id if true * @return: mixed - bool if false, array with type and id if true
@ -248,7 +248,7 @@ class OC_Calendar_Share{
return $return; return $return;
} }
/* /**
* @brief sets the active status of the calendar * @brief sets the active status of the calendar
* @param string * @param string
*/ */
@ -257,7 +257,7 @@ class OC_Calendar_Share{
$stmt->execute(array($active, $share, $id)); $stmt->execute(array($active, $share, $id));
} }
/* /**
* @brief deletes all shared calendars / events after a user was deleted * @brief deletes all shared calendars / events after a user was deleted
* @param string $userid * @param string $userid
* @return boolean * @return boolean
@ -274,7 +274,7 @@ class OC_Calendar_Share{
return true; return true;
} }
/* /**
* @brief deletes all shared events of a calendar * @brief deletes all shared events of a calendar
* @param integer $calid * @param integer $calid
* @return boolean * @return boolean
@ -285,7 +285,7 @@ class OC_Calendar_Share{
return true; return true;
} }
/* /**
* @brief deletes all shares of an event * @brief deletes all shares of an event
* @param integer $eventid * @param integer $eventid
* @return boolean * @return boolean