Documentation

Calendar extends CalendarLibrary

Calendar

Tags
subpackage

module_calendar

author

Cloudrexx info@cloudrexx.com

copyright

CLOUDREXX CMS - CLOUDREXX AG

version
1.00

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'

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
todo

Implement behavior of this option

Properties

$arrCommunityGroups

Community group array

public array<string|int, mixed> $arrCommunityGroups = array()
Tags
access

public

$arrFrontendLanguages

active frontend languages

public array<string|int, mixed> $arrFrontendLanguages = array()
Tags
access

public

$arrSettings

Settings array

public array<string|int, mixed> $arrSettings = array()
Tags
access

public

$moduleLangVar

module language variable prefix

public string $moduleLangVar = "CALENDAR"
Tags
access

public

$moduleTablePrefix

module table prefix

public string $moduleTablePrefix = "calendar"
Tags
access

public

$settings

Static settings array to cache the fetched data from the database

public static array<string|int, mixed> $settings = array()

$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.

$sortDirection

Sort direction

private string $sortDirection = 'ASC'

Methods

__construct()

Constructor

public __construct(string $pageContent) : mixed
Parameters
$pageContent : string
Tags
global

array $_ARRAYLANG

global

object $objTemplate

boxesEventList()

Performs the list box view

public boxesEventList() : null
Return values
null

checkAccess()

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
null

detachEntity()

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
null

detachJoinedEntity()

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
null

format2userDate()

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
null

getCommunityGroups()

Initilize the available group

public getCommunityGroups() : null

Fetch the available group from the database and assign those values into $this->arrCommunityGroups

Return values
null

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
null

getHeadlinePlaceholders()

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
null

getUserDateTimeFromIntern()

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

loadEventManager()

Loads the event manager

public loadEventManager() : null
Return values
null

modifyEvent()

Add / Edit Event

public modifyEvent([int $eventId = null ]) : null
Parameters
$eventId : int = null

Event id

Return values
null

myEvents()

performs the my events page

public myEvents([mixed &$firstEndDate = null ]) : null
Parameters
$firstEndDate : mixed = null
Return values
null

overview()

performs the overview page

public overview([mixed &$firstEndDate = null ]) : null
Parameters
$firstEndDate : mixed = null
Return values
null

showCategoryView()

set the placeholders for the category view

public showCategoryView([mixed &$firstEndDate = null ]) : null
Parameters
$firstEndDate : mixed = null
Return values
null

showRegistrationForm()

performs the registratio page

public showRegistrationForm() : null
Return values
null

showSuccessPage()

Display the success page

public showSuccessPage() : null
Return values
null

showThreeBoxes()

Performs the box view

public showThreeBoxes() : null
Return values
null

triggerEvent()

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
null

uploadFinished()

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
throws
Exception
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
Return values
null

        
On this page

Search results