SWAMPy

✎ CARVE FLESH

EDITING: chart_series.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/>.

/**
 * Chart series.
 *
 * @package    core
 * @copyright  2016 Frédéric Massart - FMCorz.net
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

namespace core;
defined('MOODLE_INTERNAL') || die();

use coding_exception;
use JsonSerializable;

/**
 * Chart series class.
 *
 * @package    core
 * @copyright  2016 Frédéric Massart - FMCorz.net
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class chart_series implements JsonSerializable {

/** Default type for a series. */
    const TYPE_DEFAULT = null;
    /** Series of type line. */
    const TYPE_LINE = 'line';

/** @var string[] Colors of the series. */
    protected $colors = [];
    /** @var string Fill mode for area charts. See https://www.chartjs.org/docs/latest/charts/area.html */
    protected $fill = null;
    /** @var string Label for this series. */
    protected $label;
    /** @var string[] Labels for the values of the series. */
    protected $labels = null;
    /** @var bool Whether the line of the serie should be smooth or not. */
    protected $smooth = null;
    /** @var string Type of the series. */
    protected $type = self::TYPE_DEFAULT;
    /** @var float[] Values of the series. */
    protected $values = [];
    /** @var int Index of the X axis. */
    protected $xaxis = null;
    /** @var int Index of the Y axis. */
    protected $yaxis = null;

/**
     * Constructor.
     *
     * @param string $label The label of the series.
     * @param float[] $values The values of this series.
     */
    public function __construct($label, $values) {
        $this->values = $values;
        $this->label = $label;
    }

/**
     * Get the color.
     *
     * @return string|null
     */
    public function get_color() {
        return isset($this->colors[0]) ? $this->colors[0] : null;
    }

/**
     * Get the colors for each value in the series.
     *
     * @return string[]
     */
    public function get_colors() {
        return $this->colors;
    }

/**
     * Get the number of values in this series.
     *
     * @return int
     */
    public function get_count() {
        return count($this->values);
    }

/**
     * Get area fill mode for series.
     */
    public function get_fill() {
        return $this->fill;
    }

/**
     * Get the label of the series.
     *
     * @return string
     */
    public function get_label() {
        return $this->label;
    }

/**
     * Set labels for the values of the series.
     *
     * @return array
     */
    public function get_labels() {
        return $this->labels;
    }

/**
     * Get whether the line of the serie should be smooth or not.
     *
     * @return bool
     */
    public function get_smooth() {
        return $this->smooth;
    }

/**
     * Get the type of series.
     *
     * @return string
     */
    public function get_type() {
        return $this->type;
    }

/**
     * Get the values of the series.
     *
     * @return string[]
     */
    public function get_values() {
        return $this->values;
    }

/**
     * Get the index of the X axis.
     *
     * @return int
     */
    public function get_xaxis() {
        return $this->xaxis;
    }

/**
     * Get the index of the Y axis.
     *
     * @return int
     */
    public function get_yaxis() {
        return $this->yaxis;
    }

/**
     * Whether there is a color per value.
     *
     * @return bool
     */
    public function has_colored_values() {
        return count($this->colors) == $this->get_count();
    }

/**
     * Serialize the object.
     *
     * @return array
     */
    public function jsonSerialize(): array {
        $data = [
            'label' => $this->label,
            'labels' => $this->labels,
            'type' => $this->type,
            'values' => $this->values,
            'colors' => $this->colors,
            'fill' => $this->fill,
            'axes' => [
                'x' => $this->xaxis,
                'y' => $this->yaxis,
            ],
            'smooth' => $this->smooth
        ];
        return $data;
    }

/**
     * Set the color of the series.
     *
     * @param string $color CSS compatible color.
     */
    public function set_color($color) {
        $this->colors = [$color];
    }

/**
     * Set a color for each value in the series.
     *
     * @param string[] $colors CSS compatible colors.
     */
    public function set_colors(array $colors) {
        $this->colors = $colors;
    }

/**
     * Set fill mode for the series.
     * @param string $fill
     */
    public function set_fill($fill) {
        $this->fill = $fill;
    }

/**
     * Set labels for the values of the series.
     *
     * @param array $labels The labels for the series values.
     */
    public function set_labels($labels) {
        $this->labels = $labels;
    }

/**
     * Set whether the line of the serie should be smooth or not.
     *
     * Only applicable for line chart or a line series, if null it assumes the chart default (not smooth).
     *
     * @param bool $smooth True if the line should be smooth, false for tensioned lines.
     */
    public function set_smooth($smooth) {
        $this->smooth = $smooth;
    }

