Gecko [ dp-client.com ]

Name	Size	Permission
Dimension	[ DIR ]	drwxr-xr-x
API.php	4.12 KB	-rw-r--r--
AggregatedMetric.php	612 B	-rw-r--r--
ArchivedMetric.php	5.58 KB	-rw-r--r--
Archiver.php	5.64 KB	-rw-r--r--
Categories.php	1.99 KB	-rw-r--r--
ComponentFactory.php	4.94 KB	-rw-r--r--
ComputedMetric.php	8.45 KB	-rw-r--r--
ConsoleCommand.php	1.43 KB	-rw-r--r--
Controller.php	41.92 KB	-rw-r--r--
ControllerAdmin.php	16.01 KB	-rw-r--r--
Dependency.php	5.98 KB	-rw-r--r--
LogTablesProvider.php	3.11 KB	-rw-r--r--
Manager.php	52.91 KB	-rw-r--r--
Menu.php	11.54 KB	-rw-r--r--
MetadataLoader.php	3.73 KB	-rw-r--r--
Metric.php	6.41 KB	-rw-r--r--
PluginException.php	1.11 KB	-rw-r--r--
ProcessedMetric.php	2.27 KB	-rw-r--r--
ReleaseChannels.php	2.55 KB	-rw-r--r--
Report.php	35.26 KB	-rw-r--r--
ReportsProvider.php	9.3 KB	-rw-r--r--
RequestProcessors.php	630 B	-rw-r--r--
Segment.php	12.75 KB	-rw-r--r--
SettingsProvider.php	7.15 KB	-rw-r--r--
Tasks.php	5.37 KB	-rw-r--r--
ThemeStyles.php	5.82 KB	-rw-r--r--
ViewDataTable.php	21.71 KB	-rw-r--r--
Visualization.php	33.17 KB	-rw-r--r--
WidgetsProvider.php	4.53 KB	-rw-r--r--

Code Editor : Tasks.php

<?php
/**
 * Matomo - free/libre analytics platform
 *
 * @link https://matomo.org
 * @license http://www.gnu.org/licenses/gpl-3.0.html GPL v3 or later
 *
 */
namespace Piwik\Plugin;

use Piwik\Development;
use Piwik\Scheduler\Schedule\Schedule;
use Piwik\Scheduler\Task;

/**
 * Base class for all Tasks declarations.
 * Tasks are usually meant as scheduled tasks that are executed regularly by Piwik in the background. For instance
 * once every hour or every day. This could be for instance checking for updates, sending email reports, etc.
 * Please don't mix up tasks with console commands which can be executed on the CLI.
 */
class Tasks
{
    /**
     * @var Task[]
     */
    private $tasks = array();

const LOWEST_PRIORITY  = Task::LOWEST_PRIORITY;
    const LOW_PRIORITY     = Task::LOW_PRIORITY;
    const NORMAL_PRIORITY  = Task::NORMAL_PRIORITY;
    const HIGH_PRIORITY    = Task::HIGH_PRIORITY;
    const HIGHEST_PRIORITY = Task::HIGHEST_PRIORITY;

/**
     * This method is called to collect all schedule tasks. Register all your tasks here that should be executed
     * regularly such as daily or monthly.
     */
    public function schedule()
    {
        // eg $this->daily('myMethodName')
    }

/**
     * @return Task[] $tasks
     */
    public function getScheduledTasks()
    {
        return $this->tasks;
    }

/**
     * Schedule the given tasks/method to run once every hour.
     *
     * @param string $methodName             The name of the method that will be called when the task is being
     *                                       executed. To make it work you need to create a public method having the
     *                                       given method name in your Tasks class.
     * @param null|string $methodParameter   Can be null if the task does not need any parameter or a string. It is not
     *                                       possible to specify multiple parameters as an array etc. If you need to
     *                                       pass multiple parameters separate them via any characters such as '###'.
     *                                       For instance '$param1###$param2###$param3'
     * @param int $priority                  Can be any constant such as self::LOW_PRIORITY
     *
     * @return Schedule
     * @api
     */
    protected function hourly($methodName, $methodParameter = null, $priority = self::NORMAL_PRIORITY)
    {
        return $this->custom($this, $methodName, $methodParameter, 'hourly', $priority);
    }

/**
     * Schedule the given tasks/method to run once every day.
     *
     * See {@link hourly()}
     * @api
     */
    protected function daily($methodName, $methodParameter = null, $priority = self::NORMAL_PRIORITY)
    {
        return $this->custom($this, $methodName, $methodParameter, 'daily', $priority);
    }

/**
     * Schedule the given tasks/method to run once every week.
     *
     * See {@link hourly()}
     * @api
     */
    protected function weekly($methodName, $methodParameter = null, $priority = self::NORMAL_PRIORITY)
    {
        return $this->custom($this, $methodName, $methodParameter, 'weekly', $priority);
    }

/**
     * Schedule the given tasks/method to run once every month.
     *
     * See {@link hourly()}
     * @api
     */
    protected function monthly($methodName, $methodParameter = null, $priority = self::NORMAL_PRIORITY)
    {
        return $this->custom($this, $methodName, $methodParameter, 'monthly', $priority);
    }

/**
     * Schedules the given tasks/method to run depending at the given scheduled time. Unlike the convenient methods
     * such as {@link hourly()} you need to specify the object on which the given method should be called. This can be
     * either an instance of a class or a class name. For more information about these parameters see {@link hourly()}
     *
     * @param string|object $objectOrClassName
     * @param string $methodName
     * @param null|string $methodParameter
     * @param string|Schedule $time
     * @param int $priority
     *
     * @return \Piwik\Scheduler\Schedule\Schedule
     *
     * @throws \Exception If a wrong time format is given. Needs to be either a string such as 'daily', 'weekly', ...
     *                    or an instance of {@link Piwik\Scheduler\Schedule\Schedule}
     *
     * @api
     */
    protected function custom($objectOrClassName, $methodName, $methodParameter, $time, $priority = self::NORMAL_PRIORITY)
    {
        $this->checkIsValidTask($objectOrClassName, $methodName);

if (is_string($time)) {
            $time = Schedule::factory($time);
        }

if (!($time instanceof Schedule)) {
            throw new \Exception('$time should be an instance of Schedule');
        }

$this->scheduleTask(new Task($objectOrClassName, $methodName, $methodParameter, $time, $priority));

return $time;
    }

/**
     * In case you need very high flexibility and none of the other convenient methods such as {@link hourly()} or
     * {@link custom()} suit you, you can use this method to add a custom scheduled task.
     *
     * @param Task $task
     */
    protected function scheduleTask(Task $task)
    {
        $this->tasks[] = $task;
    }

private function checkIsValidTask($objectOrClassName, $methodName)
    {
        Development::checkMethodIsCallable($objectOrClassName, $methodName, 'The registered task is not valid as the method');
    }
}

${this.title}

Code Editor : Tasks.php