Contentserv PHP API

CSGuiUploadDialog extends CSGuiModalDialog
in package

Core

GUI

The CSGuiWindow is the root class of all CSGui Windows and Dialogs and represents a full HTML window

All classes based on the CSGuiWindow return html including a head and body area. It enables you to add custom js and css code or link and to overwrite especially the method to create additional predefined dialogs. Additionally the CSGuiWindow already contains a link to the admin.css.

$_activatePatternCheck


    public
        mixed
    $_activatePatternCheck
     = \null

$additionalHead


    public
        mixed
    $additionalHead
     = ""

$ajaxReloadCompleteWindow


    public
        mixed
    $ajaxReloadCompleteWindow
     = \false

$ajaxReloadParts


    public
        mixed
    $ajaxReloadParts
     = array()

$bodyAttributes


    public
        mixed
    $bodyAttributes
     = ''

$bodyClasses


    public
        mixed
    $bodyClasses
     = array()

$bottomTitle


    public
        mixed
    $bottomTitle
     = ''

$cancelButtonID


    public
        mixed
    $cancelButtonID
     = "CSGUI_MODALDIALOG_CANCELBUTTON"

$cancelButtonLabel


    public
        mixed
    $cancelButtonLabel
     = ""

$cancelButtonOnClick


    public
        mixed
    $cancelButtonOnClick
     = "cancel();"

$charset


    public
        mixed
    $charset

$csscodes


    public
        mixed
    $csscodes
     = array()

$csslinks


    public
        mixed
    $csslinks
     = array()

$doctype


    public
        mixed
    $doctype

$formAttributes


    public
        mixed
    $formAttributes
     = " onsubmit='return false' "

$isAjaxReloadable


    public
        mixed
    $isAjaxReloadable
     = \false

$isDisabled


    public
        mixed
    $isDisabled
     = \false

$isPortal


    public
    static    mixed
    $isPortal
     = \false

$jscodes


    public
        mixed
    $jscodes
     = array('before' => array(), 'after' => array(), 'important' => array())

$jslinks


    public
        mixed
    $jslinks
     = array()

$jsprototyping


    public
        mixed
    $jsprototyping
     = \true

$metaData


    public
        mixed
    $metaData
     = array()

$okButtonID


    public
        mixed
    $okButtonID
     = "CSGUI_MODALDIALOG_OKBUTTON"

$okButtonLabel


    public
        mixed
    $okButtonLabel
     = ""

$okButtonOnClick


    public
        mixed
    $okButtonOnClick
     = "confirmDialog();"

$popup


    public
        mixed
    $popup

$popupIDField


    public
        mixed
    $popupIDField

$popupUrl


    public
        mixed
    $popupUrl

$rightTitle


    public
        mixed
    $rightTitle
     = ""

$rows


    public
        mixed
    $rows
     = array()

$showCancelButton


    public
        mixed
    $showCancelButton
     = \true

$showOkButton


    public
        mixed
    $showOkButton
     = \true

$showSubTitle


    public
        mixed
    $showSubTitle
     = \true

$showTitle


    public
        mixed
    $showTitle
     = \true

$subTitle


    public
        mixed
    $subTitle
     = '&nbsp;'

$type


    public
        mixed
    $type

$windowTitle


    public
        mixed
    $windowTitle

__construct()

CSGuiModalDialog constructor.


    public
                __construct() : mixed

Return values

mixed —

activateCompression()

Activates GZIP-Compression for this window


    public
            static    activateCompression([bool $activate = true ]) : mixed

Parameters

$activate : bool = true: whether the window should be compressed using gzip, or not

Return values

mixed —

activateDragAndDropHandling()

Activates drag and drop support for all browsers on this window.


    public
                activateDragAndDropHandling() : void

If required special mouse handlers are registered.

Return values

void —

activateNotes()

Activates the note mode for this window. If activated notes can be placed anywhere within the given target


    public
                activateNotes(mixed $mContextModules, string $contextRecord, string $contextID[, string $subContext = '' ][, float $zoom = '100' ][, string $targetElementID = '' ][, bool $autoLoad = true ]) : mixed

