Moodle PHP Documentation 4.3
Moodle 4.3.5 (Build: 20240610) (7dcfaa79f78)
|
Displays the current user's profile information. More...
Public Member Functions | |
_load_instance ($instance, $page) | |
Set up a particular instance of this class given data from the block_insances table and the current page. | |
_self_test () | |
Tests if this block has been implemented correctly. | |
after_install () | |
post install configurations | |
applicable_formats () | |
locations where block can be displayed | |
before_delete () | |
post delete configurations | |
can_block_be_added (moodle_page $page) | |
This method can be overriden to add some extra checks to decide whether the block can be added or not to a page. | |
config_save ($data) | |
Default behavior: save all variables as $CFG properties You don't need to override this if you 're satisfied with the above. | |
get_aria_role () | |
Returns the aria role attribute that best describes this block. | |
get_config_for_external () | |
Return the plugin config settings for external functions. | |
get_content () | |
block contents | |
get_content_for_external ($output) | |
Return an object containing all the block content to be returned by external functions. | |
get_content_for_output ($output) | |
Return a block_contents object representing the full contents of this block. | |
get_content_type () | |
Returns the class $content_type var value. | |
get_required_javascript () | |
Allows the block to load any JS it requires into the page. | |
get_title () | |
Returns the class $title var value. | |
has_config () | |
allow the block to have a configuration page | |
hide_header () | |
Default return is false - header will be shown. | |
html_attributes () | |
Return any HTML attributes that you want added to the outer. | |
init () | |
block initializations | |
instance_allow_config () | |
allow instances to have their own configuration | |
instance_allow_multiple () | |
allow more than one instance of the block on a page | |
instance_can_be_collapsed () | |
If overridden and set to false by the block it will not be collapsible. | |
instance_can_be_docked () | |
Can be overridden by the block to prevent the block from being dockable. | |
instance_can_be_edited () | |
If overridden and set to false by the block it will not be editable. | |
instance_can_be_hidden () | |
If overridden and set to false by the block it will not be hidable when editing is turned on. | |
instance_config_commit ($nolongerused=false) | |
Replace the instance's configuration data with those currently in $this->config;. | |
instance_config_save ($data, $nolongerused=false) | |
Serialize and store config data. | |
instance_copy ($fromid) | |
Copy any block-specific data when copying to a new block instance. | |
instance_create () | |
Do any additional initialization you may need at the time a new block instance is created. | |
instance_delete () | |
Delete everything related to this instance if you have been using persistent storage other than the configdata field. | |
is_empty () | |
Returns true or false, depending on whether this block has any content to display and whether the user has permission to view the block. | |
name () | |
Returns the block name, as present in the class name, the database, the block directory, etc etc. | |
refresh_content () | |
First sets the current value of $this->content to NULL then calls the block's get_content() function to set its value back. | |
specialization () | |
instance specialisations (must have instance allow config true) | |
user_can_addto ($page) | |
Allows the block class to have a say in the user's ability to create new instances of this block. | |
user_can_edit () | |
Allows the block class to have a say in the user's ability to edit (i.e., configure) blocks of this type. | |
Public Attributes | |
string | $arialabel = NULL |
The name of the block to be displayed in the block title area if the title is empty. | |
stdClass | $config = NULL |
An object containing the instance configuration information for the current instance of this block. | |
stdClass | $content = NULL |
An object to contain the information to be displayed in the block. | |
int | $content_type = BLOCK_TYPE_TEXT |
The type of content that this block creates. | |
context | $context = NULL |
This blocks's context. | |
int | $cron = NULL |
How often the cronjob should run, 0 if not at all. | |
stdClass | $instance = NULL |
The initialized instance of this block object. | |
moodle_page | $page = NULL |
The page that this block is appearing on. | |
string | $str |
Internal var for storing/caching translated strings $str. | |
string | $title = NULL |
The title of the block to be displayed in the block title area. | |
Protected Member Functions | |
formatted_contents ($output) | |
Convert the contents of the block to HTML. | |
Displays the current user's profile information.
|
inherited |
Set up a particular instance of this class given data from the block_insances table and the current page.
(See block_manager::load_blocks().)
stdClass | $instance | data from block_insances, block_positions, etc. |
moodle_page | $page | the page this block is on. |
|
inherited |
Tests if this block has been implemented correctly.
Also, $errors isn't used right now
boolean |
block_myprofile::applicable_formats | ( | ) |
block_myprofile::before_delete | ( | ) |
post delete configurations
Reimplemented from block_base.
|
inherited |
This method can be overriden to add some extra checks to decide whether the block can be added or not to a page.
It doesn't need to do the standard capability checks as they will be performed by has_add_block_capability(). This method is user agnostic. If you want to check if a user can add a block or not, you should use user_can_addto().
moodle_page | $page | The page where this block will be added. |
bool | Whether the block can be added or not to the given page. |
Reimplemented in block_accessreview, block_badges, block_blog_menu, block_blog_recent, block_blog_tags, block_comments, block_completionstatus, block_globalsearch, block_glossary_random, block_lp, block_mnet_hosts, and block_tags.
|
inherited |
Default behavior: save all variables as $CFG properties You don't need to override this if you 're satisfied with the above.
|
protectedinherited |
Convert the contents of the block to HTML.
This is used by block base classes like block_list to convert the structured $this->content->list and $this->content->icons arrays to HTML. So, in most blocks, you probaby want to override the get_contents() method, which generates that structured representation of the contents.
$output | The core_renderer to use when generating the output. |
string | the HTML that should appearn in the body of the block. |
Reimplemented in block_list, and block_tree.
|
inherited |
Returns the aria role attribute that best describes this block.
Region is the default, but this should be overridden by a block is there is a region child, or even better a landmark child.
Options are as follows:
string |
Reimplemented in block_activity_modules, block_admin_bookmarks, block_blog_menu, block_course_list, block_navigation, block_search_forums, and block_settings.
block_myprofile::get_config_for_external | ( | ) |
Return the plugin config settings for external functions.
stdClass | the configs for both the block instance and plugin |
Reimplemented from block_base.
block_myprofile::get_content | ( | ) |
|
inherited |
Return an object containing all the block content to be returned by external functions.
If your block is returning formatted content or provide files for download, you should override this method to use the core_external\util\format_text, core_external\utilformat_string functions for formatting or external_util\get_area_files for files.
core_renderer | $output | the rendered used for output |
stdClass | object containing the block title, central content, footer and linked files (if any). |
Reimplemented in block_html.
|
inherited |
Return a block_contents object representing the full contents of this block.
This internally calls ->get_content(), and then adds the editing controls etc.
You probably should not override this method, but instead override html_attributes(), formatted_contents() or get_content(), hide_header(), (get_edit_controls), etc.
block_contents | a representation of the block, for rendering. |
|
inherited |
Returns the class $content_type var value.
Intentionally doesn't check if content_type is set. This is already done in _self_test()
string\$this-,>content_type |
|
inherited |
Allows the block to load any JS it requires into the page.
By default this function simply permits the user to dock the block if it is dockable.
Left null as of MDL-64506.
Reimplemented in block_navigation, and block_settings.
|
inherited |
Returns the class $title var value.
Intentionally doesn't check if a title is set. This is already done in _self_test()
string\$this-,>title |
block_myprofile::has_config | ( | ) |
|
inherited |
Default return is false - header will be shown.
boolean |
Reimplemented in block_course_summary, and block_myoverview.
|
inherited |
Return any HTML attributes that you want added to the outer.
function html_attributes() { $attributes = parent\html_attributes(); $attributes['class'] .= ' mynewclass'; return $attributes; }
array | attribute name => value. |
Reimplemented in block_html, block_list, and block_navigation.
block_myprofile::instance_allow_config | ( | ) |
allow instances to have their own configuration
boolean |
Reimplemented from block_base.
block_myprofile::instance_allow_multiple | ( | ) |
allow more than one instance of the block on a page
boolean |
Reimplemented from block_base.
|
inherited |
If overridden and set to false by the block it will not be collapsible.
bool |
|
inherited |
Can be overridden by the block to prevent the block from being dockable.
bool |
Return false as per MDL-64506
Reimplemented in block_html, block_mentees, block_navigation, and block_settings.
|
inherited |
If overridden and set to false by the block it will not be editable.
bool |
Reimplemented in block_myoverview.
|
inherited |
If overridden and set to false by the block it will not be hidable when editing is turned on.
bool |
Reimplemented in block_navigation, and block_settings.
|
inherited |
Replace the instance's configuration data with those currently in $this->config;.
Reimplemented in block_glossary_random.
|
inherited |
Serialize and store config data.
Reimplemented in block_activity_results, and block_html.
|
inherited |
Copy any block-specific data when copying to a new block instance.
int | $fromid | the id number of the block instance to copy from |
boolean |
Reimplemented in block_html.
|
inherited |
Do any additional initialization you may need at the time a new block instance is created.
boolean |
|
inherited |
Delete everything related to this instance if you have been using persistent storage other than the configdata field.
boolean |
Reimplemented in block_html.
|
inherited |
Returns true or false, depending on whether this block has any content to display and whether the user has permission to view the block.
boolean |
Reimplemented in block_list.
|
inherited |
Returns the block name, as present in the class name, the database, the block directory, etc etc.
string |
|
inherited |
First sets the current value of $this->content to NULL then calls the block's get_content() function to set its value back.
stdObject |
block_myprofile::specialization | ( | ) |
instance specialisations (must have instance allow config true)
Reimplemented from block_base.
|
inherited |
Allows the block class to have a say in the user's ability to create new instances of this block.
The framework has first say in whether this will be allowed (e.g., no adding allowed unless in edit mode) but if the framework does allow it, the block can still decide to refuse. This function has access to the complete page object, the creation related to which is being determined.
moodle_page | $page |
boolean |
|
inherited |
Allows the block class to have a say in the user's ability to edit (i.e., configure) blocks of this type.
The framework has first say in whether this will be allowed (e.g., no editing allowed unless in edit mode) but if the framework does allow it, the block can still decide to refuse.
boolean |
|
inherited |
The name of the block to be displayed in the block title area if the title is empty.
arialabel
|
inherited |
An object containing the instance configuration information for the current instance of this block.
$config
|
inherited |
An object to contain the information to be displayed in the block.
$content
|
inherited |
The type of content that this block creates.
Currently support options - BLOCK_TYPE_LIST, BLOCK_TYPE_TEXT $content_type
|
inherited |
How often the cronjob should run, 0 if not at all.
$cron
|
inherited |
The initialized instance of this block object.
$instance
|
inherited |
The title of the block to be displayed in the block title area.
$title