MediaWiki REL1_30
SpecialMIMEsearch.php
Go to the documentation of this file.
1<?php
31 protected $major, $minor, $mime;
32
33 function __construct( $name = 'MIMEsearch' ) {
34 parent::__construct( $name );
35 }
36
37 public function isExpensive() {
38 return false;
39 }
40
41 function isSyndicated() {
42 return false;
43 }
44
45 function isCacheable() {
46 return false;
47 }
48
49 function linkParameters() {
50 return [ 'mime' => "{$this->major}/{$this->minor}" ];
51 }
52
53 public function getQueryInfo() {
54 $minorType = [];
55 if ( $this->minor !== '*' ) {
56 // Allow wildcard searching
57 $minorType['img_minor_mime'] = $this->minor;
58 }
59 $qi = [
60 'tables' => [ 'image' ],
61 'fields' => [
62 'namespace' => NS_FILE,
63 'title' => 'img_name',
64 // Still have a value field just in case,
65 // but it isn't actually used for sorting.
66 'value' => 'img_name',
67 'img_size',
68 'img_width',
69 'img_height',
70 'img_user_text',
71 'img_timestamp'
72 ],
73 'conds' => [
74 'img_major_mime' => $this->major,
75 // This is in order to trigger using
76 // the img_media_mime index in "range" mode.
77 // @todo how is order defined? use MimeAnalyzer::getMediaTypes?
78 'img_media_type' => [
90 ],
91 ] + $minorType,
92 ];
93
94 return $qi;
95 }
96
106 function getOrderFields() {
107 return [];
108 }
109
113 function getPageHeader() {
114 $formDescriptor = [
115 'mime' => [
116 'type' => 'combobox',
117 'options' => $this->getSuggestionsForTypes(),
118 'name' => 'mime',
119 'label-message' => 'mimetype',
120 'required' => true,
121 'default' => $this->mime,
122 ],
123 ];
124
125 HTMLForm::factory( 'ooui', $formDescriptor, $this->getContext() )
126 ->setSubmitTextMsg( 'ilsubmit' )
127 ->setAction( $this->getPageTitle()->getLocalURL() )
128 ->setMethod( 'get' )
129 ->prepareForm()
130 ->displayForm( false );
131 }
132
133 protected function getSuggestionsForTypes() {
135 $lastMajor = null;
136 $suggestions = [];
137 $result = $dbr->select(
138 [ 'image' ],
139 // We ignore img_media_type, but using it in the query is needed for MySQL to choose a
140 // sensible execution plan
141 [ 'img_media_type', 'img_major_mime', 'img_minor_mime' ],
142 [],
143 __METHOD__,
144 [ 'GROUP BY' => [ 'img_media_type', 'img_major_mime', 'img_minor_mime' ] ]
145 );
146 foreach ( $result as $row ) {
147 $major = $row->img_major_mime;
148 $minor = $row->img_minor_mime;
149 $suggestions[ "$major/$minor" ] = "$major/$minor";
150 if ( $lastMajor === $major ) {
151 // If there are at least two with the same major mime type, also include the wildcard
152 $suggestions[ "$major/*" ] = "$major/*";
153 }
154 $lastMajor = $major;
155 }
156 ksort( $suggestions );
157 return $suggestions;
158 }
159
160 public function execute( $par ) {
161 $this->mime = $par ? $par : $this->getRequest()->getText( 'mime' );
162 $this->mime = trim( $this->mime );
163 list( $this->major, $this->minor ) = File::splitMime( $this->mime );
164
165 if ( $this->major == '' || $this->minor == '' || $this->minor == 'unknown' ||
166 !self::isValidType( $this->major )
167 ) {
168 $this->setHeaders();
169 $this->outputHeader();
170 $this->getPageHeader();
171 return;
172 }
173
174 parent::execute( $par );
175 }
176
182 function formatResult( $skin, $result ) {
183 global $wgContLang;
184
186 $nt = Title::makeTitle( $result->namespace, $result->title );
187 $text = $wgContLang->convert( $nt->getText() );
188 $plink = $linkRenderer->makeLink(
189 Title::newFromText( $nt->getPrefixedText() ),
190 $text
191 );
192
193 $download = Linker::makeMediaLinkObj( $nt, $this->msg( 'download' )->escaped() );
194 $download = $this->msg( 'parentheses' )->rawParams( $download )->escaped();
195 $lang = $this->getLanguage();
196 $bytes = htmlspecialchars( $lang->formatSize( $result->img_size ) );
197 $dimensions = $this->msg( 'widthheight' )->numParams( $result->img_width,
198 $result->img_height )->escaped();
199 $user = $linkRenderer->makeLink(
200 Title::makeTitle( NS_USER, $result->img_user_text ),
201 $result->img_user_text
202 );
203
204 $time = $lang->userTimeAndDate( $result->img_timestamp, $this->getUser() );
205 $time = htmlspecialchars( $time );
206
207 return "$download $plink . . $dimensions . . $bytes . . $user . . $time";
208 }
209
214 protected static function isValidType( $type ) {
215 // From maintenance/tables.sql => img_major_mime
216 $types = [
217 'unknown',
218 'application',
219 'audio',
220 'image',
221 'text',
222 'video',
223 'message',
224 'model',
225 'multipart',
226 'chemical'
227 ];
228
229 return in_array( $type, $types );
230 }
231
232 public function preprocessResults( $db, $res ) {
234 }
235
236 protected function getGroupName() {
237 return 'media';
238 }
239}
wfGetDB( $db, $groups=[], $wiki=false)
Get a Database object.
static splitMime( $mime)
Split an internet media type into its two components; if not a two-part name, set the minor type to '...
Definition File.php:273
static factory( $displayFormat)
Construct a HTMLForm object for given display type.
Definition HTMLForm.php:277
static makeMediaLinkObj( $title, $html='', $time=false)
Create a direct link to a given uploaded file.
Definition Linker.php:766
Searches the database for files of the requested MIME type, comparing this with the 'img_major_mime' ...
getPageHeader()
Generate and output the form.
isExpensive()
Is this query expensive (for some definition of expensive)? Then we don't let it run in miser mode.
getOrderFields()
The index is on (img_media_type, img_major_mime, img_minor_mime) which unfortunately doesn't have img...
getGroupName()
Under which header this special page is listed in Special:SpecialPages See messages 'specialpages-gro...
formatResult( $skin, $result)
linkParameters()
If using extra form wheely-dealies, return a set of parameters here as an associative array.
preprocessResults( $db, $res)
Do any necessary preprocessing of the result object.
static isValidType( $type)
__construct( $name='MIMEsearch')
getQueryInfo()
Subclasses return an SQL query here, formatted as an array with the following keys: tables => Table(s...
isCacheable()
Is the output of this query cacheable? Non-cacheable expensive pages will be disabled in miser mode a...
execute( $par)
This is the actual workhorse.
isSyndicated()
Sometime we don't want to build rss / atom feeds.
This is a class for doing query pages; since they're almost all the same, we factor out some of the f...
Definition QueryPage.php:34
executeLBFromResultWrapper(ResultWrapper $res, $ns=null)
Creates a new LinkBatch object, adds all pages from the passed ResultWrapper (MUST include title and ...
outputHeader( $summaryMessageKey='')
Outputs a summary message on top of special pages Per default the message key is the canonical name o...
setHeaders()
Sets headers - this should be called from the execute() method of all derived classes!
getContext()
Gets the context this SpecialPage is executed in.
msg( $key)
Wrapper around wfMessage that sets the current context.
getRequest()
Get the WebRequest being used for this instance.
getPageTitle( $subpage=false)
Get a self-referential title object.
getLanguage()
Shortcut to get user's language.
MediaWiki Linker LinkRenderer null $linkRenderer
if(! $regexes) $dbr
Definition cleanup.php:94
$res
Definition database.txt:21
deferred txt A few of the database updates required by various functions here can be deferred until after the result page is displayed to the user For updating the view updating the linked to tables after a etc PHP does not yet have any way to tell the server to actually return and disconnect while still running these but it might have such a feature in the future We handle these by creating a deferred update object and putting those objects on a global list
Definition deferred.txt:11
this class mediates it Skin Encapsulates a look and feel for the wiki All of the functions that render HTML and make choices about how to render it are here and are called from various other places when and is meant to be subclassed with other skins that may override some of its functions The User object contains a reference to a and so rather than having a global skin object we just rely on the global User and get the skin with $wgUser and also has some character encoding functions and other locale stuff The current user interface language is instantiated as and the local content language as $wgContLang
Definition design.txt:57
see documentation in includes Linker php for Linker::makeImageLink & $time
Definition hooks.txt:1778
const NS_FILE
Definition Defines.php:71
const MEDIATYPE_DRAWING
Definition defines.php:30
const MEDIATYPE_VIDEO
Definition defines.php:35
const MEDIATYPE_OFFICE
Definition defines.php:39
const MEDIATYPE_UNKNOWN
Definition defines.php:26
const MEDIATYPE_AUDIO
Definition defines.php:32
const MEDIATYPE_TEXT
Definition defines.php:41
const MEDIATYPE_BITMAP
Definition defines.php:28
const MEDIATYPE_MULTIMEDIA
Definition defines.php:37
const MEDIATYPE_EXECUTABLE
Definition defines.php:43
const MEDIATYPE_3D
Definition defines.php:47
const MEDIATYPE_ARCHIVE
Definition defines.php:45
const DB_REPLICA
Definition defines.php:25
if(!isset( $args[0])) $lang