Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.2.x will end 22 April 2024 (12 months).
  • Bug fixes for security issues in 4.2.x will end 7 October 2024 (18 months).
  • PHP version: minimum PHP 8.0.0 Note: minimum PHP version has increased since Moodle 4.1. PHP 8.1.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\table;

use core\output\notification;
use html_writer;
use moodle_exception;
use moodle_url;
use stdClass;
use core_reportbuilder\manager;
use core_reportbuilder\local\models\report;
use core_reportbuilder\local\report\column;
use core_reportbuilder\output\column_aggregation_editable;
use core_reportbuilder\output\column_heading_editable;

/**
 * Custom report dynamic table class
 *
 * @package     core_reportbuilder
 * @copyright   2021 David Matamoros <davidmc@moodle.com>
 * @license     http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class custom_report_table extends base_report_table {

    /** @var string Unique ID prefix for the table */
    private const UNIQUEID_PREFIX = 'custom-report-table-';

    /** @var bool Whether report is being edited (we don't want user filters/sorting to be applied when editing) */
    protected const REPORT_EDITING = true;

> /** @var float $querytimestart Time we began executing table SQL */ /** > private $querytimestart = 0.0; * Table constructor. Note that the passed unique ID value must match the pattern "custom-report-table-(\d+)" so that >
* dynamic updates continue to load the same report * * @param string $uniqueid * @param string $download * @throws moodle_exception For invalid unique ID */ public function __construct(string $uniqueid, string $download = '') { if (!preg_match('/^' . self::UNIQUEID_PREFIX . '(?<id>\d+)$/', $uniqueid, $matches)) { throw new moodle_exception('invalidcustomreportid', 'core_reportbuilder', '', null, $uniqueid); } parent::__construct($uniqueid); $this->define_baseurl(new moodle_url('/reportbuilder/edit.php', ['id' => $matches['id']])); // Load the report persistent, and accompanying report instance. $this->persistent = new report($matches['id']); $this->report = manager::get_report_from_persistent($this->persistent); $fields = $groupby = []; $maintable = $this->report->get_main_table(); $maintablealias = $this->report->get_main_table_alias(); $joins = $this->report->get_joins(); [$where, $params] = $this->report->get_base_condition(); $this->set_attribute('data-region', 'reportbuilder-table'); $this->set_attribute('class', $this->attributes['class'] . ' reportbuilder-table'); // Download options. $this->showdownloadbuttonsat = [TABLE_P_BOTTOM]; $this->is_downloading($download ?? null, $this->persistent->get_formatted_name());
< // Retrieve all report columns, exit early if there are none.
> // Retrieve all report columns, exit early if there are none. Defining empty columns prevents errors during out().
$columns = $this->get_active_columns(); if (empty($columns)) { $this->init_sql("{$maintablealias}.*", "{{$maintable}} {$maintablealias}", $joins, '1=0', []);
> $this->define_columns([0]);
return; } // If we are aggregating any columns, we should group by the remaining ones. $aggregatedcolumns = array_filter($columns, static function(column $column): bool { return !empty($column->get_aggregation()); }); // Also take account of the report setting to show unique rows (only if no columns are being aggregated). $hasaggregatedcolumns = !empty($aggregatedcolumns); $showuniquerows = !$hasaggregatedcolumns && $this->persistent->get('uniquerows'); $columnheaders = $columnsattributes = []; foreach ($columns as $column) { $columnheading = $column->get_persistent()->get_formatted_heading($this->report->get_context()); $columnheaders[$column->get_column_alias()] = $columnheading !== '' ? $columnheading : $column->get_title(); // We need to determine for each column whether we should group by it's fields, to support aggregation. $columnaggregation = $column->get_aggregation(); if ($showuniquerows || ($hasaggregatedcolumns && empty($columnaggregation))) { $groupby = array_merge($groupby, $column->get_groupby_sql()); } // Add each columns fields, joins and params to our report. $fields = array_merge($fields, $column->get_fields()); $joins = array_merge($joins, $column->get_joins()); $params = array_merge($params, $column->get_params()); // Disable sorting for some columns. if (!$column->get_is_sortable()) { $this->no_sorting($column->get_column_alias()); } // Add column attributes needed for card view. $settings = $this->report->get_settings_values(); $showfirsttitle = $settings['cardview_showfirsttitle'] ?? false; $visiblecolumns = max($settings['cardview_visiblecolumns'] ?? 1, count($this->columns)); if ($showfirsttitle || $column->get_persistent()->get('columnorder') > 1) { $column->add_attributes(['data-cardtitle' => $columnheaders[$column->get_column_alias()]]); } if ($column->get_persistent()->get('columnorder') > $visiblecolumns) { $column->add_attributes(['data-cardviewhidden' => '']); } // Generate column attributes to be included in each cell. $columnsattributes[$column->get_column_alias()] = $column->get_attributes(); } $this->define_columns(array_keys($columnheaders)); $this->define_headers(array_values($columnheaders)); // Add column attributes to the table. $this->set_columnsattributes($columnsattributes); // Table configuration. $this->initialbars(false); $this->collapsible(false); $this->pageable(true);
> $this->set_default_per_page($this->report->get_default_per_page());
// Initialise table SQL properties. $this->set_report_editing(static::REPORT_EDITING); $fieldsql = implode(', ', $fields); $this->init_sql($fieldsql, "{{$maintable}} {$maintablealias}", $joins, $where, $params, $groupby); } /** * Return a new instance of the class for given report ID * * @param int $reportid * @param string $download * @return static */ public static function create(int $reportid, string $download = ''): self { return new static(self::UNIQUEID_PREFIX . $reportid, $download); } /** * Get user preferred sort columns, overriding those of parent. If user has no preferences then use report defaults * * @return array */ public function get_sort_columns(): array { $sortcolumns = parent::get_sort_columns(); if ($this->editing || empty($sortcolumns)) { $sortcolumns = []; $columns = $this->get_active_columns(); // We need to sort the columns by the configured sorting order. usort($columns, static function(column $a, column $b): int { return ($a->get_persistent()->get('sortorder') < $b->get_persistent()->get('sortorder')) ? -1 : 1; }); foreach ($columns as $column) { $persistent = $column->get_persistent(); if ($column->get_is_sortable() && $persistent->get('sortenabled')) { $sortcolumns[$column->get_column_alias()] = $persistent->get('sortdirection'); } } } return $sortcolumns; } /** * Format each row of returned data, executing defined callbacks for the row and each column * * @param array|stdClass $row * @return array */ public function format_row($row) { $columns = $this->get_active_columns(); $formattedrow = []; foreach ($columns as $column) { $formattedrow[$column->get_column_alias()] = $column->format_value((array) $row); } return $formattedrow; } /** * Download is disabled when editing the report * * @return string */ public function download_buttons(): string { return ''; } /** * Get the columns of the custom report, returned instances being valid and available for the user * * @return column[] */ protected function get_active_columns(): array { return $this->report->get_active_columns(); } /** * Override parent method for printing headers so we can render our custom controls in each cell */ public function print_headers() { global $OUTPUT, $PAGE; $columns = $this->get_active_columns(); if (empty($columns)) { return; } $columns = array_values($columns); $renderer = $PAGE->get_renderer('core'); echo html_writer::start_tag('thead'); echo html_writer::start_tag('tr'); foreach ($this->headers as $index => $title) { $column = $columns[$index]; $headingeditable = new column_heading_editable(0, $column->get_persistent()); $aggregationeditable = new column_aggregation_editable(0, $column->get_persistent()); // Render table header cell, with all editing controls. $headercell = $OUTPUT->render_from_template('core_reportbuilder/table_header_cell', [ 'entityname' => $this->report->get_entity_title($column->get_entity_name()), 'name' => $column->get_title(), 'headingeditable' => $headingeditable->render($renderer), 'aggregationeditable' => $aggregationeditable->render($renderer), 'movetitle' => get_string('movecolumn', 'core_reportbuilder', $column->get_title()), ]); echo html_writer::tag('th', $headercell, [ 'class' => 'border-right border-left', 'scope' => 'col', 'data-region' => 'column-header', 'data-column-id' => $column->get_persistent()->get('id'), 'data-column-name' => $column->get_title(), 'data-column-position' => $index + 1, ]); } echo html_writer::end_tag('tr'); echo html_writer::end_tag('thead'); } /** * Override print_nothing_to_display to ensure that column headers are always added. */ public function print_nothing_to_display() { global $OUTPUT; $this->start_html(); $this->print_headers(); echo html_writer::end_tag('table'); echo html_writer::end_tag('div'); $this->wrap_html_finish();
< $notification = (new notification(get_string('nothingtodisplay'), notification::NOTIFY_INFO, false))
> // With the live editing disabled we need to notify user that data is shown only in preview mode. > if ($this->editing && !self::show_live_editing()) { > $notificationmsg = get_string('customreportsliveeditingdisabled', 'core_reportbuilder'); > $notificationtype = notification::NOTIFY_WARNING; > } else { > $notificationmsg = get_string('nothingtodisplay'); > $notificationtype = notification::NOTIFY_INFO; > } > > $notification = (new notification($notificationmsg, $notificationtype, false))
->set_extra_classes(['mt-3']); echo $OUTPUT->render($notification); echo $this->get_dynamic_table_html_end(); } /**
> * Provide additional table debugging during editing * Override get_row_cells_html to add an extra cell with the toggle button for card view. > */ * > public function wrap_html_finish(): void { * @param string $rowid > global $OUTPUT; * @param array $row > * @param array|null $suppresslastrow > if ($this->editing && debugging('', DEBUG_DEVELOPER)) { * @return string > $params = array_map(static function(string $param, $value): array { */ > return ['param' => $param, 'value' => var_export($value, true)]; public function get_row_cells_html(string $rowid, array $row, ?array $suppresslastrow): string { > }, array_keys($this->sql->params), $this->sql->params); $html = parent::get_row_cells_html($rowid, $row, $suppresslastrow); > > echo $OUTPUT->render_from_template('core_reportbuilder/local/report/debug', [ // Add extra 'td' in the row with card toggle button (only visible in card view). > 'query' => $this->get_table_sql(), $visiblecolumns = $this->report->get_settings_values()['cardview_visiblecolumns'] ?? 1; > 'params' => $params, if ($visiblecolumns < count($this->columns)) { > 'duration' => $this->querytimestart ? $buttonicon = html_writer::tag('i', '', ['class' => 'fa fa-angle-down']); > format_time($this->querytimestart - microtime(true)) : null, > ]); // We need a cleaned version (without tags/entities) of the first row column to use as toggle button. > } $rowfirstcolumn = strip_tags((string) reset($row)); > } $buttontitle = $rowfirstcolumn !== '' > ? get_string('showhide', 'core_reportbuilder', html_entity_decode($rowfirstcolumn)) > /**
< ? get_string('showhide', 'core_reportbuilder', html_entity_decode($rowfirstcolumn))
> ? get_string('showhide', 'core_reportbuilder', html_entity_decode($rowfirstcolumn, ENT_COMPAT))
$button = html_writer::tag('button', $buttonicon, [ 'type' => 'button', 'class' => 'btn collapsed', 'title' => $buttontitle, 'data-toggle' => 'collapse', 'data-action' => 'toggle-card' ]); $html .= html_writer::tag('td', $button, ['class' => 'card-toggle d-none']); } return $html;
> } } > } > /** > * Overriding this method to handle live editing setting. > * @param int $pagesize > * @param bool $useinitialsbar > * @param string $downloadhelpbutton > */ > public function out($pagesize, $useinitialsbar, $downloadhelpbutton = '') { > $this->pagesize = $pagesize; > $this->setup(); > > // If the live editing setting is disabled, we not need to fetch custom report data except in preview mode. > if (!$this->editing || self::show_live_editing()) { > $this->querytimestart = microtime(true); > $this->query_db($pagesize, $useinitialsbar); > $this->build_table(); > $this->close_recordset(); > } > > $this->finish_output(); > } > > /** > * Whether or not report data should be included in the table while in editing mode > * > * @return bool > */ > private static function show_live_editing(): bool { > global $CFG; > > return !empty($CFG->customreportsliveediting);