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
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
|
<?php
/**
* Wrapper for WordPress language availability
*/
class Loco_api_WordPressTranslations {
/**
* Cache of whether network access is allowed
* @var bool
*/
private $enabled;
/**
* Cache of core locale objects
* @var Loco_Locale[]
*/
private $locales;
/**
* Cache of data returned from get_available_languages (not cached by WP)
* @var array
*/
private $installed;
/**
* Hash map of installed languages indexed by tag
* @var array
*/
private $installed_hash;
/**
* Wrap wp_get_available_translations
* @return array[]
*/
private function wp_get_available_translations(){
if( ! function_exists('wp_get_available_translations') ){
require_once ABSPATH.'wp-admin/includes/translation-install.php';
}
// WordPress will raise Warning if offline, and will cache result otherwise.
return wp_get_available_translations();
}
/**
* Get fully fledged locale objects from available core translation data
* @return Loco_Locale[]
*/
public function getAvailableCore(){
$locales = $this->locales;
if( is_null($locales) ){
$locales = [];
// get official locales from API if we have network
$cached = $this->wp_get_available_translations();
if( is_array($cached) && $cached ){
$english_name = 'english_name';
$native_name = 'native_name';
}
// else fall back to bundled data cached
else {
$english_name = 0;
$native_name = 1;
$cached = Loco_data_CompiledData::get('locales');
// debug so we can see on front end that data was offline
// $locales['en-debug'] = ( new Loco_Locale('en','','debug') )->setName('OFFLINE DATA');
}
/* @var string $tag */
foreach( $cached as $tag => $raw ){
$locale = Loco_Locale::parse($tag);
if( $locale->isValid() ){
$locale->setName( $raw[$english_name], $raw[$native_name] );
$locales[ (string) $locale ] = $locale;
}
/* Skip invalid language tags, e.g. "pt_PT_ao90" should be "pt_PT_ao1990"
* No point fixing invalid tags, because core translation files won't match.
else {
Loco_error_AdminNotices::debug( sprintf('Invalid locale: %s', $tag) );
}*/
}
$this->locales = $locales;
}
return $locales;
}
/**
* Wrap get_available_languages
* @return string[]
*/
public function getInstalledCore(){
// wp-includes/l10n.php should always be included at runtime
if( ! is_array($this->installed) ){
$this->installed = get_available_languages();
// en_US is implicitly installed
if( ! in_array('en_US',$this->installed) ){
array_unshift( $this->installed, 'en_US' );
}
}
return $this->installed;
}
/**
* @return array
*/
private function getInstalledHash(){
if( ! is_array($this->installed_hash) ){
$this->installed_hash = array_flip( $this->getInstalledCore() );
}
return $this->installed_hash;
}
/**
* Check if a given locale is installed
* @param string|Loco_Locale
* @return bool
*/
public function isInstalled( $locale ){
return array_key_exists( (string) $locale, $this->getInstalledHash() );
}
/**
* Get WordPress locale data by strictly well-formed language tag
* @param string $tag
* @return Loco_Locale
*/
public function getLocale( $tag ){
$all = $this->getAvailableCore();
return isset($all[$tag]) ? $all[$tag] : null;
}
/**
* Check whether remote API may be disabled for whatever reason, usually debugging.
* @return bool
*/
public function hasNetwork(){
if( is_null($this->enabled) ){
$this->enabled = (bool) apply_filters('loco_allow_remote', true );
}
return $this->enabled;
}
/**
* Wrapper for translations_api
* @param string
* @param array
* @return array[]
*/
public function apiGet( $type, array $args ){
if( ! function_exists('translations_api') ){
require_once ABSPATH.'wp-admin/includes/translation-install.php';
}
$response = translations_api($type,$args);
if( $response instanceof WP_Error ){
$message = 'Unknown error from translations_api';
foreach( $response->get_error_messages() as $message ){
Loco_error_AdminNotices::debug('translations_api error: '.$message);
}
throw new Loco_error_Exception($message);
}
return (array) $response;
}
}
|