Moodle PHP Documentation 4.5
Moodle 4.5dev (Build: 20240606) (d3ae1391abe)
core_admin\table\activity_management_table Class Reference
Inheritance diagram for core_admin\table\activity_management_table:
core_admin\table\plugin_management_table flexible_table core_table\dynamic

Public Member Functions

 add_data ($row, $classname='')
 This method actually directly echoes the row passed to it now or adds it to the download.
 
 add_data_keyed ($rowwithkeys, $classname='')
 Add a row of data to the table.
 
 add_separator ()
 Add a seperator line to table.
 
 col_fullname ($row)
 Fullname is treated as a special columname in tablelib and should always be treated the same as the fullname of a user.
 
 collapsible ($bool)
 Sets the is_collapsible variable to the given boolean.
 
 column_class ($column, $classname)
 Sets the given $column index to the given $classname in $this->column_class.
 
 column_sticky (string $column, bool $sticky=true)
 Sets a sticky attribute to a column.
 
 column_style ($column, $property, $value)
 Sets the given $column index and $property index to the given $value in $this->column_style.
 
 column_style_all ($property, $value)
 Sets all columns' $propertys to the given $value in $this->column_style.
 
 column_suppress ($column)
 What this method does is set the column so that if the same data appears in consecutive rows, then it is not repeated.
 
 define_baseurl ($url)
 Sets $this->baseurl.
 
 define_columns ($columns)
 
 define_header_column (string $column)
 Mark a specific column as being a table header using the column name defined in define_columns.
 
 define_headers ($headers)
 
 define_help_for_headers ($helpicons)
 Defines a help icon for the header.
 
 download_buttons ()
 Get the html for the download buttons.
 
 export_class_instance ($exportclass=null)
 Get, and optionally set, the export class.
 
 finish_html ()
 This function is not part of the public api.
 
 finish_output ($closeexportclassdoc=true)
 You should call this to finish outputting the table data after adding data to the table with add_data or add_data_keyed.
 
 format_and_add_array_of_rows ($rowstoadd, $finish=true)
 Add a number of rows to the table at once.
 
 format_row ($row)
 Call appropriate methods on this table class to perform any processing on values before displaying in table.
 
 format_text ($text, $format=FORMAT_MOODLE, $options=NULL, $courseid=NULL)
 Used from col_* functions when text is to be displayed.
 
 get_content ()
 Get the table content.
 
 get_context ()
 Get the context for this table.
 
 get_default_per_page ()
 Get the default per page.
 
 get_filterset ()
 Get the currently defined filterset.
 
 get_initial_first ()
 This function is not part of the public api.
 
 get_initial_last ()
 This function is not part of the public api.
 
 get_page_size ()
 
 get_page_start ()
 
 get_row_cells_html (string $rowid, array $row, ?array $suppresslastrow)
 Generate html code for the row cells.
 
 get_row_from_keyed ($rowwithkeys)
 This function is not part of the public api.
 
 get_row_html ($row, $classname='')
 Generate html code for the passed row.
 
 get_sort_columns ()
 Get the columns to sort by, in the form required by construct_order_by().
 
 get_sql_sort ()
 
 get_sql_where ()
 
 guess_base_url ()
 Provide a default implementation for guessing the base URL from the action URL.
 
 initialbars ($bool)
 Sets the use_initials variable to the given boolean.
 
 is_downloadable ($downloadable=null)
 This table is not downloadable.
 
 is_downloading ($download=null, $filename='', $sheettitle='')
 Call this to pass the download type.
 
 is_persistent ($persistent=null)
 Call with boolean true to store table layout changes in the user_preferences table.
 
 is_sortable ($column=null)
 Is the column sortable?
 
 make_styles_string ($styles)
 This function is not part of the public api.
 
 mark_table_to_reset ()
 Mark the table preferences to be reset.
 
 no_sorting ($column)
 Do not sort using this column.
 
 other_cols ($column, $row)
 You can override this method in a child class.
 
 out ()
 Print the table.
 
 pageable ($bool)
 Sets the use_pages variable to the given boolean.
 
 pagesize ($perpage, $total)
 Sets the pagesize variable to the given integer, the totalrows variable to the given integer, and the use_pages variable to true.
 
 print_headers ()
 This function is not part of the public api.
 
 print_html ()
 This method is deprecated although the old api is still supported.
 
 print_initials_bar ()
 This function is not part of the public api.
 
 print_nothing_to_display ()
 This function is not part of the public api.
 
 print_row ($row, $classname='')
 This function is not part of the public api.
 
 render_caption ()
 This function renders a table caption.
 
 set_attribute ($attribute, $value)
 Gives the given $value to the $attribute index of $this->attributes.
 
 set_caption (string $caption, ?array $captionattributes)
 This function set caption for table.
 
 set_columnsattributes (array $attributes)
 Sets the given $attributes to $this->columnsattributes.
 
 set_control_variables ($variables)
 Assigns each given variable in the array to the corresponding index in the request class variable.
 
 set_default_per_page (int $defaultperpage)
 Set the default per page.
 
 set_filterset (filterset $filterset)
 Set the filterset in the table class.
 
 set_first_initial (string $initial)
 Set the preferred first name initial in an initials bar.
 
 set_hidden_columns (array $columns)
 Set the list of hidden columns.
 
 set_last_initial (string $initial)
 Set the preferred last name initial in an initials bar.
 
 set_page_number (int $pagenumber)
 Set the page number.
 
 set_sortdata (array $sortdata)
 Set the preferred table sorting attributes.
 
 setup ()
 Must be called after table is defined.
 
 show_download_buttons_at ($showat)
 Where to show download buttons.
 
 sortable ($bool, $defaultcolumn=NULL, $defaultorder=SORT_ASC)
 Sets the is_sortable variable to the given boolean, sort_default_column to the given string, and the sort_default_order to the given integer.
 
 start_html ()
 This function is not part of the public api.
 
 start_output ()
 This function is not part of the public api.
 
 text_sorting ($column)
 Use text sorting functions for this column (required for text columns with Oracle).
 
 wrap_html_finish ()
 Hook that can be overridden in child classes to wrap a table in a form for example.
 
 wrap_html_start ()
 Hook that can be overridden in child classes to wrap a table in a form for example.
 

