Moodle PHP Documentation 4.4
Moodle 4.4.1 (Build: 20240610) (db07c09afc5)
cohort_upload_form Class Reference

Cohort upload form class. More...

Inheritance diagram for cohort_upload_form:
moodleform

Public Member Functions

 _process_submission ($method)
 Internal method.
 
 _validate_files (&$files)
 Internal method.
 
 add_action_buttons ($cancel=true, $submitlabel=null)
 Use this method to a cancel and submit button to the end of your form.
 
 add_checkbox_controller ($groupid, $text=null, $attributes=null, $originalValue=0)
 Adds a link/button that controls the checked state of a group of checkboxes.
 
 add_sticky_action_buttons (bool $cancel=true, ?string $submitlabel=null)
 Use this method to make a sticky submit/cancel button at the end of your form.
 
 definition ()
 Form definition.
 
 definition_after_data ()
 Process the uploaded file and allow the submit button only if it doest not have errors.
 
 display ()
 Print html form.
 
 filter_shown_headers (array $shownonly)
 Use this method to indicate that the fieldsets should be shown as expanded and all other fieldsets should be hidden.
 
 focus ($name=NULL)
 To autofocus on first form element or first element with error.
 
 get_cohorts_data ()
 Returns the list of prepared objects to be added as cohorts.
 
 get_data ()
 Return submitted data if properly submitted or returns NULL if validation fails or if there is no submitted data.
 
 get_file_content ($elname)
 Get content of uploaded file.
 
 get_new_filename ($elname=null)
 Returns name of uploaded file.
 
 get_submitted_data ()
 Return submitted data without validation or NULL if there is no submitted data.
 
 init_javascript_enhancement ($element, $enhancement, array $options=array(), array $strings=null)
 Adds an initialisation call for a standard JavaScript enhancement.
 
 is_cancelled ()
 Return true if a cancel button has been pressed resulting in the form being submitted.
 
 is_submitted ()
 Check that form was submitted.
 
 is_validated ()
 Check that form data is valid.
 
 moodleform ($action=null, $customdata=null, $method='post', $target='', $attributes=null, $editable=true)
 Old syntax of class constructor.
 
 no_submit_button_pressed ()
 Checks if button pressed is not for submitting the form.
 
 optional_param ($name, $default, $type)
 Checks if a parameter was passed in the previous form submission.
 
 render ()
 Renders the html form (same as display, but returns the result).
 
 repeat_elements ($elementobjs, $repeats, $options, $repeathiddenname, $addfieldsname, $addfieldsno=5, $addstring=null, $addbuttoninside=false, $deletebuttonname='')
 Method to add a repeating group of elements to a form.
 
 repeat_elements_fix_clone ($i, $elementclone, &$namecloned)
 Helper used by repeat_elements().
 
 save_file ($elname, $pathname, $override=false)
 Save file to standard filesystem.
 
 save_files ($destination)
 Save verified uploaded files into directory.
 
 save_stored_file ($elname, $newcontextid, $newcomponent, $newfilearea, $newitemid, $newfilepath='/', $newfilename=null, $overwrite=false, $newuserid=null)
 Save file to local filesystem pool.
 
 save_temp_file ($elname)
 Returns a temporary file, do not forget to delete after not needed any more.
 
 set_data ($default_values)
 Load in existing data as form defaults.
 
 set_display_vertical ()
 Set display mode for the form when labels take full width of the form and above the elements even on big screens.
 
 set_initial_dirty_state ($state=false)
 Set the initial 'dirty' state of the form.
 
 validate_defined_fields ($validateonnosubmit=false)
 Validate the form.
 
 validation ($data, $files)
 Dummy stub method - override if you needed to perform some extra validation.
 

Static Public Member Functions

static get_js_module ()
 Returns a JS module definition for the mforms JS.
 
static mock_ajax_submit ($simulatedsubmitteddata, $simulatedsubmittedfiles=array(), $method='post', $formidentifier=null)
 Used by tests to simulate submitted form data submission via AJAX.
 
static mock_generate_submit_keys ($data=[])
 Used by tests to generate valid submit keys for moodle forms that are submitted with ajax data.
 
static mock_submit ($simulatedsubmitteddata, $simulatedsubmittedfiles=array(), $method='post', $formidentifier=null)
 Used by tests to simulate submitted form data submission from the user.
 

