Contentserv PHP API

CSGuiSimpleEditor extends CSGuiComponent
in package

The CSGuiSimpleEditor provides an out-of-the-box simple small editor component for any CONTENTSERV record type

The major job of the CSGuiEditor is to take care of the create and edit operations for a given record with the possibility to display multiple simple editors on the same frame even within a form, which should not store the simple editor fields. It is stored using ajax

Tags

Table of Contents

$isDisabled  : mixed
$isPortal  : mixed
$popup  : mixed
$popupIDField  : mixed
$popupUrl  : mixed
$storeLastValues  : mixed
__construct()  : mixed
Constructor for a CSGuiSimpleForm
addAttribute()  : void
adds additional attributes to the root html editor element
addCheckbox()  : CSGuiFormInputCehckbox
adds a checkbox to the editor
addCSSCode()  : void
Adds a css snippet to the windows internal css code as they are used in the head Note that links to urls within the file must be relative to the forward.php
addCSSLink()  : void
Adds a link to the windows external cascading style sheets Note that - that the admin.css is included by default - the link to the file is from the browsers point of view relative to the forward.php - that links to urls within the file are relative to the css file location.
addHiddenInput()  : CSGuiFormInput
adds a hidden input to the editor
addHtml()  : void
adds html to the editor
addIcon()  : void
adds a submit icon to the editor
addInput()  : CSGuiFormInput
adds an input to the editor
addJSAPI()  : void
Preloads a js API library instead of using CS.loadAPI in the code
addJSCode()  : void
Adds a js code snippet to the windows internal js scripts as they are used in the head or directly to the component
addJSLink()  : void
Adds a link to the windows external js scripts Note that the link to the file is from the browsers point of view relative to the forward.php
addJSUtils()  : void
Preloads a js util library instead of using CS.loadUtils in the code
addSelection()  : CSGuiFormInputSelect
adds a selection field to the editor
addSubmitIcon()  : void
adds a submit icon to the editor
addSubmitLink()  : void
adds a submit html snipped to the editor
enableJQuery()  : void
Enables JQuery by loading all required libraries
enableJQueryEasy()  : void
Enables JQuery easy by loading all required libraries (experimental only)
enableJQueryPlugin()  : bool
Enables jQuery plugin.
enableJQueryUI()  : void
Enables JQuery UI by loading all required libraries (experimental only)
enablePluginCalls()  : mixed
Enables / disables all calls to CSGuiComponent plugins, if it is not wanted
getController()  : object
returns the controller of this gui component
getID()  : string
gets the ID of this editor
getRegistry()  : Registry
Return the Users registry instance for this object
getSubmitUrl()  : mixed
Get's the submit url of the editor
isPortal()  : bool
Returns whether the component is used in the portal
isSubmitRequest()  : bool
checks whether the current request is a submit request for the current ID
loadFromPost()  : void
Loads the Records data from POST variables
makeForwardUrl()  : mixed
makeHtml()  : string
created the HTML content
popupAddCheckboxItem()  : void
Adds a checkbox popup item to the end of the current component's popup
popupAddItem()  : void
Adds a popup item to the end of the current component's popup
popupAddJavascriptFunction()  : void
Adds a Javascript method to the components Javascript which can be used to display a popup.
popupAddSeparator()  : void
Adds a popup separator item to the end of the current component's popup
popupAddSubMenuDefinition()  : void
Adds a definition (Icon, GroupIdentifier, GroupIndex) for a sub menu entry.
popupEnableDebugMode()  : mixed
popupEvaluateCode()  : mixed
Provides a condition which must be true if the popup item should be available
popupGetJavascript()  : string
Creates a javascript onContext='...' code, which can be inserted in a html component
popupGetMultipleRequestID()  : bool
This function may be used to check whether the request is a popupRequest for multiple elements.
popupGetRequestID()  : string
If a user request a popup the id describing the kind of request is returned here This function may also be used to check whether the request is a popupRequest.
popupInsertItem()  : void
Adds a popup item into a specified location of the current component's popup
popupMakeHtml()  : mixed
Creates the final popup html code
popupRemoveAllItems()  : void
Completely removes all popup items from the component
popupRemoveItem()  : void
Remove one items from the popup for the component
popupRemoveItemsByNamespace()  : void
Remove multiple from the popup specified by the namespace. All items having all the passed namespaces will be removed even if they are having more than the passed.
popupSetCharset()  : string
Sets the encoding for the popup components
popupSetDefaultPopup()  : void
Sets the default popup for the component
popupSetRequestID()  : void
Overwrites the id returned by popupSetRequestID
popupSetUrl()  : void
Changes the url where the popup should be loaded from.
popupSetVisible()  : void
Enables or disables the visiblity of the popup.
popupUseDefaultItem()  : void
Adds a standard popup item to the end of the current component's popup
setClass()  : void
sets the class of this editor
setController()  : void
sets the controller for the gui component
setID()  : void
sets the ID of this editor
setOnAfterSumbitJS()  : void
sets javascript which should be evaluated after the submit, where the js variable result contains the result from the server
setOnBeforeSumbitJS()  : void
sets javascript which should be evaluated before a submit
setPortalMode()  : void
Sets the component to the browsers portal
setSubmitUrl()  : void
Set's the submit url of the editor
throwError()  : void
Throws a CSException