Static Public Member Functions

static construct_order_by ($cols, $textsortcols=array())
 Prepare an an order by clause from the list of columns to be sorted.
 
static get_filterset_class ()
 Get the class used as a filterset.
 
static get_sort_for_table ($uniqueid)
 Get the order by clause from the session or user preferences, for the table with id $uniqueid.
 

Public Attributes

 $attributes = array()
 
 $baseurl = NULL
 
string $caption
 $caption The caption of table
 
array $captionattributes
 $captionattributes The caption attributes of table
 
 $column_class = array()
 
 $column_nosort = array('userpic')
 
 $column_style = array()
 
 $column_suppress = array()
 
 $columns = array()
 
 $currentrow = 0
 
 $currpage = 0
 
string $download = ''
 which download plugin to use.
 
bool $downloadable = false
 whether data is downloadable from table.
 
table_dataformat_export_format $exportclass = null
 
 $headers = array()
 
 $is_collapsible = false
 
 $is_sortable = false
 
 $maxsortkeys = 2
 
 $pagesize = 30
 
 $request = array()
 
boolean $setup = false
 Stores if setup has already been called on this flixible table.
 
 $showdownloadbuttonsat = array(TABLE_P_TOP)
 Array of positions in which to display download controls.
 
 $sort_default_column = NULL
 
 $sort_default_order = SORT_ASC
 
bool $started_output = false
 Has start output been called yet?
 
 $totalrows = 0
 
 $uniqueid = NULL
 
 $use_initials = false
 
 $use_pages = false
 
string $useridfield = 'id'
 Key of field returned by db query that is the id field of the user table or equivalent.
 

