1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
<?php
namespace Piwik\Plugins\SitesManager\Settings;
use Piwik\Piwik;
use Piwik\Plugins\SitesManager\API;
use Piwik\Plugins\SitesManager\SitesManager;
use Piwik\Settings\Interfaces\PolicyComparisonInterface;
use Piwik\Settings\Interfaces\SettingValueInterface;
use Piwik\Settings\Interfaces\Traits\PolicyComparisonTrait;
use Piwik\Policy\CnilPolicy;
use Piwik\Settings\Interfaces\OptionSettingInterface;
use Piwik\Settings\Interfaces\Traits\Getters\OptionGetterTrait;
/**
* @implements PolicyComparisonInterface<string>
* @implements SettingValueInterface<string>
*/
class FilterPIIParameters implements
OptionSettingInterface,
PolicyComparisonInterface,
SettingValueInterface
{
use OptionGetterTrait;
/** @use PolicyComparisonTrait<string> */
use PolicyComparisonTrait;
/** @var string $value */
private $value;
protected function __construct(string $value)
{
$this->value = $value;
}
public static function getTitle(): string
{
return Piwik::translate('SitesManager_FilterPIIParametersSettingTitle');
}
public static function getInstance(?int $idSite = null)
{
$values = self::getPolicyRequiredValues($idSite);
$values['option'] = self::getOptionValue($idSite) ?? '';
$strictest = self::getStrictestValueFromArray($values);
return new static($strictest);
}
public static function getInlineHelp(): string
{
return '';
}
public static function getPolicyRequirements(): array
{
return [
CnilPolicy::class => SitesManager::URL_PARAM_EXCLUSION_TYPE_NAME_MATOMO_RECOMMENDED_PII,
];
}
public static function getComplianceRequirementNote(?int $idSite = null): string
{
return Piwik::translate('SitesManager_FilterPiiParametersSettingRequirementNote');
}
public function getValue()
{
return $this->value;
}
public static function isCompliant(string $policy, ?int $idSite = null): bool
{
$policyValues = self::getPolicyRequirements();
if (!array_key_exists($policy, $policyValues)) {
return true;
}
$currentValue = self::getInstance($idSite)->getValue();
return $currentValue === $policyValues[$policy];
}
protected static function compareStrictness($value1, $value2)
{
/* strictest is simply defined as if a value equals matomo recommended PII
* there are two possible values that matter:
* - matomo_PII
* - everything else
*/
$matomoPII = SitesManager::URL_PARAM_EXCLUSION_TYPE_NAME_MATOMO_RECOMMENDED_PII;
if ($value1 === $matomoPII) {
return $value1;
} elseif ($value2 === $matomoPII) {
return $value2;
} elseif ($value1 === $value2) {
return $value1;
} else {
return $value2;
}
}
protected static function getOptionName(?int $idSite = null): string
{
return API::OPTION_EXCLUDE_TYPE_QUERY_PARAMS_GLOBAL;
}
}
|
