blob: 84c46f38da2b7e8705ba16f153000ba2d1fd8a9a (
plain)
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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
|
<?php
/**
* Piwik - free/libre analytics platform
*
* @link https://matomo.org
* @license http://www.gnu.org/licenses/gpl-3.0.html GPL v3 or later
*
*/
namespace Piwik;
use Exception;
use Piwik\Container\StaticContainer;
use Piwik\Plugin\Manager;
use Piwik\Translation\Translator;
/**
* @deprecated Use Piwik\Translation\Translator instead.
* @see \Piwik\Translation\Translator
*/
class Translate
{
/**
* Clean a string that may contain HTML special chars, single/double quotes, HTML entities, leading/trailing whitespace
*
* @param string $s
* @return string
*/
public static function clean($s)
{
self::triggerDeprecationNotice();
return self::getTranslator()->clean($s);
}
/**
* @deprecated
*/
public static function loadEnglishTranslation()
{
self::loadAllTranslations();
}
/**
* @deprecated
*/
public static function unloadEnglishTranslation()
{
self::reset();
}
/**
* @deprecated
*/
public static function reloadLanguage($language = false)
{
self::triggerDeprecationNotice();
}
/**
* Reads the specified code translation file in memory.
*
* @param bool|string $language 2 letter language code. If not specified, will detect current user translation, or load default translation.
* @return void
*/
public static function loadCoreTranslation($language = false)
{
self::triggerDeprecationNotice();
self::getTranslator()->addDirectory(PIWIK_INCLUDE_PATH . '/lang');
}
/**
* @deprecated
*/
public static function mergeTranslationArray($translation)
{
self::triggerDeprecationNotice();
}
/**
* @return string the language filename prefix, eg 'en' for english
* @throws exception if the language set is not a valid filename
*/
public static function getLanguageToLoad()
{
self::triggerDeprecationNotice();
return self::getTranslator()->getCurrentLanguage();
}
/** Reset the cached language to load. Used in tests. */
public static function reset()
{
self::triggerDeprecationNotice();
self::getTranslator()->reset();
}
/**
* Either the name of the currently loaded language such as 'en' or 'de' or null if no language is loaded at all.
* @return bool|string
*/
public static function getLanguageLoaded()
{
self::triggerDeprecationNotice();
return self::getTranslator()->getCurrentLanguage();
}
public static function getLanguageDefault()
{
self::triggerDeprecationNotice();
return self::getTranslator()->getDefaultLanguage();
}
/**
* Generate javascript translations array
*/
public static function getJavascriptTranslations()
{
self::triggerDeprecationNotice();
return self::getTranslator()->getJavascriptTranslations();
}
public static function findTranslationKeyForTranslation($translation)
{
self::triggerDeprecationNotice();
return self::getTranslator()->findTranslationKeyForTranslation($translation);
}
/**
* @return Translator
*/
private static function getTranslator()
{
return StaticContainer::get('Piwik\Translation\Translator');
}
public static function loadAllTranslations()
{
self::triggerDeprecationNotice();
self::loadCoreTranslation();
Manager::getInstance()->loadPluginTranslations();
}
protected static function triggerDeprecationNotice()
{
if (Development::isEnabled()) {
Log::warning('Using \Piwik\Translate is deprecated. Use \Piwik\Translation\Translator instead.');
}
}
}
|
