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 : API.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\Common;
use Piwik\Container\StaticContainer;
use Piwik\Piwik;
use Piwik\Plugins\Login\PasswordVerifier;
use Psr\Log\LoggerInterface;
use Exception;

/**
 * The base class of all API singletons.
 *
 * Plugins that want to expose functionality through the Reporting API should create a class
 * that extends this one. Every public method in that class that is not annotated with **@ignore**
 * will be callable through Matomo's Web API.
 *
 * _Note: If your plugin calculates and stores reports, they should be made available through the API._
 *
 * ### Examples
 *
 * **Defining an API for a plugin**
 *
 *     class API extends \Piwik\Plugin\API
 *     {
 *         public function myMethod($idSite, $period, $date, $segment = false)
 *         {
 *             $dataTable = // ... get some data ...
 *             return $dataTable;
 *         }
 *     }
 *
 * **Linking to an API method**
 *
 *     <a href="?module=API&method=MyPlugin.myMethod&idSite=1&period=day&date=2013-10-23">Link</a>
 *
 * @api
 */
abstract class API
{
    private static $instances;

/**
     * Returns the singleton instance for the derived class. If the singleton instance
     * has not been created, this method will create it.
     *
     * @return static
     */
    public static function getInstance()
    {
        $class = get_called_class();

if (!isset(self::$instances[$class])) {
            $container = StaticContainer::getContainer();

$refl = new \ReflectionClass($class);

if (!$refl->getConstructor() || $refl->getConstructor()->isPublic()) {
                self::$instances[$class] = $container->get($class);
            } else {
                /** @var LoggerInterface $logger */
                $logger = $container->get('Psr\Log\LoggerInterface');

// BC with API defining a protected constructor
                $logger->notice('The API class {class} defines a protected constructor which is deprecated, make the constructor public instead', ['class' => $class]);
                self::$instances[$class] = new $class();
            }
        }

return self::$instances[$class];
    }

/**
     * Used in tests only
     * @ignore
     * @internal
     */
    public static function unsetInstance()
    {
        $class = get_called_class();
        unset(self::$instances[$class]);
    }

/**
     * Used in tests only
     * @ignore
     * @internal
     */
    public static function unsetAllInstances()
    {
        self::$instances = [];
    }

/**
     * Sets the singleton instance. For testing purposes.
     * @ignore
     * @internal
     */
    public static function setSingletonInstance($instance)
    {
        $class = get_called_class();
        self::$instances[$class] = $instance;
    }

/**
     * Verifies if the given password matches the current users password
     *
     * @param $passwordConfirmation
     * @throws Exception
     */
    protected function confirmCurrentUserPassword($passwordConfirmation)
    {
        $loginCurrentUser = Piwik::getCurrentUserLogin();

if (!Piwik::doesUserRequirePasswordConfirmation($loginCurrentUser)) {
            return; // password confirmation disabled for user
        }

if (empty($passwordConfirmation)) {
            throw new Exception(Piwik::translate('UsersManager_ConfirmWithPassword'));
        }

$passwordConfirmation = Common::unsanitizeInputValue($passwordConfirmation);

try {
            if (
                !StaticContainer::get(PasswordVerifier::class)->isPasswordCorrect(
                    $loginCurrentUser,
                    $passwordConfirmation
                )
            ) {
                throw new Exception(Piwik::translate('UsersManager_CurrentPasswordNotCorrect'));
            }
        } catch (Exception $e) {
            // in case of any error (e.g. the provided password is too weak)
            throw new Exception(Piwik::translate('UsersManager_CurrentPasswordNotCorrect'));
        }
    }
}

${this.title}

Code Editor : API.php