Class to manage standard extra fields. More...

Collaboration diagram for ExtraFields:

Public Member Functions
	__construct ($db)
	Constructor. More...

	addExtraField ($attrname, $label, $type, $pos, $size, $elementtype, $unique=0, $required=0, $default_value='', $param='', $alwayseditable=0, $perms='', $list='-1', $help='', $computed='', $entity='', $langfile='', $enabled='1', $totalizable=0, $printable=0, $moreparams=array())
	Add a new extra field parameter. More...

	delete ($attrname, $elementtype='member')
	Delete an optional attribute. More...

	update ($attrname, $label, $type, $length, $elementtype, $unique=0, $required=0, $pos=0, $param='', $alwayseditable=0, $perms='', $list='', $help='', $default='', $computed='', $entity='', $langfile='', $enabled='1', $totalizable=0, $printable=0, $moreparams=array())
	Modify type of a personalized attribute. More...

	fetch_name_optionals_label ($elementtype, $forceload=false)
	Load array this->attributes. More...

	showInputField ($key, $value, $moreparam='', $keysuffix='', $keyprefix='', $morecss='', $objectid=0, $extrafieldsobjectkey='', $mode=0)
	Return HTML string to put an input field into a page Code very similar with showInputField of common object. More...

	showOutputField ($key, $value, $moreparam='', $extrafieldsobjectkey='')
	Return HTML string to put an output field into a page. More...

	getAlignFlag ($key, $extrafieldsobjectkey='')
	Return the CSS to use for this extrafield into list. More...

	showSeparator ($key, $object, $colspan=2, $display_type='card', $mode='')
	Return HTML string to print separator extrafield. More...

	setOptionalsFromPost ($extralabels, &$object, $onlykey='', $todefaultifmissing=0)
	Fill array_options property of object by extrafields value (using for data sent by forms) More...

	getOptionalsFromPost ($extrafieldsobjectkey, $keyprefix='', $keysuffix='')
	return array_options array of data of extrafields value of object sent by a search form More...

Private Member Functions
	create ($attrname, $type='varchar', $length=255, $elementtype='member', $unique=0, $required=0, $default_value='', $param='', $perms='', $list='0', $computed='', $help='', $moreparams=array())
	Add a new optional attribute. More...

	create_label ($attrname, $label='', $type='', $pos=0, $size=0, $elementtype='member', $unique=0, $required=0, $param='', $alwayseditable=0, $perms='', $list='-1', $help='', $default='', $computed='', $entity='', $langfile='', $enabled='1', $totalizable=0, $printable=0, $moreparams=array())
	Add description of a new optional attribute. More...

	delete_label ($attrname, $elementtype='member')
	Delete description of an optional attribute. More...

	update_label ($attrname, $label, $type, $size, $elementtype, $unique=0, $required=0, $pos=0, $param='', $alwayseditable=0, $perms='', $list='0', $help='', $default='', $computed='', $entity='', $langfile='', $enabled='1', $totalizable=0, $printable=0, $moreparams=array())
	Modify description of personalized attribute. More...

Detailed Description

Class to manage standard extra fields.

Definition at line 39 of file extrafields.class.php.

Constructor & Destructor Documentation

◆ __construct()

ExtraFields::__construct ( $db )

Constructor.

Parameters

DoliDB $db Database handler

Definition at line 105 of file extrafields.class.php.

References db.

Member Function Documentation

◆ addExtraField()

ExtraFields::addExtraField	(	$attrname,
		$label,
		$type,
		$pos,
		$size,
		$elementtype,
		$unique = `0`,
		$required = `0`,
		$default_value = `''`,
		$param = `''`,
		$alwayseditable = `0`,
		$perms = `''`,
		$list = `'-1'`,
		$help = `''`,
		$computed = `''`,
		$entity = `''`,
		$langfile = `''`,
		$enabled = `'1'`,
		$totalizable = `0`,
		$printable = `0`,
		$moreparams = `array()`
	)

Add a new extra field parameter.

Parameters