Parameters

$mContextModules : mixed: The context module of the note as a string (for a single module) or an array in case the notes for multiple modules should be returned.
$contextRecord : string: The record context the notes should be stored for
$contextID : string: The context id the notes should be stored for
$subContext : string = '': An optional subcontext the notes should be stored for
$zoom : float = '100': The current zoom level in percent
$targetElementID : string = '': The ID of the element the notes should be placed relative to. If null the window is the target
$autoLoad : bool = true: If true, the CSNotes.LoadNotes-JS-Method is executed to load all notes. Otherwise this method must be called by the developer

Return values

mixed —

activatePatternCheck()

Activates the pattern check for the form.


    public
                activatePatternCheck([string $attributeName = 'cs_pattern' ]) : void

Parameters

$attributeName : string = 'cs_pattern'

Return values

void —

addAdditionalButtonComponent()

Adds a HTML Component (string) in between OK and CANCEL button Several components may be added.


    public
                addAdditionalButtonComponent(string $sButtonComponentHtml) : void

Parameters

$sButtonComponentHtml : string

Return values

void —

addBodyAttributes()

Adds attributes to the body tag of the window


    public
                addBodyAttributes(string $bodyAttributes) : void

Parameters

$bodyAttributes : string: the additional attributes to be added to the body tag

Return values

void —

addBodyClass()

Adds a class to the body tag of the window


    public
                addBodyClass(string $className) : void

Parameters

$className : string: the additional classname to be added to the body tag

Return values

void —

addContent()

Adds any html output to the inner area of the window


    public
                addContent(string $content) : void

The inner content is captured with output buffering and returned later with the makeHtml method. Alternatively it's therefore possible to echo or output content directly.

Parameters

$content : string: the content to be added

Return values

void —

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 $code) : void

Parameters

$code : string: the code of the css without any <style> elements

Return values

void —

addCSSLink()

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 $href) : void

Parameters

$href : string: the href of the css file

Return values

void —

addEventListener()

Ads an event listener.


    public
                addEventListener(string $sEventName, string $sEventCodeJs) : void

Possible Events:

BeforeUpload
BeforeFileUpload
AfterFileUpload
AfterUpload
CancelUpload
SelectFile
DeselectFile

Parameters

$sEventName : string: The event name.
$sEventCodeJs : string: The javascript code. "his"-scope is the current uploader (CSGuiUploadApi). "event" is the event native browser event object. "data"-parameter is available depending on event type.

Return values

void —

addFile()

Includes any html or php file to the inner area of the window while executing contained php code


    public
                addFile(string $file) : void

Parameters

$file : string: the file to be added relative to the admin/forward.php

Return values

void —

addHeadHtml()

Add head content


    public
                addHeadHtml(string $html) : void

Parameters

$html : string: the content in form of HTML which should be added to the head

Return values

void —

addImportantJSCode()

Adds JavaScript code snippet to the windows internal scripts as they are used in the HEAD.


    public
                addImportantJSCode(string $sCodeSnippet) : void

The added code snippet is marked as 'important'. This code snippets are added BEFORE JavaScript code snippets added with addJSCode-method

Parameters

$sCodeSnippet : string: The pure JavaScript code (without script-tags)

Return values

void —

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

Return values

void —

addJSCode()

Adds JavaScript code snippet to the windows internal scripts as they are used in the HEAD.


    public
                addJSCode(string $code[, bool $before = true ]) : void

Parameters

$code : string: The code of the js without any <javasctipt> elements
$before : bool = true: If set to TRUE, the given code snippet is added to the head otherwise after BODY

Return values

void —

addJSLink()

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 $href) : void

Parameters

$href : string: the href of the js

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

Return values

void —

addMeta()

Adds a meta data to the windows head


    public
                addMeta(string $name, string $content) : void

Parameters

$name : string
$content : string

Return values

void —

addRow()

