data_field_url Class Reference

Inheritance diagram for data_field_url:

Public Member Functions
	define_default_field ()
	This field just sets up a default field object.
	define_field ($data)
	Set up the field object according to data in an object.
object	delete_content ($recordid=0)
	Delete all content associated with the field.
object	delete_field ()
	Delete a field completely.
	display_add_field ($recordid=0, $formdata=null)
	Print the relevant form element in the ADD template for this field.
	display_browse_field ($recordid, $template)
	Display the content of the field in browse mode.
object	display_edit_field ()
	Print the relevant form element to define the attributes for this field viewable by teachers only.
	display_search_field ($value='')
	export_text_value ($record)
	Per default, return the record's text value only from the "content" field.
	file_ok ($relativepath)
	generate_sql ($tablealias, $value)
	get_config_for_external ()
	Return the plugin configs for external functions.
	get_sort_field ()
	Returns the sortable field for the content.
	get_sort_sql ($fieldname)
	Returns the SQL needed to refer to the column.
object	image ()
	Prints the respective type icon.
object	insert_field ()
	Insert a new field in the database We assume the field object is already defined as $this->field.
	name ()
	Returns the name/type of the field.
	notemptyfield ($value, $name)
	Check if a field from an add form is empty.
	parse_search_field ($defaults=null)
	print_after_form ()
	Just in case a field needs to print something after the whole form.
	print_before_form ()
	Just in case a field needs to print something before the whole form.
	text_export_supported ()
	Per default, it is assumed that fields support text exporting.
	update_content ($recordid, $value, $name='')
	Update the content of one data field in the data_content table.
	update_content_import ($recordid, $value, $name='')
object	update_field ()
	Update a field in the database.
	validate (stdClass $fieldinput)
	Validates params of fieldinput data.

Static Public Member Functions
static	get_content_value ($content)
	Returns the presentable string value for a field content.
static	get_priority ()
	Returns the priority for being indexed by globalsearch.

Public Attributes
object	$cm
	course module or cmifno
object	$context
	activity context
object	$data = NULL
	The database object that this field belongs to.
object	$field = NULL
	The field object itself, if we know it.
int	$iconheight = 16
	Width of the icon for this fieldtype.
int	$iconwidth = 16
	Width of the icon for this fieldtype.
	$type = 'url'
const	HIGH_PRIORITY = 3
	priority value for high priority
const	LOW_PRIORITY = 2
	priority value for low priority
const	MAX_PRIORITY = 4
	priority value for maximum priority
const	MIN_PRIORITY = 1
	priority value for minimum priority
const	NO_PRIORITY = 0
	priority value for invalid fields regarding indexing

Static Protected Attributes
static int	$priority = self::MIN_PRIORITY

Member Function Documentation

define_default_field()

data_field_base::define_default_field ( )

inherited

This field just sets up a default field object.

Return values

bool

define_field()

data_field_base::define_field (   $data )

inherited

Set up the field object according to data in an object.

Now is the time to clean it!

Return values

bool

delete_content()

object data_field_base::delete_content (   $recordid = 0 )

inherited

Delete all content associated with the field.

Parameters

int

$recordid

Return values

bool

delete_field()

object data_field_base::delete_field ( )

inherited

Delete a field completely.

Return values

bool

display_add_field()

data_field_url::display_add_field	(		$recordid = 0,
			$formdata = null
	)

Print the relevant form element in the ADD template for this field.

Parameters

int

$recordid

Return values

string

Reimplemented from data_field_base.

display_browse_field()

data_field_url::display_browse_field	(		$recordid,
			$template
	)

Display the content of the field in browse mode.

Parameters

int	$recordid
object	$template

Return values

bool|string

Reimplemented from data_field_base.

display_edit_field()

object data_field_base::display_edit_field ( )

inherited

Print the relevant form element to define the attributes for this field viewable by teachers only.

@global object

Return values

void	Output is echo'd

export_text_value()

data_field_url::export_text_value

(

$record

)

Per default, return the record's text value only from the "content" field.

Override this in fields class if necesarry.

Parameters

string

$record

Return values

string

Reimplemented from data_field_base.

file_ok()

data_field_base::file_ok (   $relativepath )

inherited

Parameters

string

$relativepath

Return values

bool

false

Reimplemented in data_field_file, data_field_picture, and data_field_textarea.

get_config_for_external()

data_field_url::get_config_for_external

(

)

Return the plugin configs for external functions.

Return values

array

the list of config parameters

Since

Moodle 3.3

Reimplemented from data_field_base.

get_content_value()

static data_field_base::get_content_value (   $content )

staticinherited

Returns the presentable string value for a field content.

The returned string should be plain text.

Parameters

stdClass

$content

Return values

string

Reimplemented in data_field_checkbox, data_field_multimenu, and data_field_textarea.

get_priority()

static data_field_base::get_priority ( )

staticinherited

Returns the priority for being indexed by globalsearch.

Return values

int

get_sort_field()

data_field_base::get_sort_field ( )

inherited

Returns the sortable field for the content.

By default, it's just content but for some plugins, it could be content 1 - content4

Return values

string

get_sort_sql()

data_field_base::get_sort_sql (   $fieldname )

inherited

Returns the SQL needed to refer to the column.

Some fields may need to CAST() etc.

Parameters

string

$fieldname

Return values

string::$fieldname

Reimplemented in data_field_date, data_field_latlong, and data_field_number.

image()

object data_field_base::image ( )

inherited

Prints the respective type icon.

Return values

string

insert_field()

object data_field_base::insert_field ( )

inherited

Insert a new field in the database We assume the field object is already defined as $this->field.

Return values

bool

name()

data_field_base::name ( )

inherited

Returns the name/type of the field.

Return values

string

notemptyfield()

data_field_url::notemptyfield	(		$value,
			$name
	)

Check if a field from an add form is empty.

Parameters

mixed	$value
mixed	$name

Return values

bool

Reimplemented from data_field_base.

print_after_form()

data_field_base::print_after_form ( )

inherited

Just in case a field needs to print something after the whole form.

Reimplemented in data_field_textarea.

text_export_supported()

data_field_base::text_export_supported ( )

inherited

Per default, it is assumed that fields support text exporting.

Override this (return false) on fields not supporting text exporting.

Return values

bool

true

Reimplemented in data_field_file, and data_field_picture.

update_content()

data_field_url::update_content	(		$recordid,
			$value,
			$name = ''
	)

Update the content of one data field in the data_content table.

Parameters

int	$recordid
mixed	$value
string	$name

Return values

bool

Reimplemented from data_field_base.

update_field()

object data_field_base::update_field ( )

inherited

Update a field in the database.

Return values

bool

Reimplemented in data_field_picture.

validate()

data_field_base::validate ( stdClass  $fieldinput )

inherited

Validates params of fieldinput data.

Overwrite to validate fieldtype specific data.

You are expected to return an array like ['paramname' => 'Error message for paramname param'] if there is an error, return an empty array if everything is fine.

Parameters

stdClass

$fieldinput

The field input data to check

Return values

array::$errors

if empty validation was fine, otherwise contains one or more error messages

Reimplemented in data_field_picture.

---

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

• mod/data/field/url/field.class.php