Protected Member Functions

 can_be_reset ()
 Are there some table preferences that can be reset?
 
 col_activities (stdClass $row)
 Show the number of activities present, with a link to courses containing activity if relevant.
 
 col_enabled (stdClass $row)
 Show the enable/disable column content.
 
 col_name (stdClass $row)
 Show the name column content.
 
 col_order (stdClass $row)
 
 col_settings (stdClass $row)
 Show the settings column content.
 
 col_uninstall (stdClass $row)
 Show the Uninstall column content.
 
 get_action_url (array $params=[])
 Get the action URL for this table.
 
 get_column_list ()
 Get a list of the column titles.
 
 get_columns_with_help ()
 
 get_component ()
 Get dynamic class component.
 
 get_dynamic_table_html_end ()
 Add JS specific to this implementation.
 
 get_dynamic_table_html_start ()
 Get the dynamic table start wrapper.
 
 get_handler ()
 Get dynamic class handler.
 
 get_plugintype ()
 Get the plugintype for this table.
 
 get_primary_sort_order ()
 Return primary sorting column/order, either the first preferred "sortby" value or defaults defined for the table.
 
 get_row_class ($row)
 Get any class to add to the row.
 
 get_sort_order ()
 Return sorting attributes values.
 
 get_sorted_plugins ()
 Get the list of sorted plugins.
 
 get_sortorder_service ()
 Get the web service method used to order plugins.
 
 get_table_id ()
 Get the ID of the table.
 
 get_table_js_module ()
 Get the JS module used to manage this table.
 
 get_toggle_service ()
 Get the web service method used to toggle state.
 
 initialise_table_preferences ()
 Initialise table preferences.
 
 is_resetting_preferences ()
 Is the table marked for reset preferences?
 
 order_plugins (array $plugins)
 Set the standard order of the plugins.
 
 print_one_initials_bar ($alpha, $current, $class, $title, $urlvar)
 Helper function, used by print_initials_bar() to output one initial bar.
 
 render_reset_button ()
 Generate the HTML for the table preferences reset button.
 
 save_preferences ($oldprefs)
 Save preferences.
 
 set_hide_show_preferences ()
 Set hide and show preferences.
 
 set_initials_preferences ()
 Fill in the preferences for the initials bar.
 
 set_sorting_preferences ()
 Calculate the preferences for sort order based on user-supplied values and get params.
 
 setup_column_configuration ()
 Set up the column configuration for this table.
 
 show_hide_link ($column, $index)
 Generate the HTML for the collapse/uncollapse icon.
 
 sort_icon ($isprimary, $order)
 Generate the HTML for the sort icon.
 
 sort_link ($text, $column, $isprimary, $order)
 Generate the HTML for the sort link.
 
 sort_order_name ($isprimary, $order)
 Generate the correct tool tip for changing the sort order.
 
 sort_plugins (array $plugins)
 Sort the plugins list.
 
 supports_disabling ()
 Whether this plugin type supports the disabling of plugins.
 
 supports_ordering ()
 Whether this table should show ordering fields.
 

Protected Attributes

array $columnsticky = []
 The sticky attribute of each table column.
 
int int $enabledplugincount = 0
 The number of enabled plugins of this type.
 
string $filename
 $filename
 
filterset $filterset = null
 The currently applied filerset This is required for dynamic tables, but can be used by other tables too if desired.
 
string $headercolumn = null
 A column which should be considered as a header column.
 
array $hiddencolumns
 $hiddencolumns List of hidden columns.
 
string $ifirst
 The manually set first name initial preference.
 
string $ilast
 The manually set last name initial preference.
 
string string $plugininfoclass
 The plugininfo class for this plugintype.
 
core_plugin_manager core_plugin_manager $pluginmanager
 
core plugininfo base[] array $plugins = []
 The plugin list.
 
bool $resetting
 $resetting Whether the table preferences is resetting.
 
string $sheettitle
 $sheettitle
 
array $sortdata
 The fields to sort.
 
string[] $userfullnamecolumns = ['fullname']
 Columns that are expected to contain a users fullname.
 

Member Function Documentation

◆ add_data()

flexible_table::add_data ( $row,
$classname = '' )
inherited

This method actually directly echoes the row passed to it now or adds it to the download.

If this is the first row and start_output has not already been called this method also calls start_output to open the table or send headers for the downloaded. Can be used as before. print_html now calls finish_html to close table.

Parameters
array$rowa numerically keyed row of data to add to the table.
string$classnameCSS class name to add to this row's tr tag.
Return values
boolsuccess.

◆ add_data_keyed()

flexible_table::add_data_keyed ( $rowwithkeys,
$classname = '' )
inherited

Add a row of data to the table.

This function takes an array or object with column names as keys or property names.

It ignores any elements with keys that are not defined as columns. It puts in empty strings into the row when there is no element in the passed array corresponding to a column in the table. It puts the row elements in the proper order (internally row table data is stored by in arrays with a numerical index corresponding to the column number).

Parameters
object | array$rowwithkeysarray keys or object property names are column names, as defined in call to define_columns.
string$classnameCSS class name to add to this row's tr tag.

◆ can_be_reset()

flexible_table::can_be_reset ( )
protectedinherited

Are there some table preferences that can be reset?

If true, then the "reset table preferences" widget should be displayed.

Return values
bool

◆ col_activities()

core_admin\table\activity_management_table::col_activities ( stdClass $row)
protected

Show the number of activities present, with a link to courses containing activity if relevant.

Parameters
mixed$row
Return values
string

◆ col_enabled()

core_admin\table\plugin_management_table::col_enabled ( stdClass $row)
protectedinherited

Show the enable/disable column content.

Parameters
stdClass$row
Return values
string

◆ col_fullname()

flexible_table::col_fullname ( $row)
inherited

Fullname is treated as a special columname in tablelib and should always be treated the same as the fullname of a user.

