. 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\column as column_model; 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 * @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 filters should be applied in report (we don't want them when editing) */ protected const REPORT_APPLY_FILTERS = false; /** * 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 . '(?\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 system 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. $columns = $this->get_active_columns(); if (empty($columns)) { $this->init_sql('*', "{{$maintable}} {$maintablealias}", [], '1=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()); }); $hasaggregatedcolumns = !empty($aggregatedcolumns); $columnheaders = []; foreach ($columns as $column) { $columnheaders[$column->get_column_alias()] = $column->get_persistent()->get('heading') ?: $column->get_title(); $columnaggregation = $column->get_aggregation(); if ($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()); } } $this->define_columns(array_keys($columnheaders)); $this->define_headers(array_values($columnheaders)); // Table configuration. $this->initialbars(false); $this->collapsible(false); $this->pageable(true); // Initialise table SQL properties. $this->set_filters_applied(static::REPORT_APPLY_FILTERS); $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() { $sortcolumns = parent::get_sort_columns(); if (empty($sortcolumns)) { $columns = $this->get_active_columns(); $instances = column_model::get_records([ 'reportid' => $this->report->get_report_persistent()->get('id'), 'sortenabled' => 1, ], 'sortorder'); foreach ($instances as $instance) { $column = $columns[$instance->get('id')] ?? null; if ($column !== null && $column->get_is_available()) { $sortcolumns[$column->get_column_alias()] = $instance->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[] Indexed by column ID */ private function get_active_columns(): array { $columns = []; $instances = column_model::get_records(['reportid' => $this->report->get_report_persistent()->get('id')], 'columnorder'); foreach ($instances as $index => $instance) { $column = $this->report->get_column($instance->get('uniqueidentifier')); if ($column !== null && $column->get_is_available()) { $column->set_persistent($instance); // We should clone the report column to ensure if it's added twice to a report, each operates independently. $columns[$instance->get('id')] = clone $column ->set_index($index) ->set_aggregation($instance->get('aggregation')); } } return $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)) ->set_extra_classes(['mt-3']); echo $OUTPUT->render($notification); echo $this->get_dynamic_table_html_end(); } }