Properties

$isDisabled

public mixed $isDisabled = \false
Tags
access

private

Methods

__construct()

Constructor for a CSGuiSimpleForm

public __construct(mixed $RecordName) : mixed
Parameters
$RecordName : mixed
Tags
string

mixed $RecordName either the RecordName as string, a Record object or null if no Record should be used

Return values
mixed

addAttribute()

adds additional attributes to the root html editor element

public addAttribute(mixed $key, mixed $value) : void
Parameters
$key : mixed
$value : mixed
Tags
access

public

Return values
void

addCheckbox()

adds a checkbox to the editor

public addCheckbox(string $name[, string $value = null ][, string $id = '' ][, mixed $isRecordField = true ]) : CSGuiFormInputCehckbox
Parameters
$name : string

the name of the input element

$value : string = null

the value of the input element

$id : string = ''

the id of the input element

$isRecordField : mixed = true
Tags
Return values
CSGuiFormInputCehckbox

the CSGuiForm checkbox element

addCSSCode()

Adds a css snippet to the windows internal css code as they are used in the head Note that links to urls within the file must be relative to the forward.php

public addCSSCode(string $sCode) : void
Parameters
$sCode : string

the code of the css without any <style> elements

Tags
access

public

Return values
void

Adds a link to the windows external cascading style sheets Note that - that the admin.css is included by default - the link to the file is from the browsers point of view relative to the forward.php - that links to urls within the file are relative to the css file location.

public addCSSLink(string $sCsslink) : void
Parameters
$sCsslink : string

the href of the css file

Tags
access

public

Return values
void

addHiddenInput()

adds a hidden input to the editor

public addHiddenInput(string $name[, string $value = null ][, string $id = '' ][, mixed $isRecordField = true ]) : CSGuiFormInput
Parameters
$name : string

the name of the input element

$value : string = null

the value of the input element

$id : string = ''

the id of the input element

$isRecordField : mixed = true
Tags
Return values
CSGuiFormInput

the CSGuiForm input element

addHtml()

adds html to the editor

public addHtml(string $html) : void
Parameters
$html : string

the html snippet to be added

Tags
Return values
void

addIcon()

adds a submit icon to the editor

public addIcon([string $src = '../admin/images/save.gif' ][, mixed $onClick = '' ][, mixed $id = '' ][, string $attributes = ' style="vertical-align:middle" ' ]) : void
Parameters
$src : string = '../admin/images/save.gif'

the src of the icon

$onClick : mixed = ''
$id : mixed = ''
$attributes : string = ' style="vertical-align:middle" '

the additional image attributes

Tags
Return values
void

addInput()

adds an input to the editor

public addInput(string $name[, string $value = null ][, string $id = '' ][, string $type = CSGuiForm::INPUT_TYPE_TEXT ][, bool $isRecordField = true ]) : CSGuiFormInput
Parameters
$name : string

the name of the input element

$value : string = null

the value of the input element

$id : string = ''

the id of the input element

$type : string = CSGuiForm::INPUT_TYPE_TEXT

the CSGuiForm type of the input element

$isRecordField : bool = true

whether the given $name belongs to a field which should be stored to the Record

Tags
Return values
CSGuiFormInput

the CSGuiForm input element

