From: Amir Sarabadani <ladsgroup@gmail.com>
Date: Sat, 27 May 2017 13:07:13 +0000 (+0200)
Subject: Introduce MessageLocalizer interface for exposing msg() method
X-Git-Tag: 1.31.0-rc.0~2980^2
X-Git-Url: http://git.cyclocoop.org/%24self?a=commitdiff_plain;h=e93155cf60923f852eb315350be20a29681a9d08;p=lhc%2Fweb%2Fwiklou.git

Introduce MessageLocalizer interface for exposing msg() method

Bug: T162594
Change-Id: I2d9af9fc05264bffda675af46f656038cd72d0db
---

diff --git a/autoload.php b/autoload.php
index 0264435761..bfe1cd5691 100644
--- a/autoload.php
+++ b/autoload.php
@@ -979,6 +979,7 @@ $wgAutoloadLocalClasses = [
 	'MessageBlobStore' => __DIR__ . '/includes/cache/MessageBlobStore.php',
 	'MessageCache' => __DIR__ . '/includes/cache/MessageCache.php',
 	'MessageContent' => __DIR__ . '/includes/content/MessageContent.php',
+	'MessageLocalizer' => __DIR__ . '/languages/MessageLocalizer.php',
 	'MessageSpecifier' => __DIR__ . '/includes/libs/MessageSpecifier.php',
 	'MigrateFileRepoLayout' => __DIR__ . '/maintenance/migrateFileRepoLayout.php',
 	'MigrateUserGroup' => __DIR__ . '/maintenance/migrateUserGroup.php',
diff --git a/languages/MessageLocalizer.php b/languages/MessageLocalizer.php
new file mode 100644
index 0000000000..9a1796b140
--- /dev/null
+++ b/languages/MessageLocalizer.php
@@ -0,0 +1,43 @@
+<?php
+/**
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ * http://www.gnu.org/copyleft/gpl.html
+ *
+ * @file
+ * @ingroup Language
+ */
+
+/**
+ * Interface for localizing messages in MediaWiki
+ *
+ * @since 1.30
+ * @ingroup Language
+ */
+interface MessageLocalizer {
+
+	/**
+	 * This is the method for getting translated interface messages.
+	 *
+	 * @see https://www.mediawiki.org/wiki/Manual:Messages_API
+	 * @see Message::__construct
+	 *
+	 * @param string|string[]|MessageSpecifier $key Message key, or array of keys,
+	 *   or a MessageSpecifier.
+	 * @param mixed $params,... Normal message parameters
+	 * @return Message
+	 */
+	public function msg( $key /*...*/ );
+
+}