string	$attrname	Code of attribute
string	$label	label of attribute
string	$type	Type of attribute ('boolean','int','varchar','text','html','date','datehour','price', 'pricecy', 'phone','mail','password','url','select','checkbox','separate',...)
int	$pos	Position of attribute
string	$size	Size/length definition of attribute ('5', '24,8', ...). For float, it contains 2 numeric separated with a comma.
string	$elementtype	Element type. Same value than object->table_element (Example 'member', 'product', 'thirdparty', ...)
int	$unique	Is field unique or not
int	$required	Is field required or not
string	$default_value	Defaulted value (In database. use the default_value feature for default value on screen. Example: '', '0', 'null', 'avalue')
array \| string	$param	Params for field (ex for select list : array('options' => array(value'=>'label of option')) )
int	$alwayseditable	Is attribute always editable regardless of the document status
string	$perms	Permission to check
string	$list	Visibilty ('0'=never visible, '1'=visible on list+forms, '2'=list only, '3'=form only or 'eval string')
string	$help	Text with help tooltip
string	$computed	Computed value
string	$entity	Entity of extrafields (for multicompany modules)
string	$langfile	Language file
string	$enabled	Condition to have the field enabled or not
int	$totalizable	Is a measure. Must show a total on lists
int	$printable	Is extrafield displayed on PDF
array	$moreparams	More parameters. Example: array('css'=>, 'csslist'=>Css on list, 'cssview'=>...)

Returns: int <=0 if KO, >0 if OK

Definition at line 139 of file extrafields.class.php.

◆ create()

ExtraFields::create	(	$attrname,
		$type = `'varchar'`,
		$length = `255`,
		$elementtype = `'member'`,
		$unique = `0`,
		$required = `0`,
		$default_value = `''`,
		$param = `''`,
		$perms = `''`,
		$list = `'0'`,
		$computed = `''`,
		$help = `''`,
		$moreparams = `array()`
	)

private

Add a new optional attribute.

This is a private method. For public method, use addExtraField.

Parameters

string	$attrname	code of attribute
int	$type	Type of attribute ('boolean', 'int', 'varchar', 'text', 'html', 'date', 'datehour','price','pricecy','phone','mail','password','url','select','checkbox', ...)
string	$length	Size/length of attribute ('5', '24,8', ...)
string	$elementtype	Element type ('member', 'product', 'thirdparty', 'contact', ...)
int	$unique	Is field unique or not
int	$required	Is field required or not
string	$default_value	Default value for field (in database)
array	$param	Params for field (ex for select list : array('options'=>array('value'=>'label of option'))
string	$perms	Permission
string	$list	Into list view by default
string	$computed	Computed value
string	$help	Help on tooltip
array	$moreparams	More parameters. Example: array('css'=>, 'csslist'=>, 'cssview'=>...)

Returns: int <=0 if KO, >0 if OK

Definition at line 201 of file extrafields.class.php.

◆ create_label()

ExtraFields::create_label	(	$attrname,
		$label = `''`,
		$type = `''`,
		$pos = `0`,
		$size = `0`,
		$elementtype = `'member'`,
		$unique = `0`,
		$required = `0`,
		$param = `''`,
		$alwayseditable = `0`,
		$perms = `''`,
		$list = `'-1'`,
		$help = `''`,
		$default = `''`,
		$computed = `''`,
		$entity = `''`,
		$langfile = `''`,
		$enabled = `'1'`,
		$totalizable = `0`,
		$printable = `0`,
		$moreparams = `array()`
	)

private

Add description of a new optional attribute.

Parameters

string	$attrname	code of attribute
string	$label	label of attribute
int	$type	Type of attribute ('int', 'varchar', 'text', 'html', 'date', 'datehour', 'float')
int	$pos	Position of attribute
string	$size	Size/length of attribute ('5', '24,8', ...)
string	$elementtype	Element type ('member', 'product', 'thirdparty', ...)
int	$unique	Is field unique or not
int	$required	Is field required or not
array \| string	$param	Params for field (ex for select list : array('options' => array(value'=>'label of option')) )
int	$alwayseditable	Is attribute always editable regardless of the document status
string	$perms	Permission to check
string	$list	Visibily
string	$help	Help on tooltip
string	$default	Default value (in database. use the default_value feature for default value on screen).
string	$computed	Computed value
string	$entity	Entity of extrafields
string	$langfile	Language file
string	$enabled	Condition to have the field enabled or not
int	$totalizable	Is a measure. Must show a total on lists
int	$printable	Is extrafield displayed on PDF
array	$moreparams	More parameters. Example: array('css'=>, 'csslist'=>, 'cssview'=>...)

Returns: int <=0 if KO, >0 if OK

Exceptions

Exception

Definition at line 305 of file extrafields.class.php.

◆ delete()

ExtraFields::delete	(	$attrname,
		$elementtype = `'member'`
	)

Delete an optional attribute.

Parameters

string	$attrname	Code of attribute to delete
string	$elementtype	Element type ('member', 'product', 'thirdparty', 'contact', ...)

Returns: int < 0 if KO, 0 if nothing is done, 1 if OK

Definition at line 436 of file extrafields.class.php.

◆ delete_label()

ExtraFields::delete_label	(	$attrname,
		$elementtype = `'member'`
	)

private

Delete description of an optional attribute.

Parameters

string	$attrname	Code of attribute to delete
string	$elementtype	Element type ('member', 'product', 'thirdparty', ...)

Returns: int < 0 if KO, 0 if nothing is done, 1 if OK

Definition at line 494 of file extrafields.class.php.

◆ fetch_name_optionals_label()

ExtraFields::fetch_name_optionals_label	(	$elementtype,
		$forceload = `false`
	)

Load array this->attributes.

Parameters

string	$elementtype	Type of element ('' = all or $object->table_element like 'adherent', 'commande', 'thirdparty', 'facture', 'propal', 'product', ...).
boolean	$forceload	Force load of extra fields whatever is status of cache.

Returns: array Array of attributes keys+label for all extra fields.

Definition at line 829 of file extrafields.class.php.

◆ getAlignFlag()

ExtraFields::getAlignFlag	(	$key,
		$extrafieldsobjectkey = `''`
	)

Return the CSS to use for this extrafield into list.

Parameters

string	$key	Key of attribute
string	$extrafieldsobjectkey	If defined, use the new method to get extrafields data

Returns: string Formated value

Definition at line 1917 of file extrafields.class.php.

◆ getOptionalsFromPost()

ExtraFields::getOptionalsFromPost	(	$extrafieldsobjectkey,
		$keyprefix = `''`,
		$keysuffix = `''`
	)

return array_options array of data of extrafields value of object sent by a search form

Parameters

array \| string	$extrafieldsobjectkey	array of extrafields (old usage) or value of object->table_element (new usage)
string	$keyprefix	Prefix string to add into name and id of field (can be used to avoid duplicate names)
string	$keysuffix	Suffix string to add into name and id of field (can be used to avoid duplicate names)

Returns: array|int array_options set or 0 if no value

Definition at line 2185 of file extrafields.class.php.

◆ setOptionalsFromPost()

ExtraFields::setOptionalsFromPost	(		$extralabels,
		&	$object,
			$onlykey = `''`,
			$todefaultifmissing = `0`
	)

Fill array_options property of object by extrafields value (using for data sent by forms)

Parameters

array \| null	$extralabels	Deprecated (old $array of extrafields, now set this to null)
object	$object	Object
string	$onlykey	Only some keys are filled: 'string' => When we make update of only one extrafield ($action = 'update_extras'), calling page can set this to avoid to have other extrafields being reset. '@GETPOSTISSET' => When we make update of several extrafields ($action = 'update'), calling page can set this to avoid to have fields not into POST being reset.
int	$todefaultifmissing	1=Set value to the default value in database if value is mandatory and missing

Returns: int 1 if array_options set, 0 if no value, -1 if error (field required missing for example)

Definition at line 2048 of file extrafields.class.php.

◆ showInputField()

ExtraFields::showInputField	(	$key,
		$value,
		$moreparam = `''`,
		$keysuffix = `''`,
		$keyprefix = `''`,
		$morecss = `''`,
		$objectid = `0`,
		$extrafieldsobjectkey = `''`,
		$mode = `0`
	)

Return HTML string to put an input field into a page Code very similar with showInputField of common object.

Parameters

string	$key	Key of attribute
string \| array	$value	Preselected value to show (for date type it must be in timestamp format, for amount or price it must be a php numeric value); for dates in filter mode, a range array('start'=><timestamp>, 'end'=><timestamp>) should be provided
string	$moreparam	To add more parameters on html input tag
string	$keysuffix	Prefix string to add after name and id of field (can be used to avoid duplicate names)
string	$keyprefix	Suffix string to add before name and id of field (can be used to avoid duplicate names)
string	$morecss	More css (to defined size of field. Old behaviour: may also be a numeric)
int	$objectid	Current object id
string	$extrafieldsobjectkey	The key to use to store retreived data (for example $object->table_element)
string	$mode	1=Used for search filters

Returns: string

Definition at line 933 of file extrafields.class.php.

◆ showOutputField()

ExtraFields::showOutputField	(	$key,
		$value,
		$moreparam = `''`,
		$extrafieldsobjectkey = `''`
	)

Return HTML string to put an output field into a page.

Parameters

string	$key	Key of attribute
string	$value	Value to show
string	$moreparam	To add more parameters on html input tag (only checkbox use html input for output rendering)
string	$extrafieldsobjectkey	Required (for example $object->table_element).

Returns: string Formated value

Definition at line 1577 of file extrafields.class.php.

◆ showSeparator()

ExtraFields::showSeparator	(	$key,
		$object,
		$colspan = `2`,
		$display_type = `'card'`,
		$mode = `''`
	)

Return HTML string to print separator extrafield.

Parameters

string	$key	Key of attribute
object	$object	Object
int	$colspan	Value of colspan to use (it must includes the first column with title)
string	$display_type	"card" for form display, "line" for document line display (extrafields on propal line, order line, etc...)
string	$mode	Show output ('view') or input ('create' or 'edit') for extrafield

Returns: string HTML code with line for separator

Definition at line 1957 of file extrafields.class.php.

◆ update()

ExtraFields::update	(	$attrname,
		$label,
		$type,
		$length,
		$elementtype,
		$unique = `0`,
		$required = `0`,
		$pos = `0`,
		$param = `''`,
		$alwayseditable = `0`,
		$perms = `''`,
		$list = `''`,
		$help = `''`,
		$default = `''`,
		$computed = `''`,
		$entity = `''`,
		$langfile = `''`,
		$enabled = `'1'`,
		$totalizable = `0`,
		$printable = `0`,
		$moreparams = `array()`
	)

Modify type of a personalized attribute.

Parameters

string	$attrname	Name of attribute
string	$label	Label of attribute
string	$type	Type of attribute ('boolean', 'int', 'varchar', 'text', 'html', 'date', 'datehour','price','phone','mail','password','url','select','checkbox', ...)
int	$length	Length of attribute
string	$elementtype	Element type ('member', 'product', 'thirdparty', 'contact', ...)
int	$unique	Is field unique or not
int	$required	Is field required or not
int	$pos	Position of attribute
array	$param	Params for field (ex for select list : array('options' => array(value'=>'label of option')) )
int	$alwayseditable	Is attribute always editable regardless of the document status
string	$perms	Permission to check
string	$list	Visibility
string	$help	Help on tooltip
string	$default	Default value (in database. use the default_value feature for default value on screen).
string	$computed	Computed value
string	$entity	Entity of extrafields
string	$langfile	Language file
string	$enabled	Condition to have the field enabled or not
int	$totalizable	Is extrafield totalizable on list
int	$printable	Is extrafield displayed on PDF
array	$moreparams	More parameters. Example: array('css'=>, 'csslist'=>, 'cssview'=>...)

Returns: int >0 if OK, <=0 if KO

Exceptions

Exception

Definition at line 552 of file extrafields.class.php.

◆ update_label()

ExtraFields::update_label	(	$attrname,
		$label,
		$type,
		$size,
		$elementtype,
		$unique = `0`,
		$required = `0`,
		$pos = `0`,
		$param = `''`,
		$alwayseditable = `0`,
		$perms = `''`,
		$list = `'0'`,
		$help = `''`,
		$default = `''`,
		$computed = `''`,
		$entity = `''`,
		$langfile = `''`,
		$enabled = `'1'`,
		$totalizable = `0`,
		$printable = `0`,
		$moreparams = `array()`
	)

private

Modify description of personalized attribute.

Parameters

string	$attrname	Name of attribute
string	$label	Label of attribute
string	$type	Type of attribute
int	$size	Length of attribute
string	$elementtype	Element type ('member', 'product', 'thirdparty', ...)
int	$unique	Is field unique or not
int	$required	Is field required or not
int	$pos	Position of attribute
array	$param	Params for field (ex for select list : array('options' => array(value'=>'label of option')) )
int	$alwayseditable	Is attribute always editable regardless of the document status
string	$perms	Permission to check
string	$list	Visiblity
string	$help	Help on tooltip.
string	$default	Default value (in database. use the default_value feature for default value on screen).
string	$computed	Computed value
string	$entity	Entity of extrafields
string	$langfile	Language file
string	$enabled	Condition to have the field enabled or not
int	$totalizable	Is extrafield totalizable on list
int	$printable	Is extrafield displayed on PDF
array	$moreparams	More parameters. Example: array('css'=>, 'csslist'=>, 'cssview'=>...)

Returns: int <=0 if KO, >0 if OK

Exceptions

Exception

Definition at line 677 of file extrafields.class.php.

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

htdocs/core/class/extrafields.class.php

Public Member Functions

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addExtraField()

◆ create()

◆ create_label()

◆ delete()

◆ delete_label()

◆ fetch_name_optionals_label()

◆ getAlignFlag()

◆ getOptionalsFromPost()

◆ setOptionalsFromPost()

◆ showInputField()

◆ showOutputField()

◆ showSeparator()

◆ update()

◆ update_label()