DataFieldEntry Class Reference

Inheritance diagram for DataFieldEntry:

Collaboration diagram for DataFieldEntry:

Public Member Functions
	__construct (DataField $datafield=null, $rangeID='', $value=null)
	store ()
	isRequired ()
	getDescription ()
	getType ()
	getDisplayValue ($entities=true)
	getValue ()
	getName ()
	getId ()
	getHTML ($name='', $variables=array())
	setValue ($value)
	setValueFromSubmit ($submitted_value)
	setRangeID ($range_id)
	setSecondRangeID ($sec_range_id)
	setContentLanguage ($language)
	isEmpty ()
	isValid ()
	numberOfHTMLFields ()
	getRangeID ()
	getSecondRangeID ()
	isVisible ($perm=null, $test_ownership=true)
	isEditable ($perms=null)
	isI18N ()
	getPermsDescription ()

Static Public Member Functions
static	getSupportedTypes ()
static	createDataFieldEntry (DataField $datafield, $rangeID='', $value=null)
static	getDataFieldEntries ($range_id, $object_type='', $object_class_hint='')
static	removeAll ($range_id)

Data Fields
	$value
	$model
	$rangeID

Protected Member Functions
	prettyPrintViewPerms ()

Protected Attributes
	$language = ''

Static Protected Attributes
static	$supported_types

Detailed Description

DataFieldEntry.class.php

Author

Jan-Hendrik Willms tleil.nosp@m.ax+s.nosp@m.tudip.nosp@m.@gma.nosp@m.il.co.nosp@m.m

Marcus Lunzenauer mlunz.nosp@m.ena@.nosp@m.uos.d.nosp@m.e

Martin Gieseking mgies.nosp@m.eki@.nosp@m.uos.d.nosp@m.e @license GPL2 or any later version

Constructor & Destructor Documentation

__construct()

__construct	(	DataField	$datafield = null,
			$rangeID = '',
			$value = null
	)

Constructs this datafield

Parameters

DataField	$datafield	Underlying model
mixed	$range_id	Range id (or array with range id and secondary range id)
mixed	$value	Value

Reimplemented in DataFieldI18NEntry, DataFieldSelectboxMultipleEntry, DataFieldComboEntry, and DataFieldSelectboxEntry.

Member Function Documentation

createDataFieldEntry()

static createDataFieldEntry ( DataField  $datafield,   $rangeID = '',   $value = null  )

static

Factory method that returns the appropriate datafield object for the given parameters.

Parameters

DataField	$datafield	Underlying structure
String	$rangeID	Range id
mixed	$value	Value of the entry

Returns

DataFieldEntry instance of appropriate type

Here is the caller graph for this function:

getDataFieldEntries()

static getDataFieldEntries (   $range_id,   $object_type = '',   $object_class_hint = ''  )

static

Enter description here...

Parameters

unknown_type	$range_id
unknown_type	$object_type
unknown_type	$object_class_hint

Returns

unknown

Here is the call graph for this function:

Here is the caller graph for this function:

getDescription()

getDescription

(

)

Returns the description of this datafield

Returns

String containing the description

getDisplayValue()

getDisplayValue

(

$entities = true

)

Returns the display/rendered value of this datafield

Parameters

bool

$entities

Should html entities be encoded (defaults to true)

Returns

String containg the rendered value

Reimplemented in DataFieldBoolEntry, DataFieldI18NEntry, DataFieldLinkEntry, DataFieldPhoneEntry, DataFieldSelectboxEntry, DataFieldSelectboxMultipleEntry, DataFieldTextareaEntry, DataFieldTextmarkupEntry, DataFieldTextmarkupi18nEntry, and DataFieldDateEntry.

Here is the call graph for this function:

getHTML()

getHTML	(		$name = '',
			$variables = array()
	)

Returns the according input elements as html for this datafield

Parameters

String	$name	Name prefix of the associated input
Array	$variables	Additional variables

Returns

String containing the required html

Reimplemented in DataFieldComboEntry, DataFieldDateEntry, DataFieldPhoneEntry, DataFieldRadioEntry, DataFieldSelectboxEntry, DataFieldSelectboxMultipleEntry, DataFieldTextareai18nEntry, DataFieldTextlineEntry, DataFieldTextlinei18nEntry, DataFieldTextmarkupEntry, DataFieldTextmarkupi18nEntry, and DataFieldTimeEntry.

Here is the call graph for this function:

getId()

getId

(

)

Returns the id of the datafield

Returns

String containing the id

getName()

getName

(

)

Returns the name of the datafield

Returns

String containing the name

getPermsDescription()

getPermsDescription

(

)

Returns a human readable string describing the view permissions

Returns

String containing the descriptons of the view permissions

Here is the call graph for this function:

getRangeID()

getRangeID

(

)

Returns the range id

Returns

String containing the range id

Here is the caller graph for this function:

getSecondRangeID()

getSecondRangeID

(

)

Returns the secondary range id

Returns

String containing the secondary range id

Here is the caller graph for this function:

getSupportedTypes()

static getSupportedTypes ( )

static

Returns all supported datafield types

Returns

array of supported types

getType()

getType

(

)

Returns the type of this datafield

Returns

string type of entry

Here is the caller graph for this function:

getValue()

getValue

(

)

Returns the value of the datafield

Returns

mixed containing the value

Here is the caller graph for this function:

isEditable()

isEditable

(

$perms = null

)

Returns whether the datafield is editable for the current user

Parameters

mixed

$perms

Perms to test against (optional, defaults to logged in user's perms)

Returns

boolean indicating whether the datafield is editable

Here is the call graph for this function:

isEmpty()

isEmpty

(

)

Checks if datafield is empty (was not set)

Returns

bool true if empty, else false

Reimplemented in DataFieldPhoneEntry, and DataFieldTimeEntry.

Here is the call graph for this function:

isI18N()

isI18N

(

)

Returns whether the datafield is an i18n field.

Returns

boolean indicating whether the datafield is a 18n field

Here is the call graph for this function:

isRequired()

isRequired

(

)

Returns whether this datafield is required

Returns

bool indicating whether the datafield is required or not

Here is the caller graph for this function:

isValid()

isValid

(

)

Returns whether the datafield contents are valid

Returns

boolean indicating whether the datafield contents are valid

Reimplemented in DataFieldDateEntry, DataFieldEmailEntry, DataFieldLinkEntry, DataFieldPhoneEntry, and DataFieldTimeEntry.

Here is the call graph for this function:

isVisible()

isVisible	(		$perm = null,
			$test_ownership = true
	)

Returns whether the datafield is visible for the current user

Parameters

String	$perm	Permissions to test against (optional, default to the current user's permissions)
bool	$test_ownership	Defines whether the ownership of the field should be taken into account; a field may be invisible for a user according to the permissions but since the datafield belongs to the user, it is visible.

Returns

boolean indicating whether the datafield is visible

Here is the call graph for this function:

numberOfHTMLFields()

numberOfHTMLFields

(

)

Returns the number of html fields this datafield uses for input.

Returns

int representing the number of html fields

Reimplemented in DataFieldComboEntry, DataFieldDateEntry, DataFieldPhoneEntry, DataFieldRadioEntry, and DataFieldTimeEntry.

prettyPrintViewPerms()

prettyPrintViewPerms ( )

protected

Generates a full status description depending on the the perms

Returns

string

Here is the caller graph for this function:

removeAll()

static removeAll (   $range_id )

static

Removes all datafields from a given range_id (and secondary range id if passed as array)

Parameters

mixed

$range_id

Range id (or array with range id and secondary range id)

Returns

int representing the number of deleted entries

Here is the call graph for this function:

Here is the caller graph for this function:

setContentLanguage()

setContentLanguage

(

$language

)

Sets the prefered content language if this is an i18n datafield.

Parameters

string

$language

The prefered display language

Reimplemented in DataFieldI18NEntry.

Here is the call graph for this function:

setRangeID()

setRangeID

(

$range_id

)

Sets the range id

Parameters

String

$range_id

Range id

setSecondRangeID()

setSecondRangeID

(

$sec_range_id

)

Sets the secondary range id

Parameters

String

$sec_range_id

Secondary range id

Here is the call graph for this function:

setValue()

setValue

(

$value

)

Sets the value

Parameters

mixed

$value

The value

Here is the caller graph for this function:

setValueFromSubmit()

setValueFromSubmit

(

$submitted_value

)

Sets the value from a post request

Parameters

mixed

$submitted_value

The value from request

Reimplemented in DataFieldBoolEntry, DataFieldI18NEntry, DataFieldLinkEntry, DataFieldTextmarkupEntry, DataFieldTextmarkupi18nEntry, DataFieldComboEntry, DataFieldDateEntry, DataFieldPhoneEntry, DataFieldSelectboxMultipleEntry, and DataFieldTimeEntry.

Here is the call graph for this function:

store()

store

(

)

Stores this datafield entry

Returns

int representing the number of changed entries

Reimplemented in DataFieldI18NEntry.

Here is the call graph for this function:

Field Documentation

$language

$language = ''

protected

$model

$model

$rangeID

$rangeID

$supported_types

$supported_types

staticprotected

Initial value:

= array(
        'bool',
        'textline',
        'textlinei18n',
        'textarea',
        'textareai18n',
        'textmarkup',
        'textmarkupi18n',
        'selectbox',
        'selectboxmultiple',
        'date',
        'time',
        'email',
        'phone',
        'radio',
        'combo',
        'link',
    )

$value

$value

---

The documentation for this class was generated from the following file:

• lib/classes/DataFieldEntry.class.php