Source for file assignment.class.php

Documentation is available at assignment.class.php

  1. <?php
  2.     // This file is part of the Sloodle project (www.sloodle.org)
  3.     
  4.     /**
  5.     * This file defines the "Sloodle Object" assignment sub-type.
  6.     * It allows students to submit 3d objects in Second Life as Moodle assignments.
  7.     *
  8.     * @package sloodle
  9.     * @copyright Copyright (c) 2008 Sloodle (various contributors)
  10.     * @license http://www.gnu.org/licenses/gpl-3.0.html GNU GPL v3
  11.     *
  12.     * @contributor (various Moodle guys!)
  13.     * @contributor Peter R. Bloomfield
  14.     */
  15.  
  16. /** Attempt to include the Sloodle configuration. */
  17. require_once($CFG->dirroot.'/mod/sloodle/sl_config.php');
  18. /** Include the general Sloodle functions. */
  19. require_once($CFG->dirroot.'/mod/sloodle/lib/general.php');
  20.  
  21. /** Include the base assignment class, if necessary. */
  22. require_once($CFG->dirroot.'/mod/assignment/lib.php');
  23.  
  24. /**
  25.  * Extend the base assignment class for assignments where you submit an SL object in-world.
  26.  * This has been modified from the "assignment_online" type.
  27.  * @package sloodle
  28.  */
  29. class assignment_sloodleobject extends assignment_base {
  30.  
  31.     function assignment_sloodleobject($cmid='staticonly', $assignment=NULL, $cm=NULL, $course=NULL) {
  32.         parent::assignment_base($cmid, $assignment, $cm, $course);
  33.         $this->type = 'sloodleobject';
  34.     }
  35.  
  36.     function view() {
  37.         
  38.         // Bring in the global user data
  39.         global $USER;
  40.  
  41.         // Check that this user can view assignments
  42.         $context = get_context_instance(CONTEXT_MODULE, $this->cm->id);
  43.         require_capability('mod/assignment:view', $context);
  44.         
  45.         // Fetch the submission data
  46.         $submission = $this->get_submission();
  47.         $sloodle_submission = new assignment_sloodleobject_submission();
  48.         $sloodle_submission->load_submission($submission);
  49.  
  50.         $this->view_header();
  51.         $this->view_intro();
  52.         $this->view_dates();
  53.         
  54.         // Display a texture summary of the submission
  55.         print_simple_box_start('center', '70%', '', 0, 'generalbox', 'online');
  56.         $sloodle_submission->text_summary(false);
  57.         print_simple_box_end();
  58.         
  59.         
  60.         $this->view_feedback();
  61.         $this->view_footer();
  62.     }
  63.  
  64.     /*
  65.      * Display the assignment dates
  66.      */
  67.     function view_dates() {
  68.         // Bring in the global user and configuration data
  69.         global $USER, $CFG;
  70.  
  71.         // Make sure the time available and time due dates are set
  72.         if (!$this->assignment->timeavailable && !$this->assignment->timedue) {
  73.             return;
  74.         }
  75.         // Start a display box
  76.         print_simple_box_start('center', '', '', 0, 'generalbox', 'dates');
  77.         echo '<table>';
  78.         // Display the time the assignment is available from
  79.         if ($this->assignment->timeavailable) {
  80.             echo '<tr><td class="c0">'.get_string('availabledate','assignment').':</td>';
  81.             echo '    <td class="c1">'.userdate($this->assignment->timeavailable).'</td></tr>';
  82.         }
  83.         // Display the time the assignment is due by
  84.         if ($this->assignment->timedue) {
  85.             echo '<tr><td class="c0">'.get_string('duedate','assignment').':</td>';
  86.             echo '    <td class="c1">'.userdate($this->assignment->timedue).'</td></tr>';
  87.         }
  88.         // Is there a submission by this user?
  89.         $submission = $this->get_submission($USER->id);
  90.         if ($submission) {
  91.             // Convert the submission to a Sloodle assignment object
  92.             $sloodle_submission = new assignment_sloodleobject_submission();
  93.             $sloodle_submission->load_submission($submission);
  94.         
  95.             // Display the date it was last updated
  96.             echo '<tr><td class="c0">'.get_string('lastedited').':</td>';
  97.             echo '    <td class="c1">'.userdate($submission->timemodified);
  98.             
  99.             // Display the number of prims in the submission
  100.             echo ' ('.get_string('numprims', 'sloodle', $sloodle_submission->num_prims).')</td></tr>';
  101.         }
  102.         echo '</table>';
  103.         print_simple_box_end();
  104.     }
  105.  
  106.     /**
  107.     * Update the submission with the provided data.
  108.     * @param int $userid Integer ID of the user making the submission
  109.     * @param assignment_sloodleobject_submission $data A structure containing data about the Sloodle assignment submission
  110.     * @return bool True if successful, or false otherwise.
  111.     */
  112.     function update_submission($userid, $data)
  113.     {
  114.         $submission = $this->get_submission($userid, true);
  115.  
  116.         $update = new object();
  117.         $update->id           = $submission->id;
  118.         $update->data1        = "{$data->obj_name}|{$data->num_prims}";
  119.         $update->data2        = "{$data->primdrop_name}|{$data->primdrop_uuid}|{$data->primdrop_region}|{$data->primdrop_pos}";
  120.         $update->timemodified = time();
  121.  
  122.         return update_record('assignment_submissions', $update);
  123.     }
  124.  
  125.  
  126.     function print_student_answer($userid, $return=true){
  127.         global $CFG;
  128.         $text = '';
  129.         
  130.         if (!($submission = $this->get_submission($userid))) {
  131.             $text = '';
  132.         } else {
  133.             // Output the Submission data
  134.             $sloodle_submission = new assignment_sloodleobject_submission();
  135.             $sloodle_submission->load_submission($submission);
  136.             
  137.             //$text = '<b>'.shorten_text(trim(strip_tags($sloodle_submission->obj_name)), 20).'</b><br>';
  138.             
  139.             $text = '<div class="files">'.
  140.                   '<img src="'.$CFG->pixpath.'/f/html.gif" class="icon" alt="html" />'.
  141.                   link_to_popup_window ('/mod/assignment/type/sloodleobject/file.php?id='.$this->cm->id.'&amp;userid='.
  142.                   $submission->userid, 'file'.$userid, shorten_text(trim(strip_tags($sloodle_submission->obj_name)), 20), 450, 580,
  143.                   get_string('submission', 'assignment'), 'none', true).
  144.                   '</div>';
  145.         }
  146.         
  147.         if ($return) return $text;
  148.         echo $text;
  149.     }
  150.     
  151.     
  152.     function print_user_files($userid, $return=false) {
  153.         global $CFG;
  154.         if (!$submission = $this->get_submission($userid)) {
  155.             return '';
  156.         }
  157.         
  158.         // Construct a Sloodle submission object
  159.         $sloodle_submission = new assignment_sloodleobject_submission();
  160.         $sloodle_submission->load_submission($submission);
  161.  
  162.         // Display the number of prims
  163.         print_simple_box_start('center', '', '', 0, 'generalbox', 'wordcount');
  164.         echo ' ('.get_string('numprims', 'sloodle', $sloodle_submission->num_prims).')';
  165.         print_simple_box_end();
  166.         
  167.         // Display the text summary of this submission
  168.         print_simple_box($sloodle_submission->text_summary(), 'center', '100%');
  169.     }
  170.     
  171.  
  172.     function preprocess_submission(&$submission) {
  173.         
  174.     }
  175.  
  176.     function setup_elements(&$mform) {
  177.         global $CFG, $COURSE;
  178.  
  179.         $ynoptions = array( 0 => get_string('no'), 1 => get_string('yes'));
  180.  
  181.         $mform->addElement('select', 'resubmit', get_string("allowresubmit", "assignment"), $ynoptions);
  182.         $mform->setHelpButton('resubmit', array('resubmit', get_string('allowresubmit', 'assignment'), 'assignment'));
  183.         $mform->setDefault('resubmit', 0);
  184.  
  185.         $mform->addElement('select', 'emailteachers', get_string("emailteachers", "assignment"), $ynoptions);
  186.         $mform->setHelpButton('emailteachers', array('emailteachers', get_string('emailteachers', 'assignment'), 'assignment'));
  187.         $mform->setDefault('emailteachers', 0);
  188.     }
  189.  
  190. }
  191.  
  192.  
  193. /**
  194. * Defines a submission for a Sloodle assignment.
  195. * @package sloodle
  196. */
  197. class assignment_sloodleobject_submission
  198. {
  199.     /**
  200.     * Indicates whether or not a submission is loaded
  201.     * @var bool 
  202.     * @access public
  203.     */
  204.     var $is_loaded = false;
  205.  
  206.     /**
  207.     * Name of the object which has been submitted.
  208.     * @var string 
  209.     * @access public
  210.     */
  211.     var $obj_name = '';
  212.     
  213.     /**
  214.     * Number of prims in the object which has been submitted
  215.     * @var int 
  216.     * @access public
  217.     */
  218.     var $num_prims = 0;
  219.     
  220.     /**
  221.     * Name of the PrimDrop object into which this object was submitted.
  222.     * @var string 
  223.     * @access public
  224.     */
  225.     var $primdrop_name = '';
  226.     
  227.     /**
  228.     * UUID of the PrimDrop object into which this object was submitted.
  229.     * @var string 
  230.     * @access public
  231.     */
  232.     var $primdrop_uuid = '';
  233.     
  234.     /**
  235.     * Name of the region where this object was submitted
  236.     * @var string 
  237.     * @access public
  238.     */
  239.     var $primdrop_region = '';
  240.     
  241.     /**
  242.     * Position where this object was submitted (as a vector, "<x,y,z>")
  243.     * @var string 
  244.     * @access public
  245.     */
  246.     var $primdrop_pos = '';
  247.     
  248.     
  249.     /**
  250.     * Parses the data from a Submission database record object.
  251.     * @var object $submission The submission database record object.
  252.     */
  253.     function load_submission($submission)
  254.     {
  255.         // Make sure the submission is valid
  256.         $this->is_loaded = false;
  257.         if ($submission == false || $submission == null) return;
  258.     
  259.         // Parse the data lines
  260.         $object_data = explode('|', $submission->data1);
  261.         $primdrop_data = explode('|', $submission->data2);
  262.         
  263.         // Make sure there's enough data in both
  264.         if (count($object_data) < 2 || count($primdrop_data) < 4) return;
  265.         
  266.         // Extract the data items
  267.         $this->obj_name = $object_data[0];
  268.         $this->num_prims = (int)$object_data[1];
  269.         $this->primdrop_name = $primdrop_data[0];
  270.         $this->primdrop_uuid = $primdrop_data[1];
  271.         $this->primdrop_region = $primdrop_data[2];
  272.         $this->primdrop_pos = $primdrop_data[3];
  273.         
  274.         $this->is_loaded = true;
  275.     }
  276.     
  277.     /**
  278.     * Sets the position as 3 components.
  279.     * @param float x The X coordinate
  280.     * @param float y The Y coordinate
  281.     * @param float z The Z coordinate
  282.     */
  283.     function set_pos($x, $y, $z)
  284.     {
  285.         $this->primdrop_pos = "<$x,$y,$z>";
  286.     }
  287.     
  288.     /**
  289.     * Gets the X coordinate of the position
  290.     * @return float The X coordinate of the position
  291.     */
  292.     function get_x()
  293.     {
  294.         $arr = sloodle_vector_to_array($this->primdrop_pos);
  295.         if (!$arr) return 0.0;
  296.         return (float)$arr['x'];
  297.     }
  298.     
  299.     /**
  300.     * Gets the Y coordinate of the position
  301.     * @return float The Y coordinate of the position
  302.     */
  303.     function get_y()
  304.     {
  305.         $arr = sloodle_vector_to_array($this->primdrop_pos);
  306.         if (!$arr) return 0.0;
  307.         return (float)$arr['y'];
  308.     }
  309.     
  310.     /**
  311.     * Gets the Z coordinate of the position
  312.     * @return float The Z coordinate of the position
  313.     */
  314.     function get_z()
  315.     {
  316.         $arr = sloodle_vector_to_array($this->primdrop_pos);
  317.         if (!$arr) return 0.0;
  318.         return (float)$arr['z'];
  319.     }
  320.     
  321.     /**
  322.     * Construct a text summary of this submission.
  323.     * @param bool $return If TRUE (default) then the text will be submitted instead of printed.
  324.     * @return string If parameter $return was TRUE, then it returns the string. Otherwise, an empty string.
  325.     */
  326.     function text_summary($return = true)
  327.     {
  328.         // Make sure something is loaded
  329.         if (!$this->is_loaded) {
  330.             $text = get_string('emptysubmission', 'assignment');
  331.         } else {
  332.             $text = "Object name: <b>{$this->obj_name}</b><br><br>";
  333.             $text .= "Submitted to: {$this->primdrop_name}<br>";
  334.             $text .= " <i>({$this->primdrop_uuid})</i><br><br>";
  335.             
  336.             $arr = sloodle_vector_to_array($this->primdrop_pos);
  337.             if (!$arr) $arr = array('x'=>0, 'y'=>0, 'z'=>0);
  338.             
  339.             $loc = "secondlife://{$this->primdrop_region}/{$arr['x']}/{$arr['y']}/{$arr['z']}";
  340.             $text .= "<b><a href=\"$loc\">$loc</a></b><br>";
  341.         }
  342.         
  343.         if ($return) return $text;
  344.         echo $text;
  345.         return '';
  346.     }
  347. }
  348.  
  349.  
  350.  

Documentation generated on Mon, 16 Jun 2008 15:56:06 +0100 by phpDocumentor 1.4.0