. /** * This file contains the customcert element gradeitemname's core interaction API. * * @package customcertelement_gradeitemname * @copyright 2013 Mark Nelson * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace customcertelement_gradeitemname; defined('MOODLE_INTERNAL') || die(); /** * The customcert element gradeitemname's core interaction API. * * @package customcertelement_gradeitemname * @copyright 2013 Mark Nelson * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class element extends \mod_customcert\element { /** * This function renders the form elements when adding a customcert element. * * @param \MoodleQuickForm $mform the edit_form instance */ public function render_form_elements($mform) { global $COURSE; $mform->addElement('select', 'gradeitem', get_string('gradeitem', 'customcertelement_gradeitemname'), \mod_customcert\element_helper::get_grade_items($COURSE)); $mform->addHelpButton('gradeitem', 'gradeitem', 'customcertelement_gradeitemname'); parent::render_form_elements($mform); } /** * This will handle how form data will be saved into the data column in the * customcert_elements table. * * @param \stdClass $data the form data * @return string the text */ public function save_unique_data($data) { if (!empty($data->gradeitem)) { return $data->gradeitem; } return ''; } /** * Handles rendering the element on the pdf. * * @param \pdf $pdf the pdf object * @param bool $preview true if it is a preview, false otherwise * @param \stdClass $user the user we are rendering this for */ public function render($pdf, $preview, $user) { // Check that the grade item is not empty. if (!empty($this->get_data())) { \mod_customcert\element_helper::render_content($pdf, $this, $this->get_grade_item_name()); } } /** * Render the element in html. * * This function is used to render the element when we are using the * drag and drop interface to position it. * * @return string the html */ public function render_html() { // Check that the grade item is not empty. if (!empty($this->get_data())) { return \mod_customcert\element_helper::render_html_content($this, $this->get_grade_item_name()); } return ''; } /** * Sets the data on the form when editing an element. * * @param \MoodleQuickForm $mform the edit_form instance */ public function definition_after_data($mform) { if (!empty($this->get_data())) { $element = $mform->getElement('gradeitem'); $element->setValue($this->get_data()); } parent::definition_after_data($mform); } /** * Helper function that returns the category name. * * @return string */ protected function get_grade_item_name() : string { global $DB; // Get the course module information. $cm = $DB->get_record('course_modules', array('id' => $this->get_data()), '*', MUST_EXIST); $module = $DB->get_record('modules', array('id' => $cm->module), '*', MUST_EXIST); // Get the name of the item. $itemname = $DB->get_field($module->name, 'name', array('id' => $cm->instance), MUST_EXIST); return format_string($itemname, true, ['context' => \mod_customcert\element_helper::get_context($this->get_id())]); } }