Search moodle.org's
Developer Documentation
Developer Documentation
See Release Notes
Long Term Support Release
- Bug fixes for general core bugs in 4.1.x will end 13 November 2023 (12 months).
- Bug fixes for security issues in 4.1.x will end 10 November 2025 (36 months).
- PHP version: minimum PHP 7.4.0 Note: minimum PHP version has increased since Moodle 4.0. PHP 8.0.x is supported too.
/lib/portfolio/ -> caller.php (source)
Differences Between: [Versions 310 and 401] [Versions 311 and 401] [Versions 39 and 401] [Versions 400 and 401] [Versions 401 and 402] [Versions 401 and 403]
This file contains the base classes that are extended to create portfolio export functionality. For places in moodle that want to add export functionality to subclass.
| Copyright: | 2008 Penny Leach <penny@catalyst.net.nz>, Martin Dougiamas |
| License: | http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later |
| File Size: | 573 lines (19 kb) |
| Included or required: | 0 times |
| Referenced: | 0 times |
| Includes or requires: | 0 files |
Defines 2 classes
portfolio_caller_base:: (22 methods):
__construct()
export_config_form()
has_export_config()
export_config_validation()
expected_time_file()
get_sha1_file()
get()
set()
set_export_config()
get_export_config()
get_allowed_export_config()
get_export_summary()
prepare_package_file()
supported_formats()
base_supported_formats()
display_name()
heading_summary()
set_file_and_format_data()
set_formats_from_button()
add_format()
get_mimetype()
expected_callbackargs()
portfolio_module_caller_base:: (5 methods):
get_navigation()
get_return_url()
get()
heading_summary()
set_context()
Class: portfolio_caller_base - X-Ref
Base class for callers| __construct($callbackargs) X-Ref |
| Create portfolio_caller object param: array $callbackargs argument properties |
| export_config_form(&$mform, $instance) X-Ref |
| If this caller wants any additional config items, they should be defined here. param: moodleform $mform passed by reference, add elements to it. param: portfolio_plugin_base $instance subclass of portfolio_plugin_base |
| has_export_config() X-Ref |
| Whether this caller wants any additional config during export (eg options or metadata) return: bool |
| export_config_validation($data) X-Ref |
| Just like the moodle form validation function, this is passed in the data array from the form and if a non empty array is returned, form processing will stop. param: array $data data from form. |
| expected_time_file() X-Ref |
| Helper method to calculate expected time for multi or single file exports return: string file time expectation |
| get_sha1_file() X-Ref |
| Helper function to calculate the sha1 for multi or single file exports return: string sha1 file exports |
| get($field) X-Ref |
| Generic getter for properties belonging to this instance <b>outside</b> the subclasses like name, visible etc. param: string $field property's name return: mixed |
| set($field, &$value) X-Ref |
| Generic setter for properties belonging to this instance <b>outside</b> the subclass like name, visible, etc. param: string $field property's name param: mixed $value property's value return: bool |
| set_export_config($config) X-Ref |
| Stores the config generated at export time. Subclasses can retrieve values using param: array $config formdata |
| get_export_config($key) X-Ref |
| Returns a particular export config value. Subclasses shouldn't need to override this param: string $key the config item to fetch return: null|mixed of export configuration |
| get_allowed_export_config() X-Ref |
| Similar to the other allowed_config functions if you need export config, you must provide a list of what the fields are. Even if you want to store stuff during export without displaying a form to the user, you can use this. return: array array of allowed keys |
| get_export_summary() X-Ref |
| After the user submits their config, they're given a confirm screen summarising what they've chosen. This function should return a table of nice strings => values of what they've chosen to be displayed in a table. return: bool |
| prepare_package_file() X-Ref |
| Helper function to copy files into the temp area for single or multi file exports. return: stored_file|bool |
| supported_formats() X-Ref |
| Array of formats this caller supports. return: array list of formats |
| base_supported_formats() X-Ref |
| Base supported formats |
| display_name() X-Ref |
| Clean name to display to the user about this caller location |
| heading_summary() X-Ref |
| Return a string to put at the header summarising this export. By default, it just display the name (usually just 'assignment' or something unhelpful return: string |
| set_file_and_format_data($ids=null ) X-Ref |
| Set up the required files for this export. This supports either passing files directly or passing area arguments directly through to the files api using file_storage::get_area_files param: mixed $ids one of: return: void |
| set_formats_from_button($formats) X-Ref |
| The button-location always knows best what the formats are... so it should be trusted. param: array $formats array of PORTFOLIO_FORMAT_XX return: void |
| add_format($format) X-Ref |
| Adds a new format to the list of supported formats. This functions also handles removing conflicting and less specific formats at the same time. param: string $format one of PORTFOLIO_FORMAT_XX return: void |
| get_mimetype() X-Ref |
| Gets mimetype return: string |
| expected_callbackargs() X-Ref |
| Array of arguments the caller expects to be passed through to it. This must be keyed on the argument name, and the array value is a boolean, whether it is required, or just optional eg array( id => true, somethingelse => false ) |
Class: portfolio_module_caller_base - X-Ref
Base class for module callers.This just implements a few of the abstract functions
from portfolio_caller_base so that caller authors
don't need to.
| get_navigation() X-Ref |
| Navigation passed to print_header. Override this to do something more specific than the module view page like adding more links to the breadcrumb. return: array |
| get_return_url() X-Ref |
| The url to return to after export or on cancel. Defaults value is set to the module 'view' page. Override this if it's deeper inside the module. return: string |
| get($key) X-Ref |
| Override the parent get function to make sure when we're asked for a course, We retrieve the object from the database as needed. param: string $key the name of get function return: stdClass |
| heading_summary() X-Ref |
| Return a string to put at the header summarising this export. by default, this function just display the name and module instance name. Override this to do something more specific return: string |
| set_context($PAGE) X-Ref |
| Overridden to return the course module context param: moodle_page $PAGE global PAGE |