Public Attributes

array $processeddata = null
 new cohorts that need to be created
 

Protected Member Functions

 _get_post_params ()
 Internal method - should not be used anywhere.
 
 add_cohort_upload_buttons ()
 Add buttons to the form ("Upload cohorts", "Preview", "Cancel")
 
 after_definition ()
 After definition hook.
 
 clean_cohort_data (&$hash)
 Cleans input data about one cohort.
 
 get_array_value_by_keys (array $array, array $keys)
 Returns an element of multi-dimensional array given the list of keys.
 
 get_cohort_file ($draftid)
 Returns the uploaded file if it is present.
 
 get_context_options ()
 Returns the list of contexts where current user can create cohorts.
 
 get_draft_files ($elname)
 Get draft files of a form element This is a protected method which will be used only inside moodleforms.
 
 get_form_identifier ()
 It should returns unique identifier for the form.
 
 get_previewed_rows ()
 Find up rows to show in preview.
 
 preview_uploaded_cohorts ()
 Displays the preview of the uploaded file.
 
 process_upload_file ($file, $encoding, $delimiter, $defaultcontext)
 
 resolve_context (&$hash, $defaultcontext)
 Determines in which context the particular cohort will be created.
 
 validate_draft_files ()
 Internal method.
 

Protected Attributes

array $_ajaxformdata
 submitted form data when using mforms with ajax
 
mixed $_customdata
 globals workaround
 
object $_definition_finalized = false
 definition_after_data executed flag
 
MoodleQuickForm $_form
 quickform object definition
 
string $_formname
 name of the form
 
bool null $_validated = null
 stores the validation result of this form or null if not yet validated
 
array $categoriescache = array()
 temporary cache for retrieved categories
 
array $contextoptions = null
 cached list of available contexts
 

Static Protected Attributes

static int $uniqueid = 0
 Unique identifier to be used for action buttons.
 

Detailed Description

Cohort upload form class.

License
http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

Member Function Documentation

◆ clean_cohort_data()

cohort_upload_form::clean_cohort_data ( & $hash)
protected

Cleans input data about one cohort.

Parameters
array$hash

◆ definition()

cohort_upload_form::definition ( )

Form definition.

Reimplemented from moodleform.

◆ definition_after_data()

cohort_upload_form::definition_after_data ( )

Process the uploaded file and allow the submit button only if it doest not have errors.

Reimplemented from moodleform.

◆ display()

cohort_upload_form::display ( )

Print html form.

Reimplemented from moodleform.

◆ get_cohort_file()

cohort_upload_form::get_cohort_file ( $draftid)
protected

Returns the uploaded file if it is present.

Parameters
int$draftid
Return values
stored_file|null

◆ get_cohorts_data()

cohort_upload_form::get_cohorts_data ( )

Returns the list of prepared objects to be added as cohorts.

Return values
arrayof stdClass objects, each can be passed to cohort_add_cohort()

◆ get_context_options()

cohort_upload_form::get_context_options ( )
protected

Returns the list of contexts where current user can create cohorts.

Return values
array

◆ get_previewed_rows()

cohort_upload_form::get_previewed_rows ( )
protected

Find up rows to show in preview.

Number of previewed rows is limited but rows with errors and warnings have priority.

Return values
array

◆ process_upload_file()

cohort_upload_form::process_upload_file ( $file,
$encoding,
$delimiter,
$defaultcontext )
protected
Parameters
stored_file$file
string$encoding
string$delimiter
context$defaultcontext
Return values
array

◆ resolve_context()

cohort_upload_form::resolve_context ( & $hash,
$defaultcontext )
protected

Determines in which context the particular cohort will be created.

Parameters
array$hash
context$defaultcontext
Return values
arrayarray of warning strings

◆ validation()

cohort_upload_form::validation ( $data,
$files )

Dummy stub method - override if you needed to perform some extra validation.

If there are errors return array of errors ("fieldname"=>"error message"), otherwise true if ok.

Server side rules do not work for uploaded files, implement serverside rules here if needed.

Parameters
array$dataarray of ("fieldname"=>value) of submitted data
array$filesarray of uploaded files "element_name"=>tmp_file_path
Return values
arrayof "element_name"=>"error_description" if there are errors, or an empty array if everything is OK (true allowed for backwards compatibility too).

Reimplemented from moodleform.


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