MediaWiki 1.30.2

[autoinstallsdev/mediawiki.git] / extensions / LocalisationUpdate / LocalisationUpdate.class.php

diff --git a/extensions/LocalisationUpdate/LocalisationUpdate.class.php b/extensions/LocalisationUpdate/LocalisationUpdate.class.php
new file mode 100644 (file)
index 0000000..af020db
--- /dev/null
+++ b/extensions/LocalisationUpdate/LocalisationUpdate.class.php
@@ -0,0 +1,65 @@
+<?php
+
+/**
+ * Class for localization update hooks and static methods.
+ */
+class LocalisationUpdate {
+       /**
+        * Hook: LocalisationCacheRecacheFallback
+        */
+       public static function onRecacheFallback( LocalisationCache $lc, $code, array &$cache ) {
+               $dir = self::getDirectory();
+               if ( !$dir ) {
+                       return true;
+               }
+
+               $fileName = "$dir/" . self::getFilename( $code );
+               if ( is_readable( $fileName ) ) {
+                       $data = FormatJson::decode( file_get_contents( $fileName ), true );
+                       $cache['messages'] = array_merge( $cache['messages'], $data );
+               }
+
+               return true;
+       }
+
+       /**
+        * Hook: LocalisationCacheRecache
+        */
+       public static function onRecache( LocalisationCache $lc, $code, array &$cache ) {
+               $dir = self::getDirectory();
+               if ( !$dir ) {
+                       return true;
+               }
+
+               $codeSequence = array_merge( [ $code ], $cache['fallbackSequence'] );
+               foreach ( $codeSequence as $csCode ) {
+                       $fileName = "$dir/" . self::getFilename( $csCode );
+                       $cache['deps'][] = new FileDependency( $fileName );
+               }
+
+               return true;
+       }
+
+       /**
+        * Returns a directory where updated translations are stored.
+        *
+        * @return string|false False if not configured.
+        * @since 1.1
+        */
+       public static function getDirectory() {
+               global $wgLocalisationUpdateDirectory, $wgCacheDirectory;
+
+               return $wgLocalisationUpdateDirectory ?: $wgCacheDirectory;
+       }
+
+       /**
+        * Returns a filename where updated translations are stored.
+        *
+        * @param string $language Language tag
+        * @return string
+        * @since 1.1
+        */
+       public static function getFilename( $language ) {
+               return "l10nupdate-$language.json";
+       }
+}