skins: Deprecate QuickTemplate::setTranslator and MediaWikiI18N::set
[lhc/web/wiklou.git] / includes / skins / MediaWikiI18N.php
1 <?php
2 /**
3 * This program is free software; you can redistribute it and/or modify
4 * it under the terms of the GNU General Public License as published by
5 * the Free Software Foundation; either version 2 of the License, or
6 * (at your option) any later version.
7 *
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * GNU General Public License for more details.
12 *
13 * You should have received a copy of the GNU General Public License along
14 * with this program; if not, write to the Free Software Foundation, Inc.,
15 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
16 * http://www.gnu.org/copyleft/gpl.html
17 *
18 * @file
19 */
20
21 /**
22 * Wrapper object for MediaWiki's localization functions,
23 * to be passed to the template engine.
24 *
25 * @private
26 * @ingroup Skins
27 */
28 class MediaWikiI18N {
29 private $context = [];
30
31 /**
32 * @deprecate since 1.31 Use BaseTemplate::msg() or Skin::msg() instead for setting
33 * message parameters.
34 */
35 function set( $varName, $value ) {
36 wfDeprecated( __METHOD__, '1.31' );
37 $this->context[$varName] = $value;
38 }
39
40 function translate( $value ) {
41 // Hack for i18n:attributes in PHPTAL 1.0.0 dev version as of 2004-10-23
42 $value = preg_replace( '/^string:/', '', $value );
43
44 $value = wfMessage( $value )->text();
45 // interpolate variables
46 $m = [];
47 while ( preg_match( '/\$([0-9]*?)/sm', $value, $m ) ) {
48 list( $src, $var ) = $m;
49 MediaWiki\suppressWarnings();
50 $varValue = $this->context[$var];
51 MediaWiki\restoreWarnings();
52 $value = str_replace( $src, $varValue, $value );
53 }
54 return $value;
55 }
56 }