@uses $this->useridfield if the userid field is not expected to be id then you need to override $this->useridfield to point at the correct field for the user id.

Parameters
object$rowthe data from the db containing all fields from the users table necessary to construct the full name of the user in current language.
Return values
stringcontents of cell in column 'fullname', for this row.

Reimplemented in assign_grading_table, core_tag_manage_table, core_user\table\participants, core_webservice\token_table, forumreport_summary\summary_table, mod_h5pactivity\local\report\participants, mod_quiz\local\reports\attempts_report_table, and tool_policy\acceptances_table.

◆ col_name()

core_admin\table\activity_management_table::col_name ( stdClass $row)
protected

Show the name column content.

Parameters
stdClass$row
Return values
string

Reimplemented from core_admin\table\plugin_management_table.

◆ col_settings()

core_admin\table\plugin_management_table::col_settings ( stdClass $row)
protectedinherited

Show the settings column content.

Parameters
stdClass$row
Return values
string

◆ col_uninstall()

core_admin\table\plugin_management_table::col_uninstall ( stdClass $row)
protectedinherited

Show the Uninstall column content.

Parameters
stdClass$row
Return values
string

◆ collapsible()

flexible_table::collapsible ( $bool)
inherited

Sets the is_collapsible variable to the given boolean.

Parameters
bool$bool
Return values
void

◆ column_class()

flexible_table::column_class ( $column,
$classname )
inherited

Sets the given $column index to the given $classname in $this->column_class.

Parameters
int$column
string$classname
Return values
void

◆ column_sticky()

flexible_table::column_sticky ( string $column,
bool $sticky = true )
inherited

Sets a sticky attribute to a column.

Parameters
string$columnColumn name
bool$sticky

◆ column_style()

flexible_table::column_style ( $column,
$property,
$value )
inherited

Sets the given $column index and $property index to the given $value in $this->column_style.

Parameters
int$column
string$property
mixed$value
Return values
void

◆ column_style_all()

flexible_table::column_style_all ( $property,
$value )
inherited

Sets all columns' $propertys to the given $value in $this->column_style.

Parameters
int$property
string$value
Return values
void

◆ column_suppress()

flexible_table::column_suppress ( $column)
inherited

What this method does is set the column so that if the same data appears in consecutive rows, then it is not repeated.

For example, in the quiz overview report, the fullname column is set to be suppressed, so that when one student has made multiple attempts, their name is only printed in the row for their first attempt.

Parameters
int$columnthe index of a column.

◆ construct_order_by()

static flexible_table::construct_order_by ( $cols,
$textsortcols = array() )
staticinherited

Prepare an an order by clause from the list of columns to be sorted.

Parameters
array$colscolumn name => SORT_ASC or SORT_DESC
Return values
stringSQL fragment that can be used in an ORDER BY clause.

◆ define_baseurl()

flexible_table::define_baseurl ( $url)
inherited

Sets $this->baseurl.

Parameters
moodle_url | string$urlthe url with params needed to call up this page

◆ define_columns()

flexible_table::define_columns ( $columns)
inherited
Parameters
array$columnsan array of identifying names for columns. If columns are sorted then column names must correspond to a field in sql.

Reimplemented in mod_feedback_responses_table.

◆ define_header_column()

flexible_table::define_header_column ( string $column)
inherited

Mark a specific column as being a table header using the column name defined in define_columns.

Note: Only one column can be a header, and it will be rendered using a th tag.

Parameters
string$column

◆ define_headers()

flexible_table::define_headers ( $headers)
inherited
Parameters
array$headersnumerical keyed array of displayed string titles for each column.

◆ define_help_for_headers()

flexible_table::define_help_for_headers ( $helpicons)
inherited

Defines a help icon for the header.

Always use this function if you need to create header with sorting and help icon.

Parameters
renderable[]$helpiconsAn array of renderable objects to be used as help icons

◆ download_buttons()

flexible_table::download_buttons ( )
inherited

◆ export_class_instance()

flexible_table::export_class_instance ( $exportclass = null)
inherited

Get, and optionally set, the export class.

Parameters
table_dataformat_export_format$exportclass(optional) if passed, set the table to use this export class.
Return values
table_dataformat_export_formatthe export class in use (after any set).

◆ format_and_add_array_of_rows()

flexible_table::format_and_add_array_of_rows ( $rowstoadd,
$finish = true )
inherited

Add a number of rows to the table at once.

And optionally finish output after they have been added.

Parameters
(object|array|null)[]$rowstoadd Array of rows to add to table, a null value in array adds a separator row. Or a object or array is added to table. We expect properties for the row array as would be passed to add_data_keyed.
bool$finish

