Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 4.1.x will end 13 November 2023 (12 months).
  • Bug fixes for security issues in 4.1.x will end 10 November 2025 (36 months).
  • PHP version: minimum PHP 7.4.0 Note: minimum PHP version has increased since Moodle 4.0. PHP 8.0.x is supported too.
<?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/>.

declare(strict_types=1);

namespace core_reportbuilder\local\helpers;

use context_user;
< use core_plugin_manager;
use core_user; use invalid_parameter_exception; use stdClass; use stored_file; use table_dataformat_export_format; use core\message\message; use core\plugininfo\dataformat; use core_reportbuilder\local\models\audience as audience_model; use core_reportbuilder\local\models\schedule as model; use core_reportbuilder\table\custom_report_table_view; /** * Helper class for report schedule related methods * * @package core_reportbuilder * @copyright 2021 Paul Holden <paulh@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class schedule { /** * Create report schedule, calculate when it should be next sent * * @param stdClass $data * @param int|null $timenow Time to use as comparison against current date (defaults to current time) * @return model */ public static function create_schedule(stdClass $data, ?int $timenow = null): model { $data->name = trim($data->name); $schedule = (new model(0, $data)); $schedule->set('timenextsend', self::calculate_next_send_time($schedule, $timenow)); return $schedule->create(); } /** * Update report schedule * * @param stdClass $data * @return model * @throws invalid_parameter_exception */ public static function update_schedule(stdClass $data): model { $schedule = model::get_record(['id' => $data->id, 'reportid' => $data->reportid]); if ($schedule === false) { throw new invalid_parameter_exception('Invalid schedule'); } // Normalize model properties. $data = array_intersect_key((array) $data, model::properties_definition()); if (array_key_exists('name', $data)) { $data['name'] = trim($data['name']); } $schedule->set_many($data); $schedule->set('timenextsend', self::calculate_next_send_time($schedule)) ->update(); return $schedule; } /** * Toggle report schedule enabled * * @param int $reportid * @param int $scheduleid * @param bool $enabled * @return bool * @throws invalid_parameter_exception */ public static function toggle_schedule(int $reportid, int $scheduleid, bool $enabled): bool { $schedule = model::get_record(['id' => $scheduleid, 'reportid' => $reportid]); if ($schedule === false) { throw new invalid_parameter_exception('Invalid schedule'); } return $schedule->set('enabled', $enabled)->update(); } /** * Return array of users who match the audience records added to the given schedule * * @param model $schedule * @return stdClass[] */ public static function get_schedule_report_users(model $schedule): array { global $DB; $audienceids = (array) json_decode($schedule->get('audiences')); // Retrieve all selected audience records for the schedule.
< [$audienceselect, $audienceparams] = $DB->get_in_or_equal($audienceids, SQL_PARAMS_NAMED, 'aid', true, true);
> [$audienceselect, $audienceparams] = $DB->get_in_or_equal($audienceids, SQL_PARAMS_NAMED, 'aid', true, null);
$audiences = audience_model::get_records_select("id {$audienceselect}", $audienceparams);
< if (count($audiences) === 0) { < return []; < }
// Now convert audiences to SQL for user retrieval. [$wheres, $params] = audience::user_audience_sql($audiences);
> if (count($wheres) === 0) { [$userorder] = users_order_by_sql('u'); > return []; > } $sql = 'SELECT u.* >
FROM {user} u
< WHERE ' . implode(' OR ', $wheres) . '
> WHERE (' . implode(' OR ', $wheres) . ') > AND u.deleted = 0
ORDER BY ' . $userorder; return $DB->get_records_sql($sql, $params); } /** * Return count of schedule report rows * * @param model $schedule * @return int */ public static function get_schedule_report_count(model $schedule): int { global $DB; $table = custom_report_table_view::create($schedule->get('reportid')); $table->setup(); return $DB->count_records_sql($table->countsql, $table->countparams); } /** * Generate stored file instance for given schedule, in user draft * * @param model $schedule * @return stored_file */ public static function get_schedule_report_file(model $schedule): stored_file {
< global $CFG;
> global $CFG, $USER; >
require_once("{$CFG->libdir}/filelib.php"); $table = custom_report_table_view::create($schedule->get('reportid')); $table->setup(); $table->query_db(0, false); // Set up table as if it were being downloaded, retrieve appropriate export class (ensure output buffer is // cleaned in order to instantiate export class without exception). ob_start(); $table->download = $schedule->get('format'); $exportclass = new table_dataformat_export_format($table, $table->download); ob_end_clean();
< // Create our schedule report stored file. < $context = context_user::instance($schedule->get('usercreated'));
> // Create our schedule report stored file temporarily in user draft.
$filerecord = [
< 'contextid' => $context->id,
> 'contextid' => context_user::instance($USER->id)->id,
'component' => 'user', 'filearea' => 'draft', 'itemid' => file_get_unused_draft_itemid(), 'filepath' => '/', 'filename' => clean_filename($schedule->get_formatted_name()), ]; $storedfile = \core\dataformat::write_data_to_filearea( $filerecord, $table->download, $exportclass->format_data($table->headers), $table->rawdata, static function(stdClass $record, bool $supportshtml) use ($table, $exportclass): array { $record = $table->format_row($record); if (!$supportshtml) { $record = $exportclass->format_data($record); } return $record; } ); $table->close_recordset(); return $storedfile; } /** * Check whether given schedule needs to be sent * * @param model $schedule * @return bool */ public static function should_send_schedule(model $schedule): bool { if (!$schedule->get('enabled')) { return false; } $timenow = time(); // Ensure we've reached the initial scheduled start time. $timescheduled = $schedule->get('timescheduled'); if ($timescheduled > $timenow) { return false; } // If there's no recurrence, check whether it's been sent since initial scheduled start time. This ensures that even if // the schedule was manually sent beforehand, it'll still be automatically sent once the start time is first reached. if ($schedule->get('recurrence') === model::RECURRENCE_NONE) { return $schedule->get('timelastsent') < $timescheduled; } return $schedule->get('timenextsend') <= $timenow; } /** * Calculate the next time a schedule should be sent, based on it's recurrence and when it was initially scheduled. Ensures * returned value is after the current date * * @param model $schedule * @param int|null $timenow Time to use as comparison against current date (defaults to current time) * @return int */ public static function calculate_next_send_time(model $schedule, ?int $timenow = null): int { global $CFG; $timenow = $timenow ?? time(); $recurrence = $schedule->get('recurrence'); $timescheduled = $schedule->get('timescheduled'); // If no recurrence is set or we haven't reached last sent date, return early. if ($recurrence === model::RECURRENCE_NONE || $timescheduled > $timenow) { return $timescheduled; } // Extract attributes from date (year, month, day, hours, minutes). [ 'year' => $year, 'mon' => $month, 'mday' => $day, 'wday' => $dayofweek, 'hours' => $hour, 'minutes' => $minute, ] = usergetdate($timescheduled, $CFG->timezone); switch ($recurrence) { case model::RECURRENCE_DAILY: $day += 1; break; case model::RECURRENCE_WEEKDAYS: $day += 1; $calendar = \core_calendar\type_factory::get_calendar_instance(); $weekend = get_config('core', 'calendar_weekend'); // Increment day until day of week falls on a weekday. while ((bool) ($weekend & (1 << (++$dayofweek % $calendar->get_num_weekdays())))) { $day++; } break; case model::RECURRENCE_WEEKLY: $day += 7; break; case model::RECURRENCE_MONTHLY: $month += 1; break; case model::RECURRENCE_ANNUALLY: $year += 1; break; } // We need to recursively increment the timestamp until we get one after the current time. $timestamp = make_timestamp($year, $month, $day, $hour, $minute, 0, $CFG->timezone); if ($timestamp < $timenow) { // Ensure we don't modify anything in the original model. $scheduleclone = new model(0, $schedule->to_record()); return self::calculate_next_send_time( $scheduleclone->set('timescheduled', $timestamp), $timenow); } else { return $timestamp; } } /** * Send schedule message to user * * @param model $schedule * @param stdClass $user * @param stored_file $attachment * @return bool */ public static function send_schedule_message(model $schedule, stdClass $user, stored_file $attachment): bool { $message = new message(); $message->component = 'moodle'; $message->name = 'reportbuilderschedule'; $message->courseid = SITEID; $message->userfrom = core_user::get_noreply_user(); $message->userto = $user; $message->subject = $schedule->get('subject'); $message->fullmessage = $schedule->get('message'); $message->fullmessageformat = $schedule->get('messageformat'); $message->fullmessagehtml = $message->fullmessage; $message->smallmessage = $message->fullmessage; // Attach report to outgoing message. $message->attachment = $attachment; $message->attachname = $attachment->get_filename(); return (bool) message_send($message); } /** * Delete report schedule * * @param int $reportid * @param int $scheduleid * @return bool * @throws invalid_parameter_exception */ public static function delete_schedule(int $reportid, int $scheduleid): bool { $schedule = model::get_record(['id' => $scheduleid, 'reportid' => $reportid]); if ($schedule === false) { throw new invalid_parameter_exception('Invalid schedule'); } return $schedule->delete(); } /** * Return list of available data formats * * @return string[] */ public static function get_format_options(): array {
< $dataformats = core_plugin_manager::instance()->get_plugins_of_type('dataformat');
> $dataformats = dataformat::get_enabled_plugins();
< return array_map(static function(dataformat $dataformat): string { < return $dataformat->displayname;
> return array_map(static function(string $pluginname): string { > return get_string('dataformat', 'dataformat_' . $pluginname);
}, $dataformats); } /** * Return list of available view as user options * * @return string[] */ public static function get_viewas_options(): array { return [ model::REPORT_VIEWAS_CREATOR => get_string('scheduleviewascreator', 'core_reportbuilder'), model::REPORT_VIEWAS_RECIPIENT => get_string('scheduleviewasrecipient', 'core_reportbuilder'), model::REPORT_VIEWAS_USER => get_string('userselect', 'core_reportbuilder'), ]; } /** * Return list of recurrence options * * @return string[] */ public static function get_recurrence_options(): array { return [ model::RECURRENCE_NONE => get_string('none'), model::RECURRENCE_DAILY => get_string('recurrencedaily', 'core_reportbuilder'), model::RECURRENCE_WEEKDAYS => get_string('recurrenceweekdays', 'core_reportbuilder'), model::RECURRENCE_WEEKLY => get_string('recurrenceweekly', 'core_reportbuilder'), model::RECURRENCE_MONTHLY => get_string('recurrencemonthly', 'core_reportbuilder'), model::RECURRENCE_ANNUALLY => get_string('recurrenceannually', 'core_reportbuilder'), ]; } /** * Return list of options for when report is empty * * @return string[] */ public static function get_report_empty_options(): array { return [ model::REPORT_EMPTY_SEND_EMPTY => get_string('scheduleemptysendwithattachment', 'core_reportbuilder'), model::REPORT_EMPTY_SEND_WITHOUT => get_string('scheduleemptysendwithoutattachment', 'core_reportbuilder'), model::REPORT_EMPTY_DONT_SEND => get_string('scheduleemptydontsend', 'core_reportbuilder'), ]; } }