Calendar
extends CalendarLibrary
in package
Calendar
Tags
Table of Contents
Constants
- ATTACHMENT_FIELD_KEY = 'attachment_id'
- Attachment field key
- MAP_FIELD_KEY = 'map_id'
- map field key
- PICTURE_FIELD_KEY = 'picture_id'
- Picture field key
- SHOW_EVENTS_OF_TODAY = 0
- Setting value for option frontendPastEvents defining that all events having their start date as of today shall be listed in frontend till the end of today.
- SHOW_EVENTS_UNTIL_END = 1
- Setting value for option frontendPastEvents defining that only those events shall be listed in frontend that have not yet ended (end date lies in the past)
- SHOW_EVENTS_UNTIL_START = 2
- Setting value for option frontendPastEvents defining that only those events shall be listed in frontend that have not yet started (start date lies in the future)
Properties
- $_objTpl : object
- Template object
- $arrCommunityGroups : array<string|int, mixed>
- Community group array
- $arrFrontendLanguages : array<string|int, mixed>
- active frontend languages
- $arrSettings : array<string|int, mixed>
- Settings array
- $boxCount : int
- Event Box count
- $csvSeparator : string
- CSV separator
- $errMessage : string
- Error message
- $metaTitle : string
- meta title
- $moduleLangVar : string
- module language variable prefix
- $moduleName : string
- module name
- $moduleTablePrefix : string
- module table prefix
- $okMessage : type
- Success message
- $pageContent : string
- template content
- $settings : array<string|int, mixed>
- Static settings array to cache the fetched data from the database
- $cx : Cx
- $em : EntityManager
- $objEventManager : object
- Event manager object
- $simulateCategoryView : bool
- When using the ID of a category, we will simulate as if cmd=category has been requested
- $submissionId : int
- An id unique per form submission and user.
- $author : string
- Author name
- $categoryId : int
- Category id
- $endDate : int
- End date Unix timestamp
- $needAuth : bool
- Need authorization
- $numEvents : int
- Number of events per page
- $searchTerm : string
- Search term
- $sortDirection : string
- Sort direction
- $startDate : int
- Start date
- $startPos : int
- Start position
Methods
- __construct() : mixed
- Constructor
- boxesEventList() : null
- Performs the list box view
- checkAccess() : null
- Checks the access level for the given action
- detachEntity() : null
- Detach the entity
- detachJoinedEntity() : null
- Detach the jointed entity
- format2userDate() : string
- Returns the date string (according to the calendar's configuration) from a \DateTime object.
- format2userDateTime() : string
- Returns the date/time string (according to the calendar's configuration) from a \DateTime object.
- format2userTime() : string
- Returns the time string 'H:i' from a \DateTime object
- formatDateTime2user() : string
- Returns a date/time string from a \DateTime object.
- generateKey() : string
- generates the random key
- getCalendarPage() : null
- Performs the calendar page
- getCommunityGroups() : null
- Initilize the available group
- getComponent() : SystemComponentController
- Get component controller object
- getDateFormat() : string
- Return's the dataformat based on the type
- getDateTime() : DateTime
- Returns a \DateTime object from a calendar date/time string.
- getDbDateTimeFromIntern() : DateTime
- Returns a \DateTime object in db timezone
- getEventManager() : mixed
- Get the Event manager
- getExeceptionDates() : array<string|int, mixed>
- Returns all series dates based on the given post data
- getFrontendLanguages() : null
- Initialize the active frontend languages array
- getHeadlinePlaceholders() : array<string|int, mixed>
- Get the list of calendar headline placeholders
- getInternDateTimeFromDb() : DateTime
- Returns a \DateTime object from a date/time string.
- getInternDateTimeFromUser() : DateTime
- Returns a \DateTime object from a date/time string.
- getJavascript() : string
- Return's the billing address javascript
- getSettings() : null
- Prepares the settings from database to array format
- getUserDateTimeFromIntern() : DateTime
- Returns a \DateTime object in user timezone
- init() : mixed
- Initialize $cx and $em
- loadEventManager() : null
- Loads the event manager
- modifyEvent() : null
- Add / Edit Event
- myEvents() : null
- performs the my events page
- overview() : null
- performs the overview page
- showCategoryView() : null
- set the placeholders for the category view
- showRegistrationForm() : null
- performs the registratio page
- showSuccessPage() : null
- Display the success page
- showThreeBoxes() : null
- Performs the box view
- triggerEvent() : null
- Trigger the event
- uploadFinished() : array<string|int, mixed>
- Uploader callback function
- getUploaderCode() : string
- Get uploader code
- parseDateTimeString() : array<string|int, mixed>
- Split a datetime string (i.E.: '08.06.2015 13:37') into an array containing the date, hour and minutes information as separate elements.
- showEvent() : null
- Performs the Event details page
Constants
ATTACHMENT_FIELD_KEY
Attachment field key
public
string
ATTACHMENT_FIELD_KEY
= 'attachment_id'
MAP_FIELD_KEY
map field key
public
string
MAP_FIELD_KEY
= 'map_id'
PICTURE_FIELD_KEY
Picture field key
public
string
PICTURE_FIELD_KEY
= 'picture_id'
SHOW_EVENTS_OF_TODAY
Setting value for option frontendPastEvents defining that all events having their start date as of today shall be listed in frontend till the end of today.
public
int
SHOW_EVENTS_OF_TODAY
= 0
SHOW_EVENTS_UNTIL_END
Setting value for option frontendPastEvents defining that only those events shall be listed in frontend that have not yet ended (end date lies in the past)
public
int
SHOW_EVENTS_UNTIL_END
= 1
SHOW_EVENTS_UNTIL_START
Setting value for option frontendPastEvents defining that only those events shall be listed in frontend that have not yet started (start date lies in the future)
public
int
SHOW_EVENTS_UNTIL_START
= 2
Tags
Properties
$_objTpl
Template object
public
object
$_objTpl
Tags
$arrCommunityGroups
Community group array
public
array<string|int, mixed>
$arrCommunityGroups
= array()
Tags
$arrFrontendLanguages
active frontend languages
public
array<string|int, mixed>
$arrFrontendLanguages
= array()
Tags
$arrSettings
Settings array
public
array<string|int, mixed>
$arrSettings
= array()
Tags
$boxCount
Event Box count
public
int
$boxCount
= 3
$csvSeparator
CSV separator
public
string
$csvSeparator
= ';'
Tags
$errMessage
Error message
public
string
$errMessage
= ''
Tags
$metaTitle
meta title
public
string
$metaTitle
$moduleLangVar
module language variable prefix
public
string
$moduleLangVar
= "CALENDAR"
Tags
$moduleName
module name
public
string
$moduleName
= "Calendar"
Tags
$moduleTablePrefix
module table prefix
public
string
$moduleTablePrefix
= "calendar"
Tags
$okMessage
Success message
public
type
$okMessage
= ''
Tags
$pageContent
template content
public
string
$pageContent
Tags
$settings
Static settings array to cache the fetched data from the database
public
static array<string|int, mixed>
$settings
= array()
$cx
protected
Cx
$cx
$em
protected
EntityManager
$em
$objEventManager
Event manager object
protected
object
$objEventManager
$simulateCategoryView
When using the ID of a category, we will simulate as if cmd=category has been requested
protected
bool
$simulateCategoryView
= false
$submissionId
An id unique per form submission and user.
protected
int
$submissionId
= 0
This means an user can submit the same form twice at the same time, and the form gets a different submission id for each submit.
$author
Author name
private
string
$author
$categoryId
Category id
private
int
$categoryId
$endDate
End date Unix timestamp
private
int
$endDate
$needAuth
Need authorization
private
bool
$needAuth
$numEvents
Number of events per page
private
int
$numEvents
$searchTerm
Search term
private
string
$searchTerm
$sortDirection
Sort direction
private
string
$sortDirection
= 'ASC'
$startDate
Start date
private
int
$startDate
Unix timestamp
$startPos
Start position
private
int
$startPos
Methods
__construct()
Constructor
public
__construct(string $pageContent) : mixed
Parameters
- $pageContent : string
Tags
boxesEventList()
Performs the list box view
public
boxesEventList() : null
Return values
nullcheckAccess()
Checks the access level for the given action
public
checkAccess(string $strAction) : null
It checks the access level for the given action and return's null if access is granted otherwise it redirect the action to the respective fallback pages.
Parameters
- $strAction : string
-
possible values are add_event, edit_event, my_events
Return values
nulldetachEntity()
Detach the entity
public
detachEntity(object $entity, string $methodName, array<string|int, mixed> $relation, array<string|int, mixed> $joinEntityRelation) : null
Parameters
- $entity : object
-
entity object
- $methodName : string
-
method name
- $relation : array<string|int, mixed>
-
relationship array
- $joinEntityRelation : array<string|int, mixed>
-
joined entity's relationship array
Return values
nulldetachJoinedEntity()
Detach the jointed entity
public
detachJoinedEntity(object $entity, array<string|int, mixed> $relations, array<string|int, mixed> $joinEntityRelation) : null
Parameters
- $entity : object
-
entity object
- $relations : array<string|int, mixed>
-
relationship array
- $joinEntityRelation : array<string|int, mixed>
-
joined entity's relationship array
Return values
nullformat2userDate()
Returns the date string (according to the calendar's configuration) from a \DateTime object.
public
format2userDate(DateTime $dateTime) : string
The SUPPLIED \DateTime object must be in INTERNAL timezone. The RETURNED date string will be in USER timezone.
Parameters
- $dateTime : DateTime
-
DateTime object in internal timezone
Return values
string —A date string
format2userDateTime()
Returns the date/time string (according to the calendar's configuration) from a \DateTime object.
public
format2userDateTime(DateTime $dateTime) : string
The SUPPLIED \DateTime object must be in INTERNAL timezone. The RETURNED date/time string will be in USER timezone.
Parameters
- $dateTime : DateTime
-
DateTime object in internal timezone
Return values
string —A date/time string
format2userTime()
Returns the time string 'H:i' from a \DateTime object
public
format2userTime(DateTime $dateTime) : string
The SUPPLIED \DateTime object must be in INTERNAL timezone. The RETURNED time string will be in USER timezone.
Parameters
- $dateTime : DateTime
-
DateTime object in internal timezone
Return values
string —A time string
formatDateTime2user()
Returns a date/time string from a \DateTime object.
public
formatDateTime2user(DateTime $dateTime, string $format) : string
The SUPPLIED \DateTime object must be in INTERNAL timezone. The RETURNED date/time string will be in USER timezone.
Parameters
- $dateTime : DateTime
-
DateTime object in internal timezone
- $format : string
-
Format string
Return values
string —A date/time string formatted according to $format
generateKey()
generates the random key
public
generateKey() : string
Return values
string —combination of alphabet and number in random order
getCalendarPage()
Performs the calendar page
public
getCalendarPage(mixed $page) : null
Parameters
- $page : mixed
Return values
nullgetCommunityGroups()
Initilize the available group
public
getCommunityGroups() : null
Fetch the available group from the database and assign those values into $this->arrCommunityGroups
Return values
nullgetComponent()
Get component controller object
public
getComponent(string $name) : SystemComponentController
Parameters
- $name : string
-
component name
Return values
SystemComponentController —The requested component controller or null if no such component exists
getDateFormat()
Return's the dataformat based on the type
public
getDateFormat([int $type = null ]) : string
Return's the dateformat by the given type 1 => frontend (javascript format alone) else backend
Parameters
- $type : int = null
-
type 1 => frontend (javascript format alone) else backend
Return values
string —Date format
getDateTime()
Returns a \DateTime object from a calendar date/time string.
public
getDateTime(string $date[, int $hour = 0 ][, int $minute = 0 ]) : DateTime
The format of a calendar date/time string can be configured in the settings section of the calendar component.
Note: In constrast to this method, the method getUserDateTimeFromUser() expects a PHP date/time string.
The SUPPLIED calendar date/time string must be in USER timezone. The RETURNED \DateTime object will be in INTERNAL timezone.
Parameters
- $date : string
-
A calendar date/time string in user timezone
- $hour : int = 0
-
Hour value
- $minute : int = 0
-
Minute value
Return values
DateTime —\DateTime object in internal timezone
getDbDateTimeFromIntern()
Returns a \DateTime object in db timezone
public
getDbDateTimeFromIntern(DateTime $dateTime) : DateTime
The SUPPLIED \DateTime object must be in INTERNAL timezone. The RETURNED \DateTime object will be in DB timezone.
Parameters
- $dateTime : DateTime
-
\DateTime object in internal timezone
Return values
DateTime —\DateTime in db timezone
getEventManager()
Get the Event manager
public
getEventManager() : mixed
getExeceptionDates()
Returns all series dates based on the given post data
public
getExeceptionDates() : array<string|int, mixed>
Return values
array<string|int, mixed> —Array of dates
getFrontendLanguages()
Initialize the active frontend languages array
public
getFrontendLanguages() : null
Fetch the active frontend languages from the database and assign those values into $this->arrFrontendLanguages
Return values
nullgetHeadlinePlaceholders()
Get the list of calendar headline placeholders
public
static getHeadlinePlaceholders() : array<string|int, mixed>
Return values
array<string|int, mixed>getInternDateTimeFromDb()
Returns a \DateTime object from a date/time string.
public
getInternDateTimeFromDb([string $time = 'now' ]) : DateTime
The SUPPLIED date/time string must be in DB timezone. The RETURNED \DateTime object will be in INTERNAL timezone.
Parameters
- $time : string = 'now'
-
A date/time string in db timezone
Return values
DateTime —\DateTime object in internal timezone
getInternDateTimeFromUser()
Returns a \DateTime object from a date/time string.
public
getInternDateTimeFromUser([string $time = 'now' ]) : DateTime
The SUPPLIED date/time string must be in USER timezone. The RETURNED \DateTime object will be in INTERNAL timezone.
Parameters
- $time : string = 'now'
-
A date/time string in user timezone
Return values
DateTime —\DateTime object in internal timezone
getJavascript()
Return's the billing address javascript
public
getJavascript() : string
Return values
string —Billing HereDoc phpscript
getSettings()
Prepares the settings from database to array format
public
getSettings() : null
Loads the settings values from the database and assign those values into $this->arrSettings
Return values
nullgetUserDateTimeFromIntern()
Returns a \DateTime object in user timezone
public
getUserDateTimeFromIntern(DateTime $dateTime) : DateTime
The SUPPLIED \DateTime object must be in INTERNAL timezone. The RETURNED \DateTime object will be in USER timezone.
Parameters
- $dateTime : DateTime
-
\DateTime object in internal timezone
Return values
DateTime —\DateTime in user timezone
init()
Initialize $cx and $em
public
init() : mixed
loadEventManager()
Loads the event manager
public
loadEventManager() : null
Return values
nullmodifyEvent()
Add / Edit Event
public
modifyEvent([int $eventId = null ]) : null
Parameters
- $eventId : int = null
-
Event id
Return values
nullmyEvents()
performs the my events page
public
myEvents([mixed &$firstEndDate = null ]) : null
Parameters
- $firstEndDate : mixed = null
Return values
nulloverview()
performs the overview page
public
overview([mixed &$firstEndDate = null ]) : null
Parameters
- $firstEndDate : mixed = null
Return values
nullshowCategoryView()
set the placeholders for the category view
public
showCategoryView([mixed &$firstEndDate = null ]) : null
Parameters
- $firstEndDate : mixed = null
Return values
nullshowRegistrationForm()
performs the registratio page
public
showRegistrationForm() : null
Return values
nullshowSuccessPage()
Display the success page
public
showSuccessPage() : null
Return values
nullshowThreeBoxes()
Performs the box view
public
showThreeBoxes() : null
Return values
nulltriggerEvent()
Trigger the event
public
triggerEvent(string $eventName[, object $entity = null ][, array<string|int, mixed> $relations = array() ][, bool $isDetach = false ]) : null
Parameters
- $eventName : string
-
trigger event name
- $entity : object = null
-
entity object
- $relations : array<string|int, mixed> = array()
-
entity relations
- $isDetach : bool = false
-
is detachable entity
Return values
nulluploadFinished()
Uploader callback function
public
static uploadFinished(string $tempPath, string $tempWebPath, string $data, int $uploadId, array<string|int, mixed> $fileInfos, object $response) : array<string|int, mixed>
Parameters
- $tempPath : string
-
Temp path
- $tempWebPath : string
-
Temp webpath
- $data : string
-
post data
- $uploadId : int
-
upload id
- $fileInfos : array<string|int, mixed>
-
file infos
- $response : object
-
Upload api response object
Return values
array<string|int, mixed> —$tempPath and $tempWebPath
getUploaderCode()
Get uploader code
protected
getUploaderCode(string $fieldKey, string $fieldName[, string $uploadCallBack = "uploadFinished" ][, bool $allowImageOnly = true ]) : string
Parameters
- $fieldKey : string
-
uploadFieldKey
- $fieldName : string
-
uploadFieldName
- $uploadCallBack : string = "uploadFinished"
-
upload callback function
- $allowImageOnly : bool = true
-
allow only images files
Tags
Return values
string —uploaderCode
parseDateTimeString()
Split a datetime string (i.E.: '08.06.2015 13:37') into an array containing the date, hour and minutes information as separate elements.
protected
parseDateTimeString(string $datetime[, bool $allDay = false ][, bool $end = false ]) : array<string|int, mixed>
Parameters
- $datetime : string
-
The datetime string to parse.
- $allDay : bool = false
-
If set to TRUE, then the returned hour and minutes value are set to 0, unless $end is also set to TRUE.
- $end : bool = false
-
If set to TRUE and $allDay is also set to TRUE, then the returned hour is set to 23 and the minutes to 59. If $allDay is not set to TRUE, then this argument has no effect.
Return values
array<string|int, mixed> —Return parsed datetime as array having the following format:
array( d.m.Y, G, m )
showEvent()
Performs the Event details page
protected
showEvent(mixed $page[, mixed &$start = null ]) : null
Parameters
- $page : mixed
- $start : mixed = null