◆ format_row()

flexible_table::format_row ( $row)
inherited

Call appropriate methods on this table class to perform any processing on values before displaying in table.

Takes raw data from the database and process it into human readable format, perhaps also adding html linking when displaying table as html, adding a div wrap, etc.

See for example col_fullname below which will be called for a column whose name is 'fullname'.

Parameters
array | object$rowrow of data from db used to make one row of the table.
Return values
arrayone row for the table, added using add_data_keyed method.

Reimplemented in assign_grading_table, core_reportbuilder\table\custom_report_table, core_reportbuilder\table\system_report_table, and tool_policy\acceptances_table.

◆ format_text()

flexible_table::format_text ( $text,
$format = FORMAT_MOODLE,
$options = NULL,
$courseid = NULL )
inherited

Used from col_* functions when text is to be displayed.

Does the right thing - either converts text to html or strips any html tags depending on if we are downloading and what is the download type. Params are the same as format_text function in weblib.php but some default options are changed.

◆ get_action_url()

core_admin\table\activity_management_table::get_action_url ( array $params = [])
protected

Get the action URL for this table.

The action URL is used to perform all actions when JS is not available.

Parameters
array$params
Return values
moodle_url

Reimplemented from core_admin\table\plugin_management_table.

◆ get_column_list()

core_admin\table\activity_management_table::get_column_list ( )
protected

Get a list of the column titles.

Return values
string[]

Reimplemented from core_admin\table\plugin_management_table.

◆ get_component()

flexible_table::get_component ( )
protectedinherited

Get dynamic class component.

Return values
string

◆ get_context()

core_admin\table\plugin_management_table::get_context ( )
inherited

Get the context for this table.

Return values
context_system

Reimplemented from flexible_table.

◆ get_default_per_page()

flexible_table::get_default_per_page ( )
inherited

Get the default per page.

Return values
int

Reimplemented in core_reportbuilder\table\custom_report_table_view.

◆ get_dynamic_table_html_end()

core_admin\table\plugin_management_table::get_dynamic_table_html_end ( )
protectedinherited

Add JS specific to this implementation.

Return values
string

Reimplemented from flexible_table.

◆ get_dynamic_table_html_start()

flexible_table::get_dynamic_table_html_start ( )
protectedinherited

Get the dynamic table start wrapper.

If this is not a dynamic table, then an empty string is returned making this safe to blindly call.

Return values
string

◆ get_filterset()

flexible_table::get_filterset ( )
inherited

Get the currently defined filterset.

Return values
filterset

◆ get_filterset_class()

static core_admin\table\plugin_management_table::get_filterset_class ( )
staticinherited

Get the class used as a filterset.

Return values
string

Reimplemented from flexible_table.

◆ get_handler()

flexible_table::get_handler ( )
protectedinherited

Get dynamic class handler.

Return values
string

◆ get_initial_first()

flexible_table::get_initial_first ( )
inherited

This function is not part of the public api.

Return values
stringinitial of first name we are currently filtering by

◆ get_initial_last()

flexible_table::get_initial_last ( )
inherited

This function is not part of the public api.

Return values
stringinitial of last name we are currently filtering by

◆ get_page_size()

flexible_table::get_page_size ( )
inherited
Return values
intthe pagesize for LIMIT clause of SQL

◆ get_page_start()

flexible_table::get_page_start ( )
inherited
Return values
intthe offset for LIMIT clause of SQL

◆ get_plugintype()

core_admin\table\activity_management_table::get_plugintype ( )
protected

Get the plugintype for this table.

Return values
string

Reimplemented from core_admin\table\plugin_management_table.

◆ get_primary_sort_order()

flexible_table::get_primary_sort_order ( )
protectedinherited

Return primary sorting column/order, either the first preferred "sortby" value or defaults defined for the table.

Return values
array

◆ get_row_cells_html()

flexible_table::get_row_cells_html ( string $rowid,
array $row,
?array $suppresslastrow )
inherited

Generate html code for the row cells.

Parameters
string$rowid
array$row
array | null$suppresslastrow
Return values
string

Reimplemented in core_reportbuilder\table\custom_report_table.

◆ get_row_class()

core_admin\table\plugin_management_table::get_row_class ( $row)
protectedinherited

Get any class to add to the row.

Parameters
mixed$row
Return values
string

◆ get_row_html()

flexible_table::get_row_html ( $row,
$classname = '' )
inherited

Generate html code for the passed row.

Parameters
array$rowRow data.
string$classnameclasses to add.
Return values
string\$htmlhtml code for the row passed.