Adds another table row with one label and one input field


    public
                addRow(mixed $label, mixed $component[, mixed $additionalAttributes = '' ]) : void

Parameters

$label : mixed: the label of the input field
$component : mixed
$additionalAttributes : mixed = '': the html content of the input field, can be any valid HTML code

Return values

void —

disableJSPrototyping()

Due to backward compatibility CONTENTSERV uses prototyping on the javascript Object context (Object.prototype).


    public
                disableJSPrototyping() : mixed

This causes error in many scripts as the can not iterate through objects using for (var XXX in object) If no internal CS method is used which requires prototyping it can be disabled. In future version it might be disabled as standard behaviour

Return values

mixed —

enableJQuery()

Enables JQuery by loading all required libraries


    public
                enableJQuery() : void

Return values

void —

enableJQueryEasy()

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


    public
                enableJQueryEasy() : void

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.

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

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

Return values

mixed —

getActionUrl()

Returns the form action.


    public
                getActionUrl() : string

Return values

string —

getBasePath()

Returns the path to be used as a base for other page links


    public
                getBasePath() : string

Return values

string —

getController()

returns the controller of this gui component


    public
                getController() : object

Return values

object —

the controller of the gui component

getDefaultCancelButtonOnClick()

Returns the default javascript onclick code of the dialog.


    public
                getDefaultCancelButtonOnClick() : string

Return values

string —

getDefaultCloseDialogJs()

Returns the javascript code which closes the dialog and given $mReturnValue will be passed to the callback function defined upon the opening of dialog.


    public
                getDefaultCloseDialogJs(mixed $mReturnValue) : string

Parameters

$mReturnValue : mixed: A mixed type value which will be passed to the callback function.

Return values

string —

getDefaultOkButtonOnClick()

Returns the default js code snippet for OK button.


    public
                getDefaultOkButtonOnClick() : string

Return values

string —

getFormName()

Returns the Form name/id.


    public
                getFormName() : string

Return values

string —

getIEMetaCompatible()

Get the X-UA-Compatible meta tag string with given IE version.


    public
                getIEMetaCompatible(mixed $iIEVersion) : mixed

This string is used to render the window in desired mode (+ quircks mode).

Parameters

$iIEVersion : mixed

Return values

mixed —

getReturnOnlyFirst()

Returns the defined javascript dialog return type.


    public
                getReturnOnlyFirst() : bool

Default is FALSE, e.g. all values are returned

Return values

bool —

getTopWindow()

Returns the instance of the first opened CSGuiWindow component, which had not been build using makeHtml This method offers the possibility to place scripts, ... in the windows head section


    public
            static    getTopWindow() : CSGuiWindow

Return values

CSGuiWindow —

the top CSGuiWindow in the script

isAjaxReloadRequest()

Returns whether this request is a ajax reload request


    public
                isAjaxReloadRequest() : bool

Return values

bool —

whether a ajax reload request is passed

isPortal()

Returns whether the component is used in the portal


    public
            static    isPortal() : bool

Return values

bool —

whether the portal mode is activated

makeBody()


    public
                makeBody() : string

Return values

string —

makeForwardUrl()


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

Parameters

$url : mixed
$useRequestParams : mixed = array()

Return values

mixed —

makeHead()


    public
                makeHead() : mixed

Return values

mixed —

makeHtml()

Creates an html representation of the window according to the current settings


    public
                makeHtml() : string

Return values

string —

makeHtmlBegin()


    public
                makeHtmlBegin() : mixed

Return values

mixed —

makeHtmlEnd()


    public
                makeHtmlEnd() : mixed

Return values

mixed —

makeJSCode()

Returns a string with script-tags.


    public
                makeJSCode([string $section = 'before' ]) : string

Parameters

$section : string = 'before'

Return values

string —

makeOuterBody()


    public
                makeOuterBody() : mixed

Return values

mixed —

makeOuterHead()


    public
                makeOuterHead() : mixed

Return values

mixed —

makeRows()


    public
                makeRows() : string

Return values

