edit.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/>.

/**
 * Nolej module edit steps, from creation to activity generation.
 *
 * @package     local_nolej
 * @author      Vincenzo Padula <vincenzo@oc-group.eu>
 * @copyright   2024 OC Open Consulting SB Srl
 * @license     http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

require_once(__DIR__ . '/../../config.php');
require_once($CFG->dirroot . '/local/nolej/classes/api.php');
require_once($CFG->dirroot . '/local/nolej/classes/module.php');

use core\output\notification;
use local_nolej\api;
use local_nolej\module;
use local_nolej\utils;

$contextid = optional_param('contextid', SYSCONTEXTID /* Fallback to context system. */, PARAM_INT);

// Get the context instance and course data from the context ID.
[$context, $course] = utils::get_info_from_context($contextid);

// Perform security checks.
require_login($course);
require_capability('local/nolej:usenolej', $context);

// Is the API key missing?
if (!api::haskey()) {
    // API key missing. Redirect to the manage page.
    redirect(
        new moodle_url('/local/nolej/manage.php', ['contextid' => $context->id]),
        get_string('apikeymissing', 'local_nolej'),
        null,
        notification::NOTIFY_ERROR
    );
}

// Params.
$documentid = optional_param('documentid', null, PARAM_ALPHANUMEXT);
$step = empty($documentid) ? '' : optional_param('step', '', PARAM_ALPHA);

// Page configuration.
$PAGE->set_url(
    new moodle_url(
        '/local/nolej/edit.php',
        [
            'contextid' => $context->id,
            'documentid' => $documentid,
            'step' => $step,
        ]
    )
);
$PAGE->set_pagelayout('standard');
utils::page_setup($context, $course);

// CSS dependency.
$PAGE->requires->css('/local/nolej/styles.css');

// Code itself.
if (empty($documentid) || api::lookupdocumentstatus($documentid, $USER->id) <= module::STATUS_CREATION) {
    // Creation page title.
    $title = module::getstatusname(0);
    $PAGE->set_title($title);

    $module = new module($context->id);
    $module->creation();

} else {

    // Retrieve document data.
    $document = $DB->get_record('local_nolej_module', ['document_id' => $documentid, 'user_id' => $USER->id]);
    if (!$document) {
        // Document does not exist. Redirect to creation form.
        redirect($PAGE->url, get_string('modulenotfound', 'local_nolej'), null, notification::NOTIFY_ERROR);
    }

    $module = new module($context->id, $document, $step);

    // Module title.
    $PAGE->set_title(empty($document->title) ? module::getstatusname(0) : $document->title);

    if (module::isstatuspending($document->status)) {
        // Document is in pending state; print info and exit.
        \core\notification::add(
            module::getstatusname((int) $document->status),
            notification::NOTIFY_INFO
        );
        echo $OUTPUT->header();
        $module->printinfo();
        echo $OUTPUT->footer();
        return;
    }

    switch ($step) {
        case module::STEP_ANALYSIS:
            // Analysis can be executed iff the document is not yet in revision.
            if ($document->status < module::STATUS_REVISION) {
                // Step is set, execute as requested.
                $module->analysis();
            } else {
                // Step not valid, execute default.
                $module->setstep(module::STEP_CONCEPTS);
                $module->concepts();
            }
            break;

        case module::STEP_CONCEPTS:
        case module::STEP_QUESTIONS:
        case module::STEP_SUMMARY:
        case module::STEP_ACTIVITIES:
            // These revision steps can be executed iff the document is in revision.
            if ($document->status >= module::STATUS_REVISION) {
                // Step is set, execute as requested.
                $module->$step();
            } else {
                // Step not valid, execute default.
                $module->setstep(module::STEP_ANALYSIS);
                $module->analysis();
            }
            break;

        default:
            // Step is not set, execute default depending on the status.
            if ($document->status < module::STATUS_REVISION) {
                $module->setstep(module::STEP_ANALYSIS);
                $module->analysis();
            } else {
                $module->setstep(module::STEP_CONCEPTS);
                $module->concepts();
            }
    }
}