* Refactoring ApiQueryImageInfo to use new File::loadHistory() interface. No change...
[lhc/web/wiklou.git] / includes / api / ApiQueryImageInfo.php
index 56c1c12..f0a9214 100644 (file)
@@ -42,14 +42,20 @@ class ApiQueryImageInfo extends ApiQueryBase {
        public function execute() {
                $params = $this->extractRequestParams();
 
-               $history = $params['history'];
-
                $prop = array_flip($params['prop']);            
-               $fld_timestamp = isset($prop['timestamp']);
-               $fld_user = isset($prop['user']);
-               $fld_comment = isset($prop['comment']);
-               $fld_url = isset($prop['url']);
-               $fld_size = isset($prop['size']);
+               $this->fld_timestamp = isset($prop['timestamp']);
+               $this->fld_user = isset($prop['user']);
+               $this->fld_comment = isset($prop['comment']);
+               $this->fld_url = isset($prop['url']);
+               $this->fld_size = isset($prop['size']);
+               $this->fld_sha1 = isset($prop['sha1']);
+               $this->fld_metadata = isset($prop['metadata']);
+               
+               if($params['urlheight'] != -1 && $params['urlwidth'] == -1)
+                       $this->dieUsage("iiurlheight cannot be used without iiurlwidth", 'iiurlwidth');
+               $this->scale = $params['urlwidth'] != -1;
+               $this->urlwidth = $params['urlwidth'];
+               $this->urlheight = $params['urlheight'];
 
                $pageIds = $this->getPageSet()->getAllTitlesByNamespace();
                if (!empty($pageIds[NS_IMAGE])) {
@@ -64,48 +70,71 @@ class ApiQueryImageInfo extends ApiQueryBase {
                                } else {
 
                                        $repository = $img->getRepoName();
-
-                                       $isCur = true;
-                                       while($line = $img->nextHistoryLine()) { // assignment
-                                               $vals = array();
-
-                                               if ($fld_timestamp)
-                                                       $vals['timestamp'] = wfTimestamp(TS_ISO_8601, $line->img_timestamp);
-                                               if ($fld_user) {
-                                                       $vals['user'] = $line->img_user_text;
-                                                       if(!$line->img_user)
-                                                               $vals['anon'] = '';
-                                               }
-                                               if ($fld_size) {
-                                                       $vals['size'] = intval($line->img_size);
-                                                       $vals['width'] = intval($line->img_width);
-                                                       $vals['height'] = intval($line->img_height);
-                                               }
-                                               if ($fld_url)
-                                                       $vals['url'] = $isCur ? $img->getURL() : $img->getArchiveUrl($line->oi_archive_name);
-                                               if ($fld_comment)
-                                                       $vals['comment'] = $line->img_description;
-
-                                               $data[] = $vals;
-                                               
-                                               if (!$history)  // Stop after the first line.
-                                                       break;
-                                                       
-                                               $isCur = false;
+                                       
+                                       // Get information about the current version first
+                                       // Check that the current version is within the start-end boundaries
+                                       if((is_null($params['start']) || $img->getTimestamp() <= $params['start']) &&
+                                                       (is_null($params['end']) || $img->getTimestamp() >= $params['end'])) {
+                                               $data[] = $this->getInfo($img);
                                        }
                                        
-                                       $img->resetHistory();
+                                       // Now get the old revisions
+                                       if($params['limit'] > 1) {
+                                               $oldies = $img->getHistory($params['limit'] - 1, $params['start'], $params['end']);
+                                               if(!empty($oldies))
+                                                       foreach($oldies as $oldie)
+                                                               $data[] = $this->getInfo($oldie);
+                                       }
                                }
 
-                $this->getResult()->addValue(array ('query', 'pages', intval($pageId)),
-                    'imagerepository',
-                    $repository);
-                if (!empty($data))
-                    $this->addPageSubItems($pageId, $data);
+                               $this->getResult()->addValue(array(
+                                               'query', 'pages', intval($pageId)),
+                                               'imagerepository', $repository
+                               );
+                               if (!empty($data))
+                                       $this->addPageSubItems($pageId, $data);
                        }
                }
        }
 
+       /**
+        * Get result information for an image revision
+        * @param File f The image
+        * @return array Result array
+        */
+       protected function getInfo($f) {
+               $vals = array();
+               if($this->fld_timestamp)
+                       $vals['timestamp'] = wfTimestamp(TS_ISO_8601, $f->getTimestamp());
+               if($this->fld_user) {
+                       $vals['user'] = $f->getUser();
+                       if(!$f->getUser('id'))
+                               $vals['anon'] = '';
+               }
+               if($this->fld_size) {
+                       $vals['size'] = $f->getSize();
+                       $vals['width'] = $f->getWidth();
+                       $vals['height'] = $f->getHeight();
+               }
+               if($this->fld_url) {
+                       if($this->scale) {
+                               $vals['url'] = $f->createThumb($this->urlwidth, $this->urlheight);
+                       } else {
+                               $vals['url'] = $f->getURL();
+                       }
+               }
+               if($this->fld_comment) 
+                       $vals['comment'] = $f->getDescription();
+               if($this->fld_sha1) 
+                       $vals['sha1'] = $f->getSha1();
+               if($this->fld_metadata) {
+                       $metadata = unserialize($f->getMetadata());
+                       $vals['metadata'] = $metadata ? $metadata : null;
+                       $this->getResult()->setIndexedTagName_recursive($vals['metadata'], 'meta');
+               }
+               return $vals;
+       }
+
        protected function getAllowedParams() {
                return array (
                        'prop' => array (
@@ -117,16 +146,42 @@ class ApiQueryImageInfo extends ApiQueryBase {
                                        'comment',
                                        'url',
                                        'size',
+                                       'sha1',
+                                       'metadata'
                                )
                        ),
-                       'history' => false,
+                       'limit' => array(
+                               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' => array(
+                               ApiBase :: PARAM_TYPE => 'timestamp'
+                       ),
+                       'end' => array(
+                               ApiBase :: PARAM_TYPE => 'timestamp'
+                       ),
+                       'urlwidth' => array(
+                               ApiBase :: PARAM_TYPE => 'integer',
+                               ApiBase :: PARAM_DFLT => -1
+                       ),
+                       'urlheight' => array(
+                               ApiBase :: PARAM_TYPE => 'integer',
+                               ApiBase :: PARAM_DFLT => -1
+                       )
                );
        }
 
        protected function getParamDescription() {
                return array (
                        'prop' => 'What image information to get.',
-                       'history' => 'Include upload history',
+                       'limit' => 'How many image revisions to return',
+                       'start' => 'Timestamp to start listing from',
+                       'end' => 'Timestamp to stop listing at',
+                       'urlwidth' => 'If iiprop=url is set, a URL to an image scaled to this width will be returned. Only the current version of the image can be scaled.',
+                       'urlheight' => 'Similar to iiurlwidth. Cannot be used without iiurlwidth',
                );
        }
 
@@ -139,7 +194,7 @@ class ApiQueryImageInfo extends ApiQueryBase {
        protected function getExamples() {
                return array (
                        'api.php?action=query&titles=Image:Albert%20Einstein%20Head.jpg&prop=imageinfo',
-                       'api.php?action=query&titles=Image:Test.jpg&prop=imageinfo&iihistory&iiprop=timestamp|user|url',
+                       'api.php?action=query&titles=Image:Test.jpg&prop=imageinfo&iilimit=50&iiend=20071231235959&iiprop=timestamp|user|url',
                );
        }