string —

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

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.

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'

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'

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.

Return values

void —

popupEnableDebugMode()


    public
                popupEnableDebugMode() : mixed

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

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

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

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

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

Return values

void —

popupMakeHtml()

Creates the final popup html code


    public
                popupMakeHtml(mixed $PopupID) : mixed

Parameters

$PopupID : mixed

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

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.

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

Return values

void —

popupSetCharset()

Sets the encoding for the popup components


    public
                popupSetCharset(mixed $charset) : string

Parameters

$charset : mixed

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

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

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

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

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

Return values

void —

setActionUrl()

Set the form action.


    public
                setActionUrl(string $sActionUrl) : void

Parameters

$sActionUrl : string

Return values

void —

setAdditionalParams()

Sets additional params.


    public
                setAdditionalParams(array<string|int, mixed> $aParams) : void

This params are forwarded with the POST request of file upload. It is possible to retrieve them in CSFileUploadPlugin with getUploadParam-method. Not primitive values are converted into an JSON.

Parameters

$aParams : array<string|int, mixed>

Return values

void —

setAjaxReloadable()

Defines whether this window can be reloaded using ajax request to optimize performance


    public
                setAjaxReloadable([bool $isAjaxReloadable = true ]) : mixed

Parameters

$isAjaxReloadable : bool = true: whether this window can be ajax reloaded

Return values

mixed —

setAjaxReloadCompleteWindow()

Defines that the complete window contents must be reloaded If not set only the parts defined using the setAjaxReloadPart method are changed


    public
                setAjaxReloadCompleteWindow([mixed $ajaxReloadCompleteWindow = true ]) : void

Parameters

$ajaxReloadCompleteWindow : mixed = true

Return values

void —

setAjaxReloadPart()

If this window is defined ajax reloadable and a ajax reload request is passed this method can be used to change only parts of the html If no ajax part is defined the complete body ('CSGuiWindowBody') and head ('CSGuiWindowHead') is passed


    public
                setAjaxReloadPart(string $id, string $html) : string

Parameters

$id : string: the id of the html element which should be replaced
$html : string: the new html code for this element. If set to the boolean false this part is never added (until resetted with true)

Return values

string —

the $html

setAllowedFileTypes()

Sets the desired "allowed" file types.


    public
                setAllowedFileTypes(string|array<string|int, mixed> $aFileTypes) : void

Attention! The function filters not allowed file types.

Parameters

$aFileTypes : string|array<string|int, mixed>: A comma separated like "csv, xml" or an array of file types.

Return values

void —

setBasePath()

Defines the path to be used as a base for other page links


    public
                setBasePath(string $sHref) : void

Parameters

$sHref : string

Return values

void —

setBodyAttributes()

Sets the attributes in the body tag of the window


    public
                setBodyAttributes(string $bodyAttributes) : void

Parameters

$bodyAttributes : string: the attributes to be added to the body tag

Return values

void —

setBottomTitle()

Sets the BottomTitle of the Dialog


    public
                setBottomTitle(string $bottomTitle) : void

Parameters

$bottomTitle : string: the subtitle of the dialog

Return values

void —

setCancelButtonID()

Sets the id of the cancel button.


    public
                setCancelButtonID(string $id) : void

Parameters

$id : string: the id the button should have

Return values

void —

setCancelButtonLabel()

Sets the label of the cancel button.


    public
                setCancelButtonLabel(string $label) : void

Parameters

$label : string: the label the button should have

Return values

void —

setCancelButtonOnClick()

Sets the js function that is executed when the cancel button is pressed


    public
                setCancelButtonOnClick(string $onClick) : void

Parameters

$onClick : string: the onclick-code to be executed

Return values

void —

setCancelButtonVisible()

Sets the visibility of the Cancel Button


    public
                setCancelButtonVisible(bool $boolean) : void

Parameters

$boolean : bool: if true the Cancel Button is visible

Return values

void —

setCharset()

Overwrites the default charset of the html document (UTF-8)


    public
                setCharset(string $charset[, bool $changeLocale = true ]) : void