addJSAPI()

Preloads a js API library instead of using CS.loadAPI in the code

public addJSAPI(string $api) : void
Parameters
$api : string

the name of the CS API library in the ../admin/modules/[MODULE]/CS[MODULE].js directory

Tags
access

public

Return values
void

addJSCode()

Adds a js code snippet to the windows internal js scripts as they are used in the head or directly to the component

public addJSCode(string $sCode) : void
Parameters
$sCode : string

the code of the js without any <javasctipt> elements

Tags
access

public

Return values
void

Adds a link to the windows external js scripts Note that the link to the file is from the browsers point of view relative to the forward.php

public addJSLink(string $sHref) : void
Parameters
$sHref : string

the href of the js

Tags
access

public

Return values
void

addJSUtils()

Preloads a js util library instead of using CS.loadUtils in the code

public addJSUtils(string $util) : void
Parameters
$util : string

the name of the CS Util library in the ../admin/core/utils/js/ directory

Tags
access

public

Return values
void

addSelection()

adds a selection field to the editor

public addSelection(string $name[, array<string|int, mixed> $options = array() ][, string $id = '' ][, mixed $isRecordField = true ]) : CSGuiFormInputSelect
Parameters
$name : string

the name of the selection element

$options : array<string|int, mixed> = array()

the options of the selection element

$id : string = ''

the id of the selection element

$isRecordField : mixed = true
Tags
Return values
CSGuiFormInputSelect

the CSGuiForm selection element

addSubmitIcon()

adds a submit icon to the editor

public addSubmitIcon([string $src = '../admin/images/save.gif' ][, string $attributes = ' style="vertical-align:middle" ' ]) : void
Parameters
$src : string = '../admin/images/save.gif'

the src of the icon

$attributes : string = ' style="vertical-align:middle" '

the additional image attributes

Tags
Return values
void

adds a submit html snipped to the editor

public addSubmitLink(string $html) : void
Parameters
$html : string

the html content of the link

Tags
Return values
void

enableJQuery()

Enables JQuery by loading all required libraries

public enableJQuery() : void
Tags
Return values
void

enableJQueryEasy()

Enables JQuery easy by loading all required libraries (experimental only)

public enableJQueryEasy() : void
Tags
Return values
void

enableJQueryPlugin()

Enables jQuery plugin.

public enableJQueryPlugin(string $sPluginName) : bool

For possible plugins see ADMIN_LOCAL/lib/javascript/jquery/plugins subfolder.

Parameters
$sPluginName : string

The name of the jquery plugin (case sensitive) and without the "jquery." prefix. To load the jquery.cookie.js plugin give only "cookie" as param.

Tags
Return values
bool

Whenever the plugin path was found or not.

enableJQueryUI()

Enables JQuery UI by loading all required libraries (experimental only)

public enableJQueryUI() : void
Tags
Return values
void

enablePluginCalls()

Enables / disables all calls to CSGuiComponent plugins, if it is not wanted

public static enablePluginCalls([bool $enabled = false ]) : mixed
Parameters
$enabled : bool = false

whether plugin calls may be used

Tags
Return values
mixed

getController()

returns the controller of this gui component

public getController() : object
Tags
access

public

Return values
object

the controller of the gui component

getID()

gets the ID of this editor

public getID() : string
Tags
Return values
string

the ID of the form

getRegistry()

Return the Users registry instance for this object

public getRegistry([string $context = '' ]) : Registry
Parameters
$context : string = ''

the context of the registry object

Tags
Return values
Registry

the editors Registry object

getSubmitUrl()

Get's the submit url of the editor

public getSubmitUrl() : mixed
Tags
Return values
mixed

isPortal()

Returns whether the component is used in the portal

public static isPortal() : bool
Tags
access

protected

Return values
bool

whether the portal mode is activated

isSubmitRequest()

checks whether the current request is a submit request for the current ID

public isSubmitRequest() : bool
Tags
Return values
bool

whether the current request is a submit request

loadFromPost()

Loads the Records data from POST variables

public static loadFromPost([Record $record = null ]) : void
Parameters
$record : Record = null

the optional record where the POST variables should be loaded into

Tags
Return values
void

makeForwardUrl()