◆ get_sort_columns()

flexible_table::get_sort_columns ( )
inherited

Get the columns to sort by, in the form required by construct_order_by().

Return values
arraycolumn name => SORT_... constant.

Reimplemented in assign_grading_table, core_reportbuilder\table\custom_report_table, mod_quiz\local\reports\attempts_report_table, and tool_policy\acceptances_table.

◆ get_sort_for_table()

static flexible_table::get_sort_for_table ( $uniqueid)
staticinherited

Get the order by clause from the session or user preferences, for the table with id $uniqueid.

Parameters
string$uniqueidthe identifier for a table.
Return values
stringSQL fragment that can be used in an ORDER BY clause.

◆ get_sort_order()

flexible_table::get_sort_order ( )
protectedinherited

Return sorting attributes values.

Return values
array

◆ get_sorted_plugins()

core_admin\table\plugin_management_table::get_sorted_plugins ( )
protectedinherited

Get the list of sorted plugins.

Return values
core\plugininfo\base[]

◆ get_sortorder_service()

core_admin\table\plugin_management_table::get_sortorder_service ( )
protectedinherited

Get the web service method used to order plugins.

Return values
null|string

◆ get_sql_sort()

flexible_table::get_sql_sort ( )
inherited
Return values
stringSQL fragment that can be used in an ORDER BY clause.

Reimplemented in core_reportbuilder\table\base_report_table, and gradereport_history\output\tablelog.

◆ get_sql_where()

flexible_table::get_sql_where ( )
inherited
Return values
arraysql to add to where statement.

Reimplemented in core_tag_manage_table, and tool_policy\acceptances_table.

◆ get_table_id()

core_admin\table\activity_management_table::get_table_id ( )
protected

Get the ID of the table.

Return values
string

Reimplemented from core_admin\table\plugin_management_table.

◆ get_table_js_module()

core_admin\table\plugin_management_table::get_table_js_module ( )
protectedinherited

Get the JS module used to manage this table.

This should be a class which extends 'core_admin/plugin_management_table'.

Return values
string

Reimplemented in core_admin\table\block_management_table.

◆ get_toggle_service()

core_admin\table\plugin_management_table::get_toggle_service ( )
protectedinherited

Get the web service method used to toggle state.

Return values
null|string

◆ guess_base_url()

core_admin\table\activity_management_table::guess_base_url ( )

Provide a default implementation for guessing the base URL from the action URL.

Reimplemented from core_admin\table\plugin_management_table.

◆ initialbars()

flexible_table::initialbars ( $bool)
inherited

Sets the use_initials variable to the given boolean.

Parameters
bool$bool
Return values
void

◆ is_downloadable()

core_admin\table\plugin_management_table::is_downloadable ( $downloadable = null)
inherited

This table is not downloadable.

Parameters
bool$downloadable
Return values
bool

Reimplemented from flexible_table.

◆ is_downloading()

flexible_table::is_downloading ( $download = null,
$filename = '',
$sheettitle = '' )
inherited

Call this to pass the download type.

Use : $download = optional_param('download', '', PARAM_ALPHA); To get the download type. We assume that if you call this function with params that this table's data is downloadable, so we call is_downloadable for you (even if the param is '', which means no download this time. Also you can call this method with no params to get the current set download type.

Parameters
string | null$downloadtype of dataformat for export.
string$filenamefilename for downloads without file extension.
string$sheettitletitle for downloaded data.
Return values
stringdownload dataformat type.

◆ is_persistent()

flexible_table::is_persistent ( $persistent = null)
inherited

Call with boolean true to store table layout changes in the user_preferences table.

Note: user_preferences.value has a maximum length of 1333 characters. Call with no parameter to get current state of table persistence.

Parameters
bool$persistentOptional parameter to set table layout persistence.
Return values
boolWhether or not the table layout preferences will persist.

◆ is_resetting_preferences()

flexible_table::is_resetting_preferences ( )
protectedinherited

Is the table marked for reset preferences?

Return values
boolTrue if the table is marked to reset, false otherwise.

◆ is_sortable()

flexible_table::is_sortable ( $column = null)
inherited

Is the column sortable?

Parameters
stringcolumn name, null means table
Return values
bool

◆ make_styles_string()

flexible_table::make_styles_string ( $styles)
inherited

This function is not part of the public api.

Parameters
array$stylesCSS-property => value
Return values
stringvalues suitably to go in a style="" attribute in HTML.

◆ no_sorting()

flexible_table::no_sorting ( $column)
inherited

Do not sort using this column.

Parameters
stringcolumn name

◆ order_plugins()

