diff options
Diffstat (limited to 'www/wiki/includes/api/ApiQueryImageInfo.php')
-rw-r--r-- | www/wiki/includes/api/ApiQueryImageInfo.php | 826 |
1 files changed, 826 insertions, 0 deletions
diff --git a/www/wiki/includes/api/ApiQueryImageInfo.php b/www/wiki/includes/api/ApiQueryImageInfo.php new file mode 100644 index 00000000..e447f4f4 --- /dev/null +++ b/www/wiki/includes/api/ApiQueryImageInfo.php @@ -0,0 +1,826 @@ +<?php +/** + * Copyright © 2006 Yuri Astrakhan "<Firstname><Lastname>@gmail.com" + * + * 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 + */ + +/** + * A query action to get image information and upload history. + * + * @ingroup API + */ +class ApiQueryImageInfo extends ApiQueryBase { + const TRANSFORM_LIMIT = 50; + private static $transformCount = 0; + + public function __construct( ApiQuery $query, $moduleName, $prefix = 'ii' ) { + // We allow a subclass to override the prefix, to create a related API + // module. Some other parts of MediaWiki construct this with a null + // $prefix, which used to be ignored when this only took two arguments + if ( is_null( $prefix ) ) { + $prefix = 'ii'; + } + parent::__construct( $query, $moduleName, $prefix ); + } + + public function execute() { + $params = $this->extractRequestParams(); + + $prop = array_flip( $params['prop'] ); + + $scale = $this->getScale( $params ); + + $opts = [ + 'version' => $params['metadataversion'], + 'language' => $params['extmetadatalanguage'], + 'multilang' => $params['extmetadatamultilang'], + 'extmetadatafilter' => $params['extmetadatafilter'], + 'revdelUser' => $this->getUser(), + ]; + + if ( isset( $params['badfilecontexttitle'] ) ) { + $badFileContextTitle = Title::newFromText( $params['badfilecontexttitle'] ); + if ( !$badFileContextTitle ) { + $this->dieUsage( 'Invalid title in badfilecontexttitle parameter', 'invalid-title' ); + } + } else { + $badFileContextTitle = false; + } + + $pageIds = $this->getPageSet()->getGoodAndMissingTitlesByNamespace(); + if ( !empty( $pageIds[NS_FILE] ) ) { + $titles = array_keys( $pageIds[NS_FILE] ); + asort( $titles ); // Ensure the order is always the same + + $fromTitle = null; + if ( !is_null( $params['continue'] ) ) { + $cont = explode( '|', $params['continue'] ); + $this->dieContinueUsageIf( count( $cont ) != 2 ); + $fromTitle = strval( $cont[0] ); + $fromTimestamp = $cont[1]; + // Filter out any titles before $fromTitle + foreach ( $titles as $key => $title ) { + if ( $title < $fromTitle ) { + unset( $titles[$key] ); + } else { + break; + } + } + } + + $user = $this->getUser(); + $findTitles = array_map( function ( $title ) use ( $user ) { + return [ + 'title' => $title, + 'private' => $user, + ]; + }, $titles ); + + if ( $params['localonly'] ) { + $images = RepoGroup::singleton()->getLocalRepo()->findFiles( $findTitles ); + } else { + $images = RepoGroup::singleton()->findFiles( $findTitles ); + } + + $result = $this->getResult(); + foreach ( $titles as $title ) { + $info = []; + $pageId = $pageIds[NS_FILE][$title]; + $start = $title === $fromTitle ? $fromTimestamp : $params['start']; + + if ( !isset( $images[$title] ) ) { + if ( isset( $prop['uploadwarning'] ) || isset( $prop['badfile'] ) ) { + // uploadwarning and badfile need info about non-existing files + $images[$title] = wfLocalFile( $title ); + // Doesn't exist, so set an empty image repository + $info['imagerepository'] = ''; + } else { + $result->addValue( + [ 'query', 'pages', intval( $pageId ) ], + 'imagerepository', '' + ); + // The above can't fail because it doesn't increase the result size + continue; + } + } + + /** @var File $img */ + $img = $images[$title]; + + if ( self::getTransformCount() >= self::TRANSFORM_LIMIT ) { + if ( count( $pageIds[NS_FILE] ) == 1 ) { + // See the 'the user is screwed' comment below + $this->setContinueEnumParameter( 'start', + $start !== null ? $start : wfTimestamp( TS_ISO_8601, $img->getTimestamp() ) + ); + } else { + $this->setContinueEnumParameter( 'continue', + $this->getContinueStr( $img, $start ) ); + } + break; + } + + if ( !isset( $info['imagerepository'] ) ) { + $info['imagerepository'] = $img->getRepoName(); + } + if ( isset( $prop['badfile'] ) ) { + $info['badfile'] = (bool)wfIsBadImage( $title, $badFileContextTitle ); + } + + $fit = $result->addValue( [ 'query', 'pages' ], intval( $pageId ), $info ); + if ( !$fit ) { + if ( count( $pageIds[NS_FILE] ) == 1 ) { + // The user is screwed. imageinfo can't be solely + // responsible for exceeding the limit in this case, + // so set a query-continue that just returns the same + // thing again. When the violating queries have been + // out-continued, the result will get through + $this->setContinueEnumParameter( 'start', + $start !== null ? $start : wfTimestamp( TS_ISO_8601, $img->getTimestamp() ) + ); + } else { + $this->setContinueEnumParameter( 'continue', + $this->getContinueStr( $img, $start ) ); + } + break; + } + + // Check if we can make the requested thumbnail, and get transform parameters. + $finalThumbParams = $this->mergeThumbParams( $img, $scale, $params['urlparam'] ); + + // Get information about the current version first + // Check that the current version is within the start-end boundaries + $gotOne = false; + if ( + ( is_null( $start ) || $img->getTimestamp() <= $start ) && + ( is_null( $params['end'] ) || $img->getTimestamp() >= $params['end'] ) + ) { + $gotOne = true; + + $fit = $this->addPageSubItem( $pageId, + static::getInfo( $img, $prop, $result, + $finalThumbParams, $opts + ) + ); + if ( !$fit ) { + if ( count( $pageIds[NS_FILE] ) == 1 ) { + // See the 'the user is screwed' comment above + $this->setContinueEnumParameter( 'start', + wfTimestamp( TS_ISO_8601, $img->getTimestamp() ) ); + } else { + $this->setContinueEnumParameter( 'continue', + $this->getContinueStr( $img ) ); + } + break; + } + } + + // Now get the old revisions + // Get one more to facilitate query-continue functionality + $count = ( $gotOne ? 1 : 0 ); + $oldies = $img->getHistory( $params['limit'] - $count + 1, $start, $params['end'] ); + /** @var File $oldie */ + foreach ( $oldies as $oldie ) { + if ( ++$count > $params['limit'] ) { + // We've reached the extra one which shows that there are + // additional pages to be had. Stop here... + // Only set a query-continue if there was only one title + if ( count( $pageIds[NS_FILE] ) == 1 ) { + $this->setContinueEnumParameter( 'start', + wfTimestamp( TS_ISO_8601, $oldie->getTimestamp() ) ); + } + break; + } + $fit = self::getTransformCount() < self::TRANSFORM_LIMIT && + $this->addPageSubItem( $pageId, + static::getInfo( $oldie, $prop, $result, + $finalThumbParams, $opts + ) + ); + if ( !$fit ) { + if ( count( $pageIds[NS_FILE] ) == 1 ) { + $this->setContinueEnumParameter( 'start', + wfTimestamp( TS_ISO_8601, $oldie->getTimestamp() ) ); + } else { + $this->setContinueEnumParameter( 'continue', + $this->getContinueStr( $oldie ) ); + } + break; + } + } + if ( !$fit ) { + break; + } + } + } + } + + /** + * From parameters, construct a 'scale' array + * @param array $params Parameters passed to api. + * @return array|null Key-val array of 'width' and 'height', or null + */ + public function getScale( $params ) { + if ( $params['urlwidth'] != -1 ) { + $scale = []; + $scale['width'] = $params['urlwidth']; + $scale['height'] = $params['urlheight']; + } elseif ( $params['urlheight'] != -1 ) { + // Height is specified but width isn't + // Don't set $scale['width']; this signals mergeThumbParams() to fill it with the image's width + $scale = []; + $scale['height'] = $params['urlheight']; + } else { + if ( $params['urlparam'] ) { + // Audio files might not have a width/height. + $scale = []; + } else { + $scale = null; + } + } + + return $scale; + } + + /** Validate and merge scale parameters with handler thumb parameters, give error if invalid. + * + * We do this later than getScale, since we need the image + * to know which handler, since handlers can make their own parameters. + * @param File $image Image that params are for. + * @param array $thumbParams Thumbnail parameters from getScale + * @param string $otherParams String of otherParams (iiurlparam). + * @return array Array of parameters for transform. + */ + protected function mergeThumbParams( $image, $thumbParams, $otherParams ) { + if ( $thumbParams === null ) { + // No scaling requested + return null; + } + if ( !isset( $thumbParams['width'] ) && isset( $thumbParams['height'] ) ) { + // We want to limit only by height in this situation, so pass the + // image's full width as the limiting width. But some file types + // don't have a width of their own, so pick something arbitrary so + // thumbnailing the default icon works. + if ( $image->getWidth() <= 0 ) { + $thumbParams['width'] = max( $this->getConfig()->get( 'ThumbLimits' ) ); + } else { + $thumbParams['width'] = $image->getWidth(); + } + } + + if ( !$otherParams ) { + $this->checkParameterNormalise( $image, $thumbParams ); + return $thumbParams; + } + $p = $this->getModulePrefix(); + + $h = $image->getHandler(); + if ( !$h ) { + $this->addWarning( [ 'apiwarn-nothumb-noimagehandler', wfEscapeWikiText( $image->getName() ) ] ); + + return $thumbParams; + } + + $paramList = $h->parseParamString( $otherParams ); + if ( !$paramList ) { + // Just set a warning (instead of dieUsage), as in many cases + // we could still render the image using width and height parameters, + // and this type of thing could happen between different versions of + // handlers. + $this->addWarning( [ 'apiwarn-badurlparam', $p, wfEscapeWikiText( $image->getName() ) ] ); + $this->checkParameterNormalise( $image, $thumbParams ); + return $thumbParams; + } + + if ( isset( $paramList['width'] ) && isset( $thumbParams['width'] ) ) { + if ( intval( $paramList['width'] ) != intval( $thumbParams['width'] ) ) { + $this->addWarning( + [ 'apiwarn-urlparamwidth', $p, $paramList['width'], $thumbParams['width'] ] + ); + } + } + + foreach ( $paramList as $name => $value ) { + if ( !$h->validateParam( $name, $value ) ) { + $this->dieWithError( + [ 'apierror-invalidurlparam', $p, wfEscapeWikiText( $name ), wfEscapeWikiText( $value ) ] + ); + } + } + + $finalParams = $thumbParams + $paramList; + $this->checkParameterNormalise( $image, $finalParams ); + return $finalParams; + } + + /** + * Verify that the final image parameters can be normalised. + * + * This doesn't use the normalised parameters, since $file->transform + * expects the pre-normalised parameters, but doing the normalisation + * allows us to catch certain error conditions early (such as missing + * required parameter). + * + * @param File $image + * @param array $finalParams List of parameters to transform image with + */ + protected function checkParameterNormalise( $image, $finalParams ) { + $h = $image->getHandler(); + if ( !$h ) { + return; + } + // Note: normaliseParams modifies the array in place, but we aren't interested + // in the actual normalised version, only if we can actually normalise them, + // so we use the functions scope to throw away the normalisations. + if ( !$h->normaliseParams( $image, $finalParams ) ) { + $this->dieWithError( [ 'apierror-urlparamnormal', wfEscapeWikiText( $image->getName() ) ] ); + } + } + + /** + * Get result information for an image revision + * + * @param File $file + * @param array $prop Array of properties to get (in the keys) + * @param ApiResult $result + * @param array $thumbParams Containing 'width' and 'height' items, or null + * @param array|bool|string $opts Options for data fetching. + * This is an array consisting of the keys: + * 'version': The metadata version for the metadata option + * 'language': The language for extmetadata property + * 'multilang': Return all translations in extmetadata property + * 'revdelUser': User to use when checking whether to show revision-deleted fields. + * @return array Result array + */ + public static function getInfo( $file, $prop, $result, $thumbParams = null, $opts = false ) { + global $wgContLang; + + $anyHidden = false; + + if ( !$opts || is_string( $opts ) ) { + $opts = [ + 'version' => $opts ?: 'latest', + 'language' => $wgContLang, + 'multilang' => false, + 'extmetadatafilter' => [], + 'revdelUser' => null, + ]; + } + $version = $opts['version']; + $vals = [ + ApiResult::META_TYPE => 'assoc', + ]; + // Timestamp is shown even if the file is revdelete'd in interface + // so do same here. + if ( isset( $prop['timestamp'] ) ) { + $vals['timestamp'] = wfTimestamp( TS_ISO_8601, $file->getTimestamp() ); + } + + // Handle external callers who don't pass revdelUser + if ( isset( $opts['revdelUser'] ) && $opts['revdelUser'] ) { + $revdelUser = $opts['revdelUser']; + $canShowField = function ( $field ) use ( $file, $revdelUser ) { + return $file->userCan( $field, $revdelUser ); + }; + } else { + $canShowField = function ( $field ) use ( $file ) { + return !$file->isDeleted( $field ); + }; + } + + $user = isset( $prop['user'] ); + $userid = isset( $prop['userid'] ); + + if ( $user || $userid ) { + if ( $file->isDeleted( File::DELETED_USER ) ) { + $vals['userhidden'] = true; + $anyHidden = true; + } + if ( $canShowField( File::DELETED_USER ) ) { + if ( $user ) { + $vals['user'] = $file->getUser(); + } + if ( $userid ) { + $vals['userid'] = $file->getUser( 'id' ); + } + if ( !$file->getUser( 'id' ) ) { + $vals['anon'] = true; + } + } + } + + // This is shown even if the file is revdelete'd in interface + // so do same here. + if ( isset( $prop['size'] ) || isset( $prop['dimensions'] ) ) { + $vals['size'] = intval( $file->getSize() ); + $vals['width'] = intval( $file->getWidth() ); + $vals['height'] = intval( $file->getHeight() ); + + $pageCount = $file->pageCount(); + if ( $pageCount !== false ) { + $vals['pagecount'] = $pageCount; + } + + // length as in how many seconds long a video is. + $length = $file->getLength(); + if ( $length ) { + // Call it duration, because "length" can be ambiguous. + $vals['duration'] = (float)$length; + } + } + + $pcomment = isset( $prop['parsedcomment'] ); + $comment = isset( $prop['comment'] ); + + if ( $pcomment || $comment ) { + if ( $file->isDeleted( File::DELETED_COMMENT ) ) { + $vals['commenthidden'] = true; + $anyHidden = true; + } + if ( $canShowField( File::DELETED_COMMENT ) ) { + if ( $pcomment ) { + $vals['parsedcomment'] = Linker::formatComment( + $file->getDescription( File::RAW ), $file->getTitle() ); + } + if ( $comment ) { + $vals['comment'] = $file->getDescription( File::RAW ); + } + } + } + + $canonicaltitle = isset( $prop['canonicaltitle'] ); + $url = isset( $prop['url'] ); + $sha1 = isset( $prop['sha1'] ); + $meta = isset( $prop['metadata'] ); + $extmetadata = isset( $prop['extmetadata'] ); + $commonmeta = isset( $prop['commonmetadata'] ); + $mime = isset( $prop['mime'] ); + $mediatype = isset( $prop['mediatype'] ); + $archive = isset( $prop['archivename'] ); + $bitdepth = isset( $prop['bitdepth'] ); + $uploadwarning = isset( $prop['uploadwarning'] ); + + if ( $uploadwarning ) { + $vals['html'] = SpecialUpload::getExistsWarning( UploadBase::getExistsWarning( $file ) ); + } + + if ( $file->isDeleted( File::DELETED_FILE ) ) { + $vals['filehidden'] = true; + $anyHidden = true; + } + + if ( $anyHidden && $file->isDeleted( File::DELETED_RESTRICTED ) ) { + $vals['suppressed'] = true; + } + + if ( !$canShowField( File::DELETED_FILE ) ) { + // Early return, tidier than indenting all following things one level + return $vals; + } + + if ( $canonicaltitle ) { + $vals['canonicaltitle'] = $file->getTitle()->getPrefixedText(); + } + + if ( $url ) { + if ( $file->exists() ) { + if ( !is_null( $thumbParams ) ) { + $mto = $file->transform( $thumbParams ); + self::$transformCount++; + if ( $mto && !$mto->isError() ) { + $vals['thumburl'] = wfExpandUrl( $mto->getUrl(), PROTO_CURRENT ); + + // T25834 - If the URLs are the same, we haven't resized it, so shouldn't give the wanted + // thumbnail sizes for the thumbnail actual size + if ( $mto->getUrl() !== $file->getUrl() ) { + $vals['thumbwidth'] = intval( $mto->getWidth() ); + $vals['thumbheight'] = intval( $mto->getHeight() ); + } else { + $vals['thumbwidth'] = intval( $file->getWidth() ); + $vals['thumbheight'] = intval( $file->getHeight() ); + } + + if ( isset( $prop['thumbmime'] ) && $file->getHandler() ) { + list( , $mime ) = $file->getHandler()->getThumbType( + $mto->getExtension(), $file->getMimeType(), $thumbParams ); + $vals['thumbmime'] = $mime; + } + } elseif ( $mto && $mto->isError() ) { + $vals['thumberror'] = $mto->toText(); + } + } + $vals['url'] = wfExpandUrl( $file->getFullUrl(), PROTO_CURRENT ); + } else { + $vals['filemissing'] = true; + } + $vals['descriptionurl'] = wfExpandUrl( $file->getDescriptionUrl(), PROTO_CURRENT ); + + $shortDescriptionUrl = $file->getDescriptionShortUrl(); + if ( $shortDescriptionUrl !== null ) { + $vals['descriptionshorturl'] = wfExpandUrl( $shortDescriptionUrl, PROTO_CURRENT ); + } + } + + if ( $sha1 ) { + $vals['sha1'] = Wikimedia\base_convert( $file->getSha1(), 36, 16, 40 ); + } + + if ( $meta ) { + Wikimedia\suppressWarnings(); + $metadata = unserialize( $file->getMetadata() ); + Wikimedia\restoreWarnings(); + if ( $metadata && $version !== 'latest' ) { + $metadata = $file->convertMetadataVersion( $metadata, $version ); + } + $vals['metadata'] = $metadata ? static::processMetaData( $metadata, $result ) : null; + } + if ( $commonmeta ) { + $metaArray = $file->getCommonMetaArray(); + $vals['commonmetadata'] = $metaArray ? static::processMetaData( $metaArray, $result ) : []; + } + + if ( $extmetadata ) { + // Note, this should return an array where all the keys + // start with a letter, and all the values are strings. + // Thus there should be no issue with format=xml. + $format = new FormatMetadata; + $format->setSingleLanguage( !$opts['multilang'] ); + $format->getContext()->setLanguage( $opts['language'] ); + $extmetaArray = $format->fetchExtendedMetadata( $file ); + if ( $opts['extmetadatafilter'] ) { + $extmetaArray = array_intersect_key( + $extmetaArray, array_flip( $opts['extmetadatafilter'] ) + ); + } + $vals['extmetadata'] = $extmetaArray; + } + + if ( $mime ) { + $vals['mime'] = $file->getMimeType(); + } + + if ( $mediatype ) { + $vals['mediatype'] = $file->getMediaType(); + } + + if ( $archive && $file->isOld() ) { + $vals['archivename'] = $file->getArchiveName(); + } + + if ( $bitdepth ) { + $vals['bitdepth'] = $file->getBitDepth(); + } + + return $vals; + } + + /** + * Get the count of image transformations performed + * + * If this is >= TRANSFORM_LIMIT, you should probably stop processing images. + * + * @return int Count + */ + static function getTransformCount() { + return self::$transformCount; + } + + /** + * + * @param array $metadata + * @param ApiResult $result + * @return array + */ + public static function processMetaData( $metadata, $result ) { + $retval = []; + if ( is_array( $metadata ) ) { + foreach ( $metadata as $key => $value ) { + $r = [ + 'name' => $key, + ApiResult::META_BC_BOOLS => [ 'value' ], + ]; + if ( is_array( $value ) ) { + $r['value'] = static::processMetaData( $value, $result ); + } else { + $r['value'] = $value; + } + $retval[] = $r; + } + } + ApiResult::setIndexedTagName( $retval, 'metadata' ); + + return $retval; + } + + public function getCacheMode( $params ) { + if ( $this->userCanSeeRevDel() ) { + return 'private'; + } + + return 'public'; + } + + /** + * @param File $img + * @param null|string $start + * @return string + */ + protected function getContinueStr( $img, $start = null ) { + if ( $start === null ) { + $start = $img->getTimestamp(); + } + + return $img->getOriginalTitle()->getDBkey() . '|' . $start; + } + + public function getAllowedParams() { + global $wgContLang; + + return [ + 'prop' => [ + ApiBase::PARAM_ISMULTI => true, + ApiBase::PARAM_DFLT => 'timestamp|user', + ApiBase::PARAM_TYPE => static::getPropertyNames(), + ApiBase::PARAM_HELP_MSG_PER_VALUE => static::getPropertyMessages(), + ], + 'limit' => [ + ApiBase::PARAM_TYPE => 'limit', + ApiBase::PARAM_DFLT => 1, + ApiBase::PARAM_MIN => 1, + ApiBase::PARAM_MAX => ApiBase::LIMIT_BIG1, + ApiBase::PARAM_MAX2 => ApiBase::LIMIT_BIG2 + ], + 'start' => [ + ApiBase::PARAM_TYPE => 'timestamp' + ], + 'end' => [ + ApiBase::PARAM_TYPE => 'timestamp' + ], + 'urlwidth' => [ + ApiBase::PARAM_TYPE => 'integer', + ApiBase::PARAM_DFLT => -1, + ApiBase::PARAM_HELP_MSG => [ + 'apihelp-query+imageinfo-param-urlwidth', + self::TRANSFORM_LIMIT, + ], + ], + 'urlheight' => [ + ApiBase::PARAM_TYPE => 'integer', + ApiBase::PARAM_DFLT => -1 + ], + 'metadataversion' => [ + ApiBase::PARAM_TYPE => 'string', + ApiBase::PARAM_DFLT => '1', + ], + 'extmetadatalanguage' => [ + ApiBase::PARAM_TYPE => 'string', + ApiBase::PARAM_DFLT => $wgContLang->getCode(), + ], + 'extmetadatamultilang' => [ + ApiBase::PARAM_TYPE => 'boolean', + ApiBase::PARAM_DFLT => false, + ], + 'extmetadatafilter' => [ + ApiBase::PARAM_TYPE => 'string', + ApiBase::PARAM_ISMULTI => true, + ], + 'urlparam' => [ + ApiBase::PARAM_DFLT => '', + ApiBase::PARAM_TYPE => 'string', + ], + 'badfilecontexttitle' => [ + ApiBase::PARAM_TYPE => 'string', + ], + 'continue' => [ + ApiBase::PARAM_HELP_MSG => 'api-help-param-continue', + ], + 'localonly' => false, + ]; + } + + /** + * Returns all possible parameters to iiprop + * + * @param array $filter List of properties to filter out + * @return array + */ + public static function getPropertyNames( $filter = [] ) { + return array_keys( static::getPropertyMessages( $filter ) ); + } + + /** + * Returns messages for all possible parameters to iiprop + * + * @param array $filter List of properties to filter out + * @return array + */ + public static function getPropertyMessages( $filter = [] ) { + return array_diff_key( + [ + 'timestamp' => 'apihelp-query+imageinfo-paramvalue-prop-timestamp', + 'user' => 'apihelp-query+imageinfo-paramvalue-prop-user', + 'userid' => 'apihelp-query+imageinfo-paramvalue-prop-userid', + 'comment' => 'apihelp-query+imageinfo-paramvalue-prop-comment', + 'parsedcomment' => 'apihelp-query+imageinfo-paramvalue-prop-parsedcomment', + 'canonicaltitle' => 'apihelp-query+imageinfo-paramvalue-prop-canonicaltitle', + 'url' => 'apihelp-query+imageinfo-paramvalue-prop-url', + 'size' => 'apihelp-query+imageinfo-paramvalue-prop-size', + 'dimensions' => 'apihelp-query+imageinfo-paramvalue-prop-dimensions', + 'sha1' => 'apihelp-query+imageinfo-paramvalue-prop-sha1', + 'mime' => 'apihelp-query+imageinfo-paramvalue-prop-mime', + 'thumbmime' => 'apihelp-query+imageinfo-paramvalue-prop-thumbmime', + 'mediatype' => 'apihelp-query+imageinfo-paramvalue-prop-mediatype', + 'metadata' => 'apihelp-query+imageinfo-paramvalue-prop-metadata', + 'commonmetadata' => 'apihelp-query+imageinfo-paramvalue-prop-commonmetadata', + 'extmetadata' => 'apihelp-query+imageinfo-paramvalue-prop-extmetadata', + 'archivename' => 'apihelp-query+imageinfo-paramvalue-prop-archivename', + 'bitdepth' => 'apihelp-query+imageinfo-paramvalue-prop-bitdepth', + 'uploadwarning' => 'apihelp-query+imageinfo-paramvalue-prop-uploadwarning', + 'badfile' => 'apihelp-query+imageinfo-paramvalue-prop-badfile', + ], + array_flip( $filter ) + ); + } + + /** + * Returns array key value pairs of properties and their descriptions + * + * @deprecated since 1.25 + * @param string $modulePrefix + * @return array + */ + private static function getProperties( $modulePrefix = '' ) { + return [ + 'timestamp' => ' timestamp - Adds timestamp for the uploaded version', + 'user' => ' user - Adds the user who uploaded the image version', + 'userid' => ' userid - Add the user ID that uploaded the image version', + 'comment' => ' comment - Comment on the version', + 'parsedcomment' => ' parsedcomment - Parse the comment on the version', + 'canonicaltitle' => ' canonicaltitle - Adds the canonical title of the image file', + 'url' => ' url - Gives URL to the image and the description page', + 'size' => ' size - Adds the size of the image in bytes, ' . + 'its height and its width. Page count and duration are added if applicable', + 'dimensions' => ' dimensions - Alias for size', // B/C with Allimages + 'sha1' => ' sha1 - Adds SHA-1 hash for the image', + 'mime' => ' mime - Adds MIME type of the image', + 'thumbmime' => ' thumbmime - Adds MIME type of the image thumbnail' . + ' (requires url and param ' . $modulePrefix . 'urlwidth)', + 'mediatype' => ' mediatype - Adds the media type of the image', + 'metadata' => ' metadata - Lists Exif metadata for the version of the image', + 'commonmetadata' => ' commonmetadata - Lists file format generic metadata ' . + 'for the version of the image', + 'extmetadata' => ' extmetadata - Lists formatted metadata combined ' . + 'from multiple sources. Results are HTML formatted.', + 'archivename' => ' archivename - Adds the file name of the archive ' . + 'version for non-latest versions', + 'bitdepth' => ' bitdepth - Adds the bit depth of the version', + 'uploadwarning' => ' uploadwarning - Used by the Special:Upload page to ' . + 'get information about an existing file. Not intended for use outside MediaWiki core', + ]; + } + + /** + * Returns the descriptions for the properties provided by getPropertyNames() + * + * @deprecated since 1.25 + * @param array $filter List of properties to filter out + * @param string $modulePrefix + * @return array + */ + public static function getPropertyDescriptions( $filter = [], $modulePrefix = '' ) { + return array_merge( + [ 'What image information to get:' ], + array_values( array_diff_key( static::getProperties( $modulePrefix ), array_flip( $filter ) ) ) + ); + } + + protected function getExamplesMessages() { + return [ + 'action=query&titles=File:Albert%20Einstein%20Head.jpg&prop=imageinfo' + => 'apihelp-query+imageinfo-example-simple', + 'action=query&titles=File:Test.jpg&prop=imageinfo&iilimit=50&' . + 'iiend=2007-12-31T23:59:59Z&iiprop=timestamp|user|url' + => 'apihelp-query+imageinfo-example-dated', + ]; + } + + public function getHelpUrls() { + return 'https://www.mediawiki.org/wiki/Special:MyLanguage/API:Imageinfo'; + } +} |