public static makeForwardUrl(mixed $url[, mixed $useRequestParams = array() ]) : mixed
Parameters
$url : mixed
$useRequestParams : mixed = array()
Tags
access

protected

Return values
mixed

makeHtml()

created the HTML content

public makeHtml() : string
Tags
Return values
string

the HTML content

popupAddCheckboxItem()

Adds a checkbox popup item to the end of the current component's popup

public popupAddCheckboxItem(mixed $sLabel, mixed $sJavascript[, mixed $bIsEnabled = true ][, mixed $bIsSelected = false ][, mixed $sAccessKey = '' ][, mixed $bEvalCondition = true ][, mixed $mNamespaces = array() ][, mixed $sGroupIdentifier = '' ], mixed $iGroupIndex) : void
Parameters
$sLabel : mixed
$sJavascript : mixed
$bIsEnabled : mixed = true
$bIsSelected : mixed = false
$sAccessKey : mixed = ''
$bEvalCondition : mixed = true
$mNamespaces : mixed = array()
$sGroupIdentifier : mixed = ''
$iGroupIndex : mixed
Tags
access

public

Return values
void

popupAddItem()

Adds a popup item to the end of the current component's popup

public popupAddItem(string $sLabel[, string $sJavascript = '' ][, int $bIsEnabled = true ][, string $sIconPath = '' ][, string $sAccessKey = '' ][, bool $bEvalCondition = true ][, array<string|int, mixed>|string $mNamespaces = array() ][, string $sGroupIdentifier = '' ], int $iGroupIndex) : void
Parameters
$sLabel : string

label of the popup item. It can use '//' to create a submenu, e.g. 'submenu_label//sub_submenu_label//label'

$sJavascript : string = ''

Javascript code to call with the popup item

$bIsEnabled : int = true

can be false if the popup item should be visible but disabled

$sIconPath : string = ''

Image of the item relative to the admin/images/popup/ directory

$sAccessKey : string = ''

Keyboard access key of the popup item

$bEvalCondition : bool = true

If the condition should be evaluated.

$mNamespaces : array<string|int, mixed>|string = array()

The namespace for the button like "workflow"

$sGroupIdentifier : string = ''

The identifier to add the popup item to a group, which has separator at the beginning and at the end.

$iGroupIndex : int

The index of the group. The index will be used to order the groups. The lowest index will be taken of all popup items inside of a group.

Tags
access

public

Return values
void

popupAddJavascriptFunction()

Adds a Javascript method to the components Javascript which can be used to display a popup.

public popupAddJavascriptFunction([string $jsName = 'displayComponentPopup' ]) : void

It can be called with the given name and the requested POPUPID and event (event object) as argument, e.g. displayComponentPopup(ID, event)

Parameters
$jsName : string = 'displayComponentPopup'

the name of the Javascript method, if it should be different from the standard 'displayComponentPopup'

Tags
Return values
void

popupAddSeparator()

Adds a popup separator item to the end of the current component's popup

public popupAddSeparator([string $evalCondition = true ][, string $subMenu = '' ]) : void
Parameters
$evalCondition : string = true

optional php condition to be evaluated as true to let the popup item be available

$subMenu : string = ''

optional sub menu the separator should be placed within. It can use '//' to add the seperator within a submenu, e.g. 'submenu_label//subsubmenu_label'

Tags
access

public

Return values
void

popupAddSubMenuDefinition()

Adds a definition (Icon, GroupIdentifier, GroupIndex) for a sub menu entry.

public popupAddSubMenuDefinition(string $sSubMenuLabel, string $sIcon[, string $sGroupIdentifier = '' ], int $iGroupIndex) : void
Parameters
$sSubMenuLabel : string

The target sub menu label

$sIcon : string

THe icon of the sub menu.

$sGroupIdentifier : string = ''

The group identifier

$iGroupIndex : int

The index of the group.

Tags
Return values
void

popupEnableDebugMode()

public popupEnableDebugMode() : mixed
Tags
access

private

Return values
mixed

popupEvaluateCode()

Provides a condition which must be true if the popup item should be available

public popupEvaluateCode(mixed $evalCode) : mixed

Sometimes it is necessary to evaluate further code to define a $evalCondition. As the condition only returns one value, this can not be done there. Therefore any phpCode can be evaluated using the popupEvaluateCode method. Here e.g. conditions can be stored in variables which can be used in the $evalCondition later. {RecordID} can be used to get the id of the current selected item