The charset argument is used in the content-type meta tag in the form

Parameters

$charset : string: the charset to use for the document
$changeLocale : bool = true: whether the new characterset should be applied to all translations

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

Return values

void —

setDoctype()

Overwrites the default Doctype of the html document


    public
                setDoctype(string $sDocType) : void

Parameters

$sDocType : string: The DOCTYPE line to use for the document

Return values

void —

setDuplicate()

Sets the duplicate flag.


    public
                setDuplicate([bool $bDuplicate = true ]) : void

If the uploaded files should be duplicates if a file is already existing.

Parameters

$bDuplicate : bool = true

Return values

void —

setFileName()

Sets the new desired FileName (with extension) of uploaded files


    public
                setFileName(string $sFileName) : void

Parameters

$sFileName : string

Return values

void —

setFileNamePrefix()

Sets a file name prefix


    public
                setFileNamePrefix(string $sPrefix) : void

Parameters

$sPrefix : string

Return values

void —

setFormAttributes()

Sets the attributes of the dialog form


    public
                setFormAttributes([string $attributes = " onsubmit='return false' " ]) : void

Parameters

$attributes : string = " onsubmit='return false' ": The new form attributes

Return values

void —

setFormName()

Sets the Form name/id.


    public
                setFormName(mixed $sName) : void

Parameters

$sName : mixed

Return values

void —

setFullHeight()

Sets whether the html and body tag should get 100% height attributes


    public
                setFullHeight([bool $fullHeight = true ]) : void

Parameters

$fullHeight : bool = true: whether 100% height should be used

Return values

void —

setHideButtonRow()

Sets whether the table row containing the buttons should be hidden


    public
                setHideButtonRow([bool $hide = true ]) : mixed

Parameters

$hide : bool = true: whether the row should be hidden

Return values

mixed —

setIEMetaCompatible()

Overwrites the default meta http-equiv of the html document.


    public
                setIEMetaCompatible(string $sNewIEMetaCompatible) : void

Parameters

$sNewIEMetaCompatible : string: The meta http-equiv line to use for the document. If set to FALSE the IE meta tag will be deactivated/removed.

Return values

void —

setMamFileId()

Sets a MamFile ID.


    public
                setMamFileId(int $sMamFileId) : void

If set all added files will be uploaded to given ID.

Parameters

$sMamFileId : int

Return values

void —

setMaxFileSize()

Defines the max file size (for singe file)


    public
                setMaxFileSize(int $iSize) : $this|CSGuiUpload

Parameters

$iSize : int: File size in BYTES (without any extension like MB, GB...)

Return values

$this|CSGuiUpload —

setOkButtonID()

Sets the id of the ok button.


    public
                setOkButtonID(string $id) : void

Parameters

$id : string: the id the button should have

Return values

void —

setOkButtonLabel()

Sets the label of the ok button.


    public
                setOkButtonLabel(string $label) : void

Parameters

$label : string: the label the button should have

Return values

void —

setOkButtonOnClick()

Sets the js function that is executed when the ok button is pressed


    public
                setOkButtonOnClick(string $onClick) : void

Parameters

$onClick : string: the onclick-code to be executed

Return values

void —

setOkButtonVisible()

Sets the visibility of the OK Button


    public
                setOkButtonVisible(bool $boolean) : void

Parameters

$boolean : bool: $boolean if true the OK Button is visible

Return values

void —

setOverwrite()

Sets the overwrite flag.


    public
                setOverwrite([bool $bOverwrite = true ]) : void

If uploaded files should overwrite already existing files.

Parameters

$bOverwrite : bool = true

Return values

void —

setPortalMode()

Sets the component to the browsers portal


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

Parameters

$isPortal : mixed = true

Return values

void —

setReturnOnlyFirst()

Defines in which way the return value of the dialog should be.


    public
                setReturnOnlyFirst(bool $mReturnType) : void

Possible states:

set to TRUE (previously known as $_REQUEST['returnOnlyFirst'] = true)
set to FALSE (default behaviour)

Parameters

$mReturnType : bool

Return values

void —

setRightTitle()

sets the top right title for the dialog


    public
                setRightTitle(string $title) : void

Parameters

$title : string: the title to show

Return values

void —

setSingleUpload()

Sets the component to SingleUpload, allowing to upload only one file.


    public
                setSingleUpload([bool $bSingeUpload = true ]) : void

Parameters

$bSingeUpload : bool = true

Return values

void —

setSubTitle()

Sets the SubTitle of the Dialog It is possible to set the Dialog Title and SubTitle dynamically by passing 'DialogTitle' and 'DialogSubTitle' upon dialog opening.


    public
                setSubTitle(string $subTitle) : void

e.g. window.csShowModalDialog( URL_DIALOG, {'DialogTitle' : 'MyCustomDialogTitle', 'DialogSubTitle' : 'MyCustomSubTitle'}, ... );

Parameters

$subTitle : string: the subtitle of the dialog

Return values

void —

setSubTitleVisible()

Sets the SubTitle Visibility of the Dialog.


    public
                setSubTitleVisible(bool $boolean) : void

Sets the visibility of the SubTitle.

Parameters

$boolean : bool: whether to show or to hide the subtitle

Return values

void —

setTitle()

Sets the title of the Dialog


    public
                setTitle(string $sTitle) : void

Parameters

$sTitle : string: The title of the dialog

Return values

void —

setTitleVisible()

Sets the Title Visibility of the Dialog Sets the visibility of the Title.


    public
                setTitleVisible(bool $boolean) : void

Parameters

$boolean : bool: whether to show or hide the title

Return values

void —

setType()

Sets the type of Editor


    public
                setType(string $type) : void

Parameters

$type : string: One of the defined constants CSGUI_DIALOG_TYPE_*

Return values

void —

setUniqueID()

Sets the CSUniqueID for this window


    public
                setUniqueID([bool|string $id = true ]) : void

Parameters

$id : bool|string = true: the new uniqueID either as string or as bool (false: no uniqueID is set, true: a random uniqueID is set)

Return values

void —

setUploadFolder()

Sets the upload folder for files.


    public
                setUploadFolder(string $sUploadFolder) : void

Parameters

$sUploadFolder : string: A relative path to ADMIN

Return values

void —

setWindowTitle()

Sets the window title as it is used in the heads title element


    public
                setWindowTitle(string $title) : void

Parameters

$title : string: the title to use for the document

Return values

void —

throwError()

Throws a CSException


    public
            static    throwError(string $sMessage, int $iCode) : void

Parameters

$sMessage : string
$iCode : int

Return values

void —

CSGuiUploadDialog extends CSGuiModalDialog in package Core GUI

Tags

Table of Contents

Properties

$_activatePatternCheck

Tags

$additionalHead

Tags

$ajaxReloadCompleteWindow

Tags

$ajaxReloadParts

Tags

$bodyAttributes

Tags

$bodyClasses

Tags

$bottomTitle

Tags

$cancelButtonID

Tags

$cancelButtonLabel

Tags

$cancelButtonOnClick

Tags

$charset

Tags

$csscodes

Tags

$csslinks

Tags

$doctype

Tags

$formAttributes

Tags

$isAjaxReloadable

Tags

$isDisabled

Tags

$isPortal

Tags

$jscodes

Tags

$jslinks

Tags

$jsprototyping

Tags

$metaData

Tags

$okButtonID

Tags

$okButtonLabel

Tags

$okButtonOnClick

Tags

$popup

Tags

$popupIDField

Tags

$popupUrl

Tags

$rightTitle

Tags

$rows

Tags

$showCancelButton

Tags

$showOkButton

Tags

$showSubTitle

Tags

$showTitle

Tags

$subTitle

Tags

$type

Tags

$windowTitle

Tags

Methods

__construct()

CSGuiUploadDialog extends CSGuiModalDialog
in package

Core

GUI