Moodle PHP Documentation 4.5
Moodle 4.5dev (Build: 20240606) (d3ae1391abe)
|
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_file_value (stdClass $record) | |
Per default, does not return a file (just null). | |
export_text_value (stdClass $record) | |
Per default, return the record's text value only from the "content" field. | |
file_export_supported () | |
Per default, it is assumed that fields do not support file exporting. | |
file_import_supported () | |
Per default, a field does not support the import of files. | |
file_ok ($relativepath) | |
Whether this module support files. | |
generate_sql ($tablealias, $value) | |
get_config_for_external () | |
Return the plugin configs for external functions. | |
get_data_content_preview (int $recordid) | |
Generate a fake data_content for this field to be used in preset previews. | |
get_name () | |
Return the field type name. | |
get_preview () | |
Get the field preview value. | |
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. | |
import_file_value (int $contentid, string $filecontent, string $filename) | |
Returns a stored_file object for exporting a file of a given record. | |
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) | |
Only look at the first item (second is format) | |
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. | |
set_preview (bool $preview) | |
Set the field to preview mode. | |
supports_preview () | |
Return if the field type supports preview. | |
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. | |
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. | |
Protected Member Functions | |
get_data_content (int $recordid) | |
Return the data_content of the field, or generate it if it is in preview mode. | |
get_field_params () | |
Function to let field define their parameters. | |
Protected Attributes | |
bool | $preview = false |
whether the field is used in preview mode. | |
Static Protected Attributes | |
static int | $priority = self::LOW_PRIORITY |
|
inherited |
This field just sets up a default field object.
bool |
|
inherited |
Set up the field object according to data in an object.
Now is the time to clean it!
bool |
|
inherited |
Delete all content associated with the field.
int | $recordid |
bool |
|
inherited |
Delete a field completely.
bool |
data_field_textarea::display_add_field | ( | $recordid = 0, | |
$formdata = null ) |
Print the relevant form element in the ADD template for this field.
int | $recordid |
string |
Reimplemented from data_field_base.
data_field_textarea::display_browse_field | ( | $recordid, | |
$template ) |
Display the content of the field in browse mode.
int | $recordid | |
object | $template |
bool|string |
Reimplemented from data_field_base.
|
inherited |
Print the relevant form element to define the attributes for this field viewable by teachers only.
@global object
void | Output is echo'd |
|
inherited |
Per default, does not return a file (just null).
Override this in fields class, if you want your field to export a file content. In case you are exporting a file value, export_text_value() should return the corresponding file name.
stdClass | $record |
null|string | the file content as string or null, if no file content is being provided |
Reimplemented in data_field_file, and data_field_picture.
|
inherited |
Per default, return the record's text value only from the "content" field.
Override this in fields class if necessary.
stdClass | $record |
string |
Reimplemented in data_field_file, and data_field_picture.
|
inherited |
Per default, it is assumed that fields do not support file exporting.
Override this (return true) on fields supporting file export. You will also have to implement export_file_value().
bool | true if field will export a file, false otherwise |
Reimplemented in data_field_file, and data_field_picture.
|
inherited |
Per default, a field does not support the import of files.
A field type can overwrite this function and return true. In this case it also has to implement the function import_file_value().
false | means file imports are not supported |
Reimplemented in data_field_file, and data_field_picture.
data_field_textarea::file_ok | ( | $relativepath | ) |
Whether this module support files.
string | $relativepath |
bool |
Reimplemented from data_field_base.
data_field_textarea::get_config_for_external | ( | ) |
Return the plugin configs for external functions.
array | the list of config parameters |
Reimplemented from data_field_base.
|
static |
Returns the presentable string value for a field content.
The returned string should be plain text.
stdClass | $content |
string |
Reimplemented from data_field_base.
|
protectedinherited |
Return the data_content of the field, or generate it if it is in preview mode.
int | $recordid | the record id |
stdClass|bool | the record data or false if none |
data_field_textarea::get_data_content_preview | ( | int | $recordid | ) |
Generate a fake data_content for this field to be used in preset previews.
Data plugins must override this method and support_preview in order to enable preset preview for this field.
int | $recordid | the fake record id |
stdClass | the fake record |
Reimplemented from data_field_base.
|
protectedinherited |
Function to let field define their parameters.
This method that should be overridden by the datafield plugins when they need to define their data.
array |
Reimplemented in data_field_file, data_field_latlong, and data_field_picture.
|
inherited |
Return the field type name.
string | the filed type. |
|
inherited |
Get the field preview value.
bool |
|
staticinherited |
Returns the priority for being indexed by globalsearch.
int |
|
inherited |
Returns the sortable field for the content.
By default, it's just content but for some plugins, it could be content 1 - content4
string |
|
inherited |
Returns the SQL needed to refer to the column.
Some fields may need to CAST() etc.
string | $fieldname |
string\$fieldname |
Reimplemented in data_field_date, data_field_latlong, and data_field_number.
|
inherited |
Prints the respective type icon.
string |
|
inherited |
Returns a stored_file object for exporting a file of a given record.
int | $contentid | content id |
string | $filecontent | the content of the file as string |
string | $filename | the filename the file should have |
Reimplemented in data_field_file, and data_field_picture.
|
inherited |
Insert a new field in the database We assume the field object is already defined as $this->field.
bool |
|
inherited |
Returns the name/type of the field.
string |
data_field_textarea::notemptyfield | ( | $value, | |
$name ) |
Only look at the first item (second is format)
string | $value | |
string | $name |
bool |
Reimplemented from data_field_base.
data_field_textarea::print_after_form | ( | ) |
Just in case a field needs to print something after the whole form.
Reimplemented from data_field_base.
|
inherited |
Set the field to preview mode.
bool | $preview | the new preview value |
data_field_textarea::supports_preview | ( | ) |
Return if the field type supports preview.
Fields without a preview cannot be displayed in the preset preview.
bool | if the plugin supports preview. |
Reimplemented from data_field_base.
|
inherited |
Per default, it is assumed that fields support text exporting.
Override this (return false) on fields not supporting text exporting.
bool | true |
data_field_textarea::update_content | ( | $recordid, | |
$value, | |||
$name = '' ) |
Update the content of one data field in the data_content table.
int | $recordid | |
mixed | $value | |
string | $name |
bool |
Reimplemented from data_field_base.
|
inherited |
|
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.
stdClass | $fieldinput | The field input data to check |
array\$errors | if empty validation was fine, otherwise contains one or more error messages |
Reimplemented in data_field_picture.