/**
     * Set the type of the series.
     *
     * @param string $type Constant value from self::TYPE_*.
     */
    public function set_type($type) {
        if (!in_array($type, [self::TYPE_DEFAULT, self::TYPE_LINE])) {
            throw new coding_exception('Invalid serie type.');
        }
        $this->type = $type;
    }

/**
     * Set the index of the X axis.
     *
     * @param int $index The index.
     */
    public function set_xaxis($index) {
        $this->xaxis = $index;
    }

/**
     * Set the index of the Y axis.
     *
     * @param int $index The index.
     */
    public function set_yaxis($index) {
        $this->yaxis = $index;
    }

}

CANCEL

Name	Type	Size	Modified	Actions
↩ ..	DIR	—	—
📁 access/	DIR	—	2026-02-11 01:44
📁 analytics/	DIR	—	2026-02-11 01:44
📁 antivirus/	DIR	—	2026-02-11 01:44
📁 attribute/	DIR	—	2026-02-11 01:44
📁 aws/	DIR	—	2026-02-11 01:44
📁 check/	DIR	—	2026-02-11 01:44
📁 content/	DIR	—	2026-02-11 01:44
📁 context/	DIR	—	2026-02-11 01:44
📁 dataformat/	DIR	—	2026-02-11 01:44
📁 dml/	DIR	—	2026-02-11 01:44
📁 event/	DIR	—	2026-02-11 01:44
📁 exception/	DIR	—	2026-02-11 01:44
📁 external/	DIR	—	2026-02-11 01:44
📁 files/	DIR	—	2026-02-11 01:44
📁 form/	DIR	—	2026-02-11 01:44
📁 hook/	DIR	—	2026-02-11 01:44
📁 hub/	DIR	—	2026-02-11 01:44
📁 local/	DIR	—	2026-02-11 01:44
📁 lock/	DIR	—	2026-02-11 01:44
📁 log/	DIR	—	2026-02-11 01:44
📁 message/	DIR	—	2026-02-11 01:44
📁 moodlenet/	DIR	—	2026-02-11 01:44
📁 navigation/	DIR	—	2026-02-11 01:44
📁 oauth2/	DIR	—	2026-02-11 01:44
📁 output/	DIR	—	2026-02-11 01:44
📁 plugininfo/	DIR	—	2026-02-11 01:44
📁 privacy/	DIR	—	2026-02-11 01:44
📁 progress/	DIR	—	2026-02-11 01:44
📁 reportbuilder/	DIR	—	2026-02-11 01:44
📁 route/	DIR	—	2026-02-11 01:44
📁 router/	DIR	—	2026-02-11 01:44
📁 session/	DIR	—	2026-02-11 01:44
📁 task/	DIR	—	2026-02-11 01:44
📁 test/	DIR	—	2026-02-11 01:44
📁 tests/	DIR	—	2026-02-11 01:44
📁 update/	DIR	—	2026-02-11 01:44
📁 upgrade/	DIR	—	2026-02-11 01:44
📄 activity_dates.php	PHP	3 KB	2026-02-11 01:44	EDIT
📄 ajax.php	PHP	2.5 KB	2026-02-11 01:44	EDIT
📄 attribute_helper.php	PHP	9.5 KB	2026-02-11 01:44	EDIT
📄 chart_axis.php	PHP	4.3 KB	2026-02-11 01:44	EDIT
📄 chart_bar.php	PHP	2.7 KB	2026-02-11 01:44	EDIT
📄 chart_base.php	PHP	9.1 KB	2026-02-11 01:44	EDIT
📄 chart_line.php	PHP	1.9 KB	2026-02-11 01:44	EDIT
📄 chart_pie.php	PHP	1.9 KB	2026-02-11 01:44	EDIT
📄 chart_series.php	PHP	6.5 KB	2026-02-11 01:44	EDIT
📄 clock.php	PHP	1.1 KB	2026-02-11 01:44	EDIT
📄 collator.php	PHP	14.4 KB	2026-02-11 01:44	EDIT
📄 component.php	PHP	80 KB	2026-02-11 01:44	EDIT
📄 content.php	PHP	7 KB	2026-02-11 01:44	EDIT
📄 context.php	PHP	35.4 KB	2026-02-11 01:44	EDIT
📄 context_helper.php	PHP	15.5 KB	2026-02-11 01:44	EDIT
📄 cron.php	PHP	26.8 KB	2026-02-11 01:44	EDIT
📄 cssparser.php	PHP	1.4 KB	2026-02-11 01:44	EDIT
📄 dataformat.php	PHP	6.9 KB	2026-02-11 01:44	EDIT
📄 date.php	PHP	38.2 KB	2026-02-11 01:44	EDIT
📄 deprecation.php	PHP	9 KB	2026-02-11 01:44	EDIT
📄 di.php	PHP	5.3 KB	2026-02-11 01:44	EDIT
📄 emoticon_manager.php	PHP	7.2 KB	2026-02-11 01:44	EDIT
📄 encryption.php	PHP	9.1 KB	2026-02-11 01:44	EDIT
📄 environment.php	PHP	5.4 KB	2026-02-11 01:44	EDIT
📄 filetypes.php	PHP	41.5 KB	2026-02-11 01:44	EDIT
📄 formatting.php	PHP	15.5 KB	2026-02-11 01:44	EDIT
📄 geopattern.php	PHP	1.3 KB	2026-02-11 01:44	EDIT
📄 grades_external.php	PHP	8.3 KB	2026-02-11 01:44	EDIT
📄 grading_external.php	PHP	24.2 KB	2026-02-11 01:44	EDIT
📄 hooks.php	PHP	3.5 KB	2026-02-11 01:44	EDIT
📄 http_client.php	PHP	6.4 KB	2026-02-11 01:44	EDIT
📄 invalid_persistent_exception.php	PHP	1.6 KB	2026-02-11 01:44	EDIT
📄 ip_utils.php	PHP	14.6 KB	2026-02-11 01:44	EDIT
📄 lang_string.php	PHP	11 KB	2026-02-11 01:44	EDIT
📄 locale.php	PHP	2.8 KB	2026-02-11 01:44	EDIT
📄 minify.php	PHP	3.6 KB	2026-02-11 01:44	EDIT
📄 notification.php	PHP	7.5 KB	2026-02-11 01:44	EDIT
📄 param.php	PHP	42.1 KB	2026-02-11 01:44	EDIT
📄 param_clientside_regex.php	PHP	1.4 KB	2026-02-11 01:44	EDIT
📄 persistent.php	PHP	33 KB	2026-02-11 01:44	EDIT
📄 php_time_limit.php	PHP	3.8 KB	2026-02-11 01:44	EDIT
📄 plugin_manager.php	PHP	77.8 KB	2026-02-11 01:44	EDIT
📄 qrcode.php	PHP	1.4 KB	2026-02-11 01:44	EDIT
📄 report_helper.php	PHP	8.3 KB	2026-02-11 01:44	EDIT
📄 requirejs.php	PHP	4.8 KB	2026-02-11 01:44	EDIT
📄 router.php	PHP	11.3 KB	2026-02-11 01:44	EDIT
📄 rtlcss.php	PHP	2 KB	2026-02-11 01:44	EDIT
📄 scss.php	PHP	6.7 KB	2026-02-11 01:44	EDIT
📄 setup.php	PHP	2.1 KB	2026-02-11 01:44	EDIT
📄 shortlink.php	PHP	11.9 KB	2026-02-11 01:44	EDIT
📄 shortlink_handler.php	PHP	1.2 KB	2026-02-11 01:44	EDIT
📄 shortlink_handler_interface.php	PHP	1.4 KB	2026-02-11 01:44	EDIT
📄 shutdown_manager.php	PHP	10.3 KB	2026-02-11 01:44	EDIT
📄 string_manager.php	PHP	5.2 KB	2026-02-11 01:44	EDIT
📄 string_manager_install.php	PHP	9 KB	2026-02-11 01:44	EDIT
📄 string_manager_standard.php	PHP	29.6 KB	2026-02-11 01:44	EDIT
📄 system_clock.php	PHP	1.2 KB	2026-02-11 01:44	EDIT
📄 text.php	PHP	25.5 KB	2026-02-11 01:44	EDIT
📄 url.php	PHP	32.1 KB	2026-02-11 01:44	EDIT
📄 user.php	PHP	69.7 KB	2026-02-11 01:44	EDIT
📄 useragent.php	PHP	42.4 KB	2026-02-11 01:44	EDIT
📄 userfeedback.php	PHP	6.5 KB	2026-02-11 01:44	EDIT
📄 uuid.php	PHP	5.1 KB	2026-02-11 01:44	EDIT
📄 xml_parser.php	PHP	6.9 KB	2026-02-11 01:44	EDIT