Parameters
$evalCode : mixed
Tags
access

public

Return values
mixed

popupGetJavascript()

Creates a javascript onContext='...' code, which can be inserted in a html component

public popupGetJavascript(string $id[, string $innerHtml = "" ][, string $elementName = 'span' ][, string $embedAttribute = 'oncontextmenu' ][, string $additionalAttributes = "" ][, string $popupUrl = '' ][, string $popupIDField = '' ][, string $jsCode = '' ]) : string
Parameters
$id : string

The value which will can be received using the popupGetRequestID() method

$innerHtml : string = ""

The content of the optional html element is not empty. If this value is not set the $id is used instead

$elementName : string = 'span'

An optional html element name which will contain the attribute

$embedAttribute : string = 'oncontextmenu'

The attribute which should contain the JavaScript code

$additionalAttributes : string = ""

Additional attributes which should be additionally added to the oncontext command

$popupUrl : string = ''

Overwrites the standard url where the popup is defined

$popupIDField : string = ''

Overwrites the standard IDField for the popup which will be added to the request and is necessary to get the results using the popupGetRequestID method if it has been modified

$jsCode : string = ''

The JavaScript code which should be evaluated before the contextmenu is shown

Tags
Return values
string

The JavaScript code or a complete html element which will create the popup request

popupGetMultipleRequestID()

This function may be used to check whether the request is a popupRequest for multiple elements.

public popupGetMultipleRequestID() : bool
Tags
Return values
bool

whether a popup request for multiple items have been sent

popupGetRequestID()

If a user request a popup the id describing the kind of request is returned here This function may also be used to check whether the request is a popupRequest.

public popupGetRequestID() : string
Tags
Return values
string

the ID for which a popup is requested

popupInsertItem()

Adds a popup item into a specified location of the current component's popup

public popupInsertItem(mixed $mIndex, mixed $sLabel[, mixed $sJavascript = '' ][, mixed $bIsEnabled = true ][, mixed $sIconPath = '' ][, mixed $sAccessKey = '' ][, mixed $bEvalCondition = true ][, mixed $mNamespaces = array() ][, mixed $sGroupIdentifier = '' ], mixed $iGroupIndex) : void
Parameters
$mIndex : mixed
$sLabel : mixed
$sJavascript : mixed = ''
$bIsEnabled : mixed = true
$sIconPath : mixed = ''
$sAccessKey : mixed = ''
$bEvalCondition : mixed = true
$mNamespaces : mixed = array()
$sGroupIdentifier : mixed = ''
$iGroupIndex : mixed
Tags
access

public

Return values
void

popupMakeHtml()

Creates the final popup html code

public popupMakeHtml(mixed $PopupID) : mixed
Parameters
$PopupID : mixed
Tags
access

protected

Return values
mixed

popupRemoveAllItems()

Completely removes all popup items from the component

public popupRemoveAllItems([array<string|int, mixed> $keep = array() ][, bool $recursive = false ]) : void
Parameters
$keep : array<string|int, mixed> = array()

the labels of the items which may be kept

$recursive : bool = false

whether this action should be applied to all subcomponents as subtrees in CSGuiMixedTrees

Tags
access

public

Return values
void

popupRemoveItem()

Remove one items from the popup for the component

public popupRemoveItem(string $label[, string|bool $evalCondition = true ][, array<string|int, mixed>|string $aNamespaces = array() ]) : void
Parameters
$label : string

label of the popup item

$evalCondition : string|bool = true

optional php condition to be evaluated as true to let the popup item be available {RecordID} can be used to get the id of the current selected item

$aNamespaces : array<string|int, mixed>|string = array()

Either a simple string for a namespace like "workflow" or an array for further specification like array("Workflow", "123"). All items having the same label and all namespaces passed set (even if they are having more) will be removed.

Tags
access

public

Return values
void

popupRemoveItemsByNamespace()

Remove multiple from the popup specified by the namespace. All items having all the passed namespaces will be removed even if they are having more than the passed.

public popupRemoveItemsByNamespace([array<string|int, mixed> $aNamespaces = array() ]) : void
Parameters
$aNamespaces : array<string|int, mixed> = array()

