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
|
<?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\Plugins\UserCountry\LocationProvider;
use Piwik\Piwik;
use Piwik\Plugins\UserCountry\LocationProvider;
use Piwik\Url;
/**
* The disabled LocationProvider, this LocationProvider always returns an empty result set.
*
*/
class DisabledProvider extends LocationProvider
{
public const ID = 'disabled';
public const TITLE = 'General_Disabled';
/**
* Guesses a visitor's location using a visitor's browser language.
*
* @param array $info Contains 'ip' & 'lang' keys.
* @return false.
*/
public function getLocation($info)
{
return false;
}
/**
* Returns whether this location provider is available.
*
* This implementation is always available.
*
* @return bool always true
*/
public function isAvailable()
{
return true;
}
/**
* Returns whether this location provider is working correctly.
*
* This implementation is always working correctly.
*
* @return bool always true
*/
public function isWorking()
{
return true;
}
/**
* Returns an array describing the types of location information this provider will
* return.
*
* @return array
*/
public function getSupportedLocationInfo()
{
return [];
}
/**
* Returns information about this location provider. Contains an id, title & description:
*
* array(
* 'id' => 'default',
* 'title' => '...',
* 'description' => '...'
* );
*
* @return array
*/
public function getInfo()
{
$desc = Piwik::translate('UserCountry_DisabledLocationProvider');
return array('id' => self::ID, 'title' => self::TITLE, 'description' => $desc, 'order' => 0);
}
public function getUsageWarning(): ?string
{
$comment = Piwik::translate('UserCountry_DefaultLocationProviderDesc1') . ' ';
$comment .= Piwik::translate('UserCountry_DefaultLocationProviderDesc2', array(
Url::getExternalLinkTag('https://matomo.org/docs/geo-locate/'), '', '', '</a>',
));
return $comment;
}
}
|
