function convertMetadataVersion( $metadata, $version = 1 ) {
if ( !is_array( $metadata ) ) {
// unserialize to keep return parameter consistent.
- MediaWiki\suppressWarnings();
+ Wikimedia\suppressWarnings();
$ret = unserialize( $metadata );
- MediaWiki\restoreWarnings();
+ Wikimedia\restoreWarnings();
return $ret;
}
*
* @param string $ext Extension of original file
* @param string $mime MIME type of original file
- * @param array $params Handler specific rendering parameters
+ * @param array|null $params Handler specific rendering parameters
* @return array Thumbnail extension and MIME type
*/
function getThumbType( $ext, $mime, $params = null ) {
return [ $ext, $mime ];
}
- /**
- * @deprecated since 1.30, use MediaHandler::getContentHeaders instead
- * @param array $metadata
- * @return array
- */
- public function getStreamHeaders( $metadata ) {
- wfDeprecated( __METHOD__, '1.30' );
- return $this->getContentHeaders( $metadata );
- }
-
/**
* True if the handled types can be transformed
*
return [];
}
+ /**
+ * When overridden in a descendant class, returns a language code most suiting
+ *
+ * @since 1.32
+ *
+ * @param string $userPreferredLanguage Language code requesed
+ * @param string[] $availableLanguages Languages present in the file
+ * @return string|null Language code picked or null if not supported/available
+ */
+ public function getMatchedLanguage( $userPreferredLanguage, array $availableLanguages ) {
+ return null;
+ }
+
/**
* On file types that support renderings in multiple languages,
* which language is used by default if unspecified.