core_admin\table\plugin_management_table::order_plugins ( array $plugins)
protectedinherited

Set the standard order of the plugins.

Parameters
array$plugins
Return values
array

Reimplemented in core_admin\table\editor_management_table.

◆ other_cols()

flexible_table::other_cols ( $column,
$row )
inherited

◆ pageable()

flexible_table::pageable ( $bool)
inherited

Sets the use_pages variable to the given boolean.

Parameters
bool$bool
Return values
void

◆ pagesize()

flexible_table::pagesize ( $perpage,
$total )
inherited

Sets the pagesize variable to the given integer, the totalrows variable to the given integer, and the use_pages variable to true.

Parameters
int$perpage
int$total
Return values
void

◆ print_headers()

flexible_table::print_headers ( )
inherited

◆ print_html()

flexible_table::print_html ( )
inherited

This method is deprecated although the old api is still supported.

Deprecated
1.9.2 - Jun 2, 2008

◆ print_nothing_to_display()

◆ print_one_initials_bar()

flexible_table::print_one_initials_bar ( $alpha,
$current,
$class,
$title,
$urlvar )
protectedinherited

Helper function, used by print_initials_bar() to output one initial bar.

Parameters
array$alphaof letters in the alphabet.
string$currentthe currently selected letter.
string$classclass name to add to this initial bar.
string$titlethe name to put in front of this initial bar.
string$urlvarURL parameter name for this initial.
Deprecated
since Moodle 3.3

◆ render_caption()

flexible_table::render_caption ( )
inherited

This function renders a table caption.

Return values
string\$outputCaption of table.

◆ render_reset_button()

flexible_table::render_reset_button ( )
protectedinherited

Generate the HTML for the table preferences reset button.

Return values
stringHTML fragment, empty string if no need to reset

◆ save_preferences()

flexible_table::save_preferences ( $oldprefs)
protectedinherited

Save preferences.

Parameters
array$oldprefsOld preferences to compare against.

◆ set_attribute()

flexible_table::set_attribute ( $attribute,
$value )
inherited

Gives the given $value to the $attribute index of $this->attributes.

Parameters
string$attribute
mixed$value
Return values
void

◆ set_caption()

flexible_table::set_caption ( string $caption,
?array $captionattributes )
inherited

This function set caption for table.

Parameters
string$captionCaption of table.
array | null$captionattributesCaption attributes of table.

◆ set_columnsattributes()

flexible_table::set_columnsattributes ( array $attributes)
inherited

Sets the given $attributes to $this->columnsattributes.

Column attributes will be added to every cell in the column.

Parameters
array[]$attributese.g. ['c0_firstname' => ['data-foo' => 'bar']]

◆ set_control_variables()

flexible_table::set_control_variables ( $variables)
inherited

Assigns each given variable in the array to the corresponding index in the request class variable.

Parameters
array$variables
Return values
void

◆ set_default_per_page()

flexible_table::set_default_per_page ( int $defaultperpage)
inherited

Set the default per page.

Parameters
int$defaultperpage

◆ set_filterset()

flexible_table::set_filterset ( filterset $filterset)
inherited

Set the filterset in the table class.

The use of filtersets is a requirement for dynamic tables, but can be used by other tables too if desired.

Parameters
filterset$filtersetThe filterset object to get filters and table parameters from

Reimplemented in core_reportbuilder\table\system_report_table, and core_user\table\participants.

◆ set_first_initial()

flexible_table::set_first_initial ( string $initial)
inherited

Set the preferred first name initial in an initials bar.

Parameters
string$initialThe character to set

◆ set_hidden_columns()

flexible_table::set_hidden_columns ( array $columns)
inherited

Set the list of hidden columns.

Parameters
array$columnsThe list of hidden columns.

◆ set_last_initial()

flexible_table::set_last_initial ( string $initial)
inherited

Set the preferred last name initial in an initials bar.

Parameters
string$initialThe character to set

◆ set_page_number()

flexible_table::set_page_number ( int $pagenumber)
inherited

Set the page number.

Parameters
int$pagenumberThe page number.

◆ set_sortdata()

flexible_table::set_sortdata ( array $sortdata)
inherited

Set the preferred table sorting attributes.

Parameters
string$sortbyThe field to sort by.
int$sortorderThe sort order.

◆ setup()

core_admin\table\activity_management_table::setup ( )

Must be called after table is defined.

Use methods above first. Cannot use functions below till after calling this method.

Reimplemented from flexible_table.

◆ show_download_buttons_at()

flexible_table::show_download_buttons_at ( $showat)
inherited

Where to show download buttons.