An array containing all the defined namespaces for the popup items to be removed

Tags
Return values
void

popupSetCharset()

Sets the encoding for the popup components

public popupSetCharset(mixed $charset) : string
Parameters
$charset : mixed
Tags
Return values
string

$charset the new characterset

popupSetDefaultPopup()

Sets the default popup for the component

public popupSetDefaultPopup(CSGuiPopup $popup) : void
Parameters
$popup : CSGuiPopup

Popup object to use as popup for the component

Tags
access

protected

Return values
void

popupSetRequestID()

Overwrites the id returned by popupSetRequestID

public popupSetRequestID(string $id) : void
Parameters
$id : string

the value of the id to overwrite

Tags
Return values
void

popupSetUrl()

Changes the url where the popup should be loaded from.

public popupSetUrl([string $popupUrl = '' ][, string $idField = 'POPUP_ID' ][, bool $recursive = false ]) : void

It can be set if the pure forward name is not sufficient or another file should be used for a popup request This is an important option to add additional GET parameters, which should be available again for popups You can add additionalParameters to the forward url using the & seperator, e.g 'destination.php&param1=true'

Parameters
$popupUrl : string = ''

the url where the popup is defined

$idField : string = 'POPUP_ID'

the IDField for the popup which will be added to the request and is necessary to get the results using the popupGetRequestID method if it has been modified

$recursive : bool = false

whether this action should be applied to all subcomponents as subtrees in CSGuiMixedTrees

Tags
access

public

Return values
void

popupSetVisible()

Enables or disables the visiblity of the popup.

public popupSetVisible([bool $visibility = null ]) : void

If a popupAddItem is called before, the popup is automatically set to visible . If you only create the popup menu when recieving the popupGetRequestID parameter you have to enable the popup menu manually. You can even hide the popup completly be setting the $visibility to false

Parameters
$visibility : bool = null

whether the component has a visible popup menu

Tags
access

public

Return values
void

popupUseDefaultItem()

Adds a standard popup item to the end of the current component's popup

public popupUseDefaultItem(string $label[, string|bool $evalCondition = true ]) : void

The popupitems defined using the popupSetDefaultPopup can be reused after popupRemoveAllItems has been called. This offers the possibility to reuse working popupitems in a userdefined popupmenu The type of popup item which should be used is defined by the $label parameter. This label represents the label of the original item

Parameters
$label : string

label of the popup item

$evalCondition : string|bool = true

php condition to be evaluated as true to let the popup item be available

Tags
access

public

Return values
void

setClass()

sets the class of this editor

public setClass([string $class = 'CSGuiSimpleEditor' ]) : void
Parameters
$class : string = 'CSGuiSimpleEditor'

the class of the form

Tags
Return values
void

setController()

sets the controller for the gui component

public setController(object $oController) : void
Parameters
$oController : object

the controller for the gui component

Tags
access

public

Return values
void

setID()

sets the ID of this editor

public setID(string $id) : void
Parameters
$id : string

the ID of the form

Tags
Return values
void

setOnAfterSumbitJS()

sets javascript which should be evaluated after the submit, where the js variable result contains the result from the server

public setOnAfterSumbitJS(string $js) : void
Parameters
$js : string

the Javascript code which should be evaluated after a submit

Tags
Return values
void

setOnBeforeSumbitJS()

sets javascript which should be evaluated before a submit

public setOnBeforeSumbitJS(string $js) : void
Parameters
$js : string

the Javascript code which should be evaluated before a submit. If it returns false, the submit is aborted

Tags
Return values
void

setPortalMode()

Sets the component to the browsers portal

public static setPortalMode([mixed $isPortal = true ]) : void
Parameters
$isPortal : mixed = true
Tags
access

protected

Return values
void

setSubmitUrl()

Set's the submit url of the editor

public setSubmitUrl([string $submitUrl = "" ][, array<string|int, mixed> $useRequestParams = array() ]) : void
Parameters
$submitUrl : string = ""

the submit url of the editor

$useRequestParams : array<string|int, mixed> = array()

an array of params which should be reused to complete the url

Tags
Return values
void

throwError()

Throws a CSException

public static throwError(string $sMessage, int $iCode) : void
Parameters
$sMessage : string
$iCode : int
Tags
Return values
void

        

Search results