SWAMPy

✎ CARVE FLESH

EDITING: overview.php

<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.

namespace mod_assign\courseformat;

use assign;
use cm_info;
use core\url;
use mod_assign\dates;
use core_calendar\output\humandate;
use core\output\local\properties\text_align;
use core_courseformat\local\overview\overviewitem;
use core_courseformat\output\local\overview\overviewaction;

/**
 * Assignment overview integration.
 *
 * @package    mod_assign
 * @copyright  2025 Ferran Recio <ferran@moodle.com>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class overview extends \core_courseformat\activityoverviewbase {
    /** @var assign $assign the assign instance. */
    private assign $assign;

/**
     * Constructor.
     *
     * @param cm_info $cm the course module instance.
     */
    public function __construct(
        cm_info $cm,
    ) {
        global $CFG;
        require_once($CFG->dirroot . '/mod/assign/locallib.php');

parent::__construct($cm);
        $this->assign = new assign($this->context, $this->cm, $this->cm->get_course());
    }

#[\Override]
    public function get_due_date_overview(): ?overviewitem {
        global $USER;

$dates = new dates($this->cm, $USER->id);
        $duedate = $dates->get_due_date();

if (empty($duedate)) {
            return new overviewitem(
                name: get_string('duedate', 'assign'),
                value: null,
                content: '-',
            );
        }

$content = humandate::create_from_timestamp($duedate);

return new overviewitem(
            name: get_string('duedate', 'assign'),
            value: $duedate,
            content: $content,
        );
    }

#[\Override]
    public function get_actions_overview(): ?overviewitem {
        if (!has_capability('mod/assign:grade', $this->context)) {
            return null;
        }

$alertlabel = get_string('numberofsubmissionsneedgrading', 'assign');
        $name = get_string('view');
        $needgrading = 0;

if (is_gradable(courseid: $this->course->id, itemtype: 'mod', itemmodule: 'assign', iteminstance: $this->cm->instance)) {
            $needgrading = $this->assign->count_submissions_need_grading_with_groups(
                array_keys($this->get_groups_for_filtering()),
            );
            if ($needgrading > 0) {
                $name = get_string('gradeverb');
            }
        }

$content = new overviewaction(
            url: new url('/mod/assign/view.php', ['id' => $this->cm->id, 'action' => 'grading']),
            text: $name,
            badgevalue: $needgrading > 0 ? $needgrading : null,
            badgetitle: $needgrading > 0 ? $alertlabel : null,
        );

return new overviewitem(
            name: get_string('actions'),
            value: $name,
            content: $content,
            textalign: text_align::CENTER,
            alertcount: $needgrading,
            alertlabel: $alertlabel,
        );
    }

#[\Override]
    public function get_extra_overview_items(): array {
        return [
            'submissions' => $this->get_extra_submissions_overview(),
            'submissionstatus' => $this->get_extra_submission_status_overview(),
        ];
    }

/**
     * Retrieves an overview of submissions for the assignment.
     *
     * @return overviewitem|null An overview item c, or null if the user lacks the required capability.
     */
    private function get_extra_submissions_overview(): ?overviewitem {
        if (!has_capability('mod/assign:grade', $this->cm->context)) {
            return null;
        }

$groups = array_keys($this->get_groups_for_filtering());
        $submissions = $this->assign->count_submissions_with_status_and_groups(
            ASSIGN_SUBMISSION_STATUS_SUBMITTED,
            $groups,
        );
        if ($this->assign->get_instance()->teamsubmission) {
            // For team submissions, total represents the number of groups (instead of participants).
            if (!empty($groups)) {
                $total = count($groups);
            } else {
                $total = $this->assign->count_teams();
            }
        } else {
            $total = $this->assign->count_participants_by_groups($groups);
        }

return new overviewitem(
            name: get_string('submissions', 'assign'),
            value: $submissions,
            content: get_string(
                'count_of_total',
                'core',
                ['count' => $submissions, 'total' => $total]
            ),
            textalign: text_align::END,
        );
    }

/**
     * Retrieves the submission status overview for the current user.
     *
     * @return overviewitem|null The overview item, or null if the user does not have the required capabilities.
     */
    private function get_extra_submission_status_overview(): ?overviewitem {
        global $USER;

if (!has_capability('mod/assign:submit', $this->context, $USER, false)) {
            return null;
        }

if ($this->assign->get_instance()->teamsubmission) {
            $usersubmission = $this->assign->get_group_submission($USER->id, 0, false);
        } else {
            $usersubmission = $this->assign->get_user_submission($USER->id, false);
        }

if (!empty($usersubmission->status)) {
            $submittedstatus = get_string('submissionstatus_' . $usersubmission->status, 'assign');
        } else {
            $submittedstatus = get_string('submissionstatus_', 'assign');
        }

return new overviewitem(
            name: get_string('submissionstatus', 'assign'),
            value: $submittedstatus,
            content: $submittedstatus,
        );
    }
}

CANCEL

Name	Type	Size	Modified	Actions
↩ ..	DIR	—	—
📄 overview.php	PHP	6.2 KB	2026-02-11 01:44	EDIT