Parameters
array$showatarray of postions in which to show download buttons. Containing TABLE_P_TOP and/or TABLE_P_BOTTOM

◆ show_hide_link()

flexible_table::show_hide_link ( $column,
$index )
protectedinherited

Generate the HTML for the collapse/uncollapse icon.

This is a helper method used by print_headers().

Parameters
string$columnthe column name, index into various names.
int$indexnumerical index of the column.
Return values
stringHTML fragment.

Reimplemented in assign_grading_table, core_tag_manage_table, core_user\table\participants, tool_dataprivacy\output\data_requests_table, and tool_dataprivacy\output\expired_contexts_table.

◆ sort_icon()

flexible_table::sort_icon ( $isprimary,
$order )
protectedinherited

Generate the HTML for the sort icon.

This is a helper method used by sort_link().

Parameters
bool$isprimarywhether an icon is needed (it is only needed for the primary sort column.)
int$orderSORT_ASC or SORT_DESC
Return values
stringHTML fragment.

◆ sort_link()

flexible_table::sort_link ( $text,
$column,
$isprimary,
$order )
protectedinherited

Generate the HTML for the sort link.

This is a helper method used by print_headers().

Parameters
string$textthe text for the link.
string$columnthe column name, may be a fake column like 'firstname' or a real one.
bool$isprimarywhether the is column is the current primary sort column.
int$orderSORT_ASC or SORT_DESC
Return values
stringHTML fragment.

◆ sort_order_name()

flexible_table::sort_order_name ( $isprimary,
$order )
protectedinherited

Generate the correct tool tip for changing the sort order.

This is a helper method used by sort_link().

Parameters
bool$isprimarywhether the is column is the current primary sort column.
int$orderSORT_ASC or SORT_DESC
Return values
stringthe correct title.

◆ sort_plugins()

core_admin\table\plugin_management_table::sort_plugins ( array $plugins)
protectedinherited

Sort the plugins list.

Note: This only applies to plugins which do not support ordering.

Parameters
core\plugininfo\base[]$plugins
Return values
core\plugininfo\base[]

◆ sortable()

flexible_table::sortable ( $bool,
$defaultcolumn = NULL,
$defaultorder = SORT_ASC )
inherited

Sets the is_sortable variable to the given boolean, sort_default_column to the given string, and the sort_default_order to the given integer.

Parameters
bool$bool
string$defaultcolumn
int$defaultorder
Return values
void

◆ start_html()

flexible_table::start_html ( )
inherited

This function is not part of the public api.

Reimplemented in core_reportbuilder\table\base_report_table.

◆ start_output()

flexible_table::start_output ( )
inherited

This function is not part of the public api.

You don't normally need to call this. It is called automatically when needed when you start adding data to the table.

◆ supports_disabling()

core_admin\table\plugin_management_table::supports_disabling ( )
protectedinherited

Whether this plugin type supports the disabling of plugins.

Return values
bool

◆ supports_ordering()

core_admin\table\plugin_management_table::supports_ordering ( )
protectedinherited

Whether this table should show ordering fields.

Return values
bool

◆ text_sorting()

flexible_table::text_sorting ( $column)
inherited

Use text sorting functions for this column (required for text columns with Oracle).

Be warned that you cannot use this with column aliases. You can only do this with real columns. See MDL-40481 for an example.

Parameters
stringcolumn name

◆ wrap_html_finish()

flexible_table::wrap_html_finish ( )
inherited

Hook that can be overridden in child classes to wrap a table in a form for example.

Called only when there is data to display and not downloading.

Reimplemented in core_reportbuilder\table\custom_report_table, forumreport_summary\summary_table, mod_quiz\local\reports\attempts_report_table, quiz_statistics_table, tool_dataprivacy\output\data_requests_table, and tool_policy\acceptances_table.

◆ wrap_html_start()

flexible_table::wrap_html_start ( )
inherited

Hook that can be overridden in child classes to wrap a table in a form for example.

Called only when there is data to display and not downloading.

Reimplemented in mod_quiz\local\reports\attempts_report_table, quiz_statistics_table, and tool_policy\acceptances_table.

Member Data Documentation

◆ $download

string flexible_table::$download = ''
inherited

which download plugin to use.

Default '' means none - print html table with paging. Property set by is_downloading which typically passes in cleaned data from $

◆ $downloadable

bool flexible_table::$downloadable = false
inherited

whether data is downloadable from table.

Determines whether to display download buttons. Set by method downloadable().

◆ $userfullnamecolumns

string [] flexible_table::$userfullnamecolumns = ['fullname']
protectedinherited

Columns that are expected to contain a users fullname.



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