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

/**
 * Cache manager.
 *
 * @package    tool_usertours
 * @copyright  2016 Andrew Nicols <andrew@nicols.co.uk>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

namespace tool_usertours;

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

/**
 * Cache manager.
 *
 * @copyright  2016 Andrew Nicols <andrew@nicols.co.uk>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class cache {
    /**
     * @var CACHENAME_TOUR      The name of the cache used for storing tours.
     */
    const CACHENAME_TOUR = 'tourdata';

    /**
     * @var CACHEKEY_TOUR       The name of the key used for storing tours.
     */
    const CACHEKEY_TOUR = 'tours';

    /**
     * @var CACHENAME_STEP      The name of the cache used for storing steps.
     */
    const CACHENAME_STEP = 'stepdata';

    /**
     * Fetch all enabled tours.
     */
    public static function get_enabled_tourdata() {
        global $DB;

        $cache = \cache::make('tool_usertours', self::CACHENAME_TOUR);

        $data = $cache->get(self::CACHEKEY_TOUR);
        if ($data === false) {
            $sql = <<<EOF
                SELECT t.*
                  FROM {tool_usertours_tours} t
                 WHERE t.enabled = 1
                   AND t.id IN (SELECT s.tourid FROM {tool_usertours_steps} s GROUP BY s.tourid)
              ORDER BY t.sortorder ASC
EOF;

            $data = $DB->get_records_sql($sql);
            $cache->set('tours', $data);
        }

        return $data;
    }

    /**
     * Fetch all enabled tours matching the specified target.
     *
     * @param   moodle_url  $targetmatch    The URL to match.
     */
    public static function get_matching_tourdata(\moodle_url $targetmatch) {
        $tours = self::get_enabled_tourdata();

        // Attempt to determine whether this is the front page.
        // This is a special case because the frontpage uses a shortened page path making it difficult to detect exactly.
        $isfrontpage = $targetmatch->compare(new \moodle_url('/'), URL_MATCH_BASE);
> $isdashboard = $targetmatch->compare(new \moodle_url('/my/'), URL_MATCH_BASE); $target = $targetmatch->out_as_local_url(); > $ismycourses = $targetmatch->compare(new \moodle_url('/my/courses.php'), URL_MATCH_BASE); return array_filter($tours, function($tour) use ($isfrontpage, $target) { > if ($isfrontpage && $tour->pathmatch === 'FRONTPAGE') { > $possiblematches = []; return true; > if ($isfrontpage) { } > $possiblematches = ['FRONTPAGE', 'FRONTPAGE_MY', 'FRONTPAGE_MYCOURSES', 'FRONTPAGE_MY_MYCOURSES']; $pattern = preg_quote($tour->pathmatch, '@'); > } else if ($isdashboard) { $pattern = str_replace('%', '.*', $pattern); > $possiblematches = ['MY', 'FRONTPAGE_MY', 'MY_MYCOURSES', 'FRONTPAGE_MY_MYCOURSES']; return !!preg_match("@{$pattern}@", $target); > } else if ($ismycourses) { }); > $possiblematches = ['MYCOURSES', 'FRONTPAGE_MYCOURSES', 'MY_MYCOURSES', 'FRONTPAGE_MY_MYCOURSES']; } > } >
< return array_filter($tours, function($tour) use ($isfrontpage, $target) { < if ($isfrontpage && $tour->pathmatch === 'FRONTPAGE') {
> return array_filter($tours, function($tour) use ($possiblematches, $target) { > if (in_array($tour->pathmatch, $possiblematches)) {
*/
> if (strpos($pattern, '%') !== false) { public static function notify_tour_change() { > // The URL match format is something like: /my/%. $cache = \cache::make('tool_usertours', self::CACHENAME_TOUR); > // We need to find all the URLs which match the first part of the pattern.
$cache->delete(self::CACHEKEY_TOUR);
> } else { } > // The URL match format is something like: /my/courses.php. > // We need to find all the URLs which match with whole pattern. /** > $pattern .= '$'; * Fetch the tour data for the specified tour. > }
* * @param int $tourid The ID of the tour to fetch steps for */ public static function get_stepdata($tourid) { global $DB; $cache = \cache::make('tool_usertours', self::CACHENAME_STEP); $data = $cache->get($tourid); if ($data === false) { $sql = <<<EOF SELECT s.* FROM {tool_usertours_steps} s WHERE s.tourid = :tourid ORDER BY s.sortorder ASC EOF; $data = $DB->get_records_sql($sql, ['tourid' => $tourid]); $cache->set($tourid, $data); } return $data; } /** * Notify of changes to any step to clear the step cache for that tour. * * @param int $tourid The ID of the tour to clear the step cache for */ public static function notify_step_change($tourid) { $cache = \cache::make('tool_usertours', self::CACHENAME_STEP); $cache->delete($tourid); } }