<?php

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

use Piwik\Piwik;
use Piwik\Plugin\Manager;
use Piwik\Settings\FieldConfig;
use Piwik\Settings\Interfaces\ConfigSettingInterface;
use Piwik\Settings\Interfaces\MeasurableSettingInterface;
use Piwik\Settings\Interfaces\SystemSettingInterface;
use Piwik\Settings\Interfaces\Traits\Getters\ConfigGetterTrait;
use Piwik\Settings\Interfaces\Traits\Setters\MeasurableSetterTrait;
use Piwik\Settings\Interfaces\Traits\Setters\SystemSetterTrait;
/**
 * @implements SystemSettingInterface<bool>
 * @implements MeasurableSettingInterface<bool>
 */
abstract class CompliancePolicy implements SystemSettingInterface, MeasurableSettingInterface, ConfigSettingInterface
{
    /**
     * @use SystemSetterTrait<bool>
     */
    use SystemSetterTrait;
    /**
     * @use MeasurableSetterTrait<bool>
     */
    use MeasurableSetterTrait;
    /**
     * @use ConfigGetterTrait<bool>
     */
    use ConfigGetterTrait;
    public static abstract function getName() : string;
    public static abstract function getTitle() : string;
    protected static abstract function generateDescription() : string;
    protected static abstract function generateWarnings() : string;
    public static function getDescription() : string
    {
        $description = static::generateDescription();
        /**
         * This event is triggered while the description of a compliance policy is
         * being generated. The policy description can be modified via this event.
         *
         * @param string &$description of the policy.
         */
        Piwik::postEvent('CompliancePolicy.updatePolicyDescription', [&$description, static::class]);
        $shouldShowWarnings = \true;
        /**
         * This event is triggered while the description of a compliance policy is
         * being generated, and controls whether any warnings specific to the policy
         * are displayed at the end of the description.
         *
         * @param bool &$shouldShowWarnings set to false if the warnings should be hidden
         */
        Piwik::postEvent('CompliancePolicy.shouldShowWarnings', [&$shouldShowWarnings, static::class]);
        if ($shouldShowWarnings) {
            $warnings = static::generateWarnings();
            if (!empty($warnings)) {
                $description .= '<br/>' . static::generateWarnings();
            }
        }
        return $description;
    }
    /**
     * @return array<array<string>> of [['title' => (string) 'TITLE', 'note' => (string) 'NOTE']]
     */
    public static abstract function getUnknownSettings() : array;
    /**
     * @return array<string, string>
     */
    public static function getDetails() : array
    {
        return ['id' => static::getName(), 'title' => static::getTitle(), 'description' => static::getDescription()];
    }
    protected static function getPluginManagerInstance() : Manager
    {
        return Manager::getInstance();
    }
    protected static function getSystemDefaultValue()
    {
        return \false;
    }
    protected static function getSystemName() : string
    {
        return preg_replace('/\\s+/', '', static::getName()) . '_policy_enabled';
    }
    protected static function getSystemType() : string
    {
        return FieldConfig::TYPE_BOOL;
    }
    protected static function getMeasurableDefaultValue()
    {
        return \false;
    }
    protected static function getMeasurableName() : string
    {
        return preg_replace('/\\s+/', '', static::getName()) . '_policy_enabled';
    }
    protected static function getMeasurableType() : string
    {
        return FieldConfig::TYPE_BOOL;
    }
    protected static function getConfigSection() : string
    {
        return Piwik::getPluginNameOfMatomoClass(static::class);
    }
    protected static function getConfigSettingName() : string
    {
        return static::getSystemName();
    }
    /**
     * If the policy is active at the instance level,
     * disabling the policy for a site will also disable it
     * for the instance.
     */
    public static function setActiveStatus(?int $idSite, bool $isActive) : void
    {
        if (isset($idSite)) {
            static::setMeasurableValue($idSite, $isActive);
            if (static::getSystemValue() && !$isActive) {
                static::setSystemValue($isActive);
            }
        } else {
            static::setSystemValue($isActive);
        }
        /**
         * This event is triggered when the status of a compliance policy changes, and
         * is to be used to perform extra actions when a policy is activated/deactivated.
         *
         * The status of a policy cannot be changed via this event.
         *
         * @param bool $isActive Whether the policy is being activated or deactivated
         * @param int|null $idSite
         * @param class-string<CompliancePolicy> The compliance policy in question
         */
        Piwik::postEvent('CompliancePolicy.setActiveStatus', [$isActive, $idSite, static::class]);
    }
    /**
     * If the policy is active at the instance level, then
     * this function will return true for all sites.
     */
    public static function isActive(?int $idSite) : bool
    {
        $instanceLevel = static::getSystemValue();
        if (!$instanceLevel && isset($idSite)) {
            return static::getMeasurableValue($idSite);
        }
        return $instanceLevel;
    }
    public static function isConfigControlled()
    {
        return !is_null(static::getConfigValue());
    }
}