1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
|
<?php
/**
* 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
*/
namespace MediaWiki\Specials;
use MediaWiki\SpecialPage\RedirectSpecialPage;
use MediaWiki\SpecialPage\SpecialPage;
use MediaWiki\Title\Title;
use SearchEngineFactory;
/**
* Redirects to the URL of a thumbnail for the given file.
*
* @ingroup SpecialPage
*/
class SpecialFilepath extends RedirectSpecialPage {
private SearchEngineFactory $searchEngineFactory;
public function __construct(
SearchEngineFactory $searchEngineFactory
) {
parent::__construct( 'Filepath' );
$this->mAllowedRedirectParams = [ 'width', 'height' ];
$this->searchEngineFactory = $searchEngineFactory;
}
/**
* Implement by redirecting through Special:Redirect/file.
*
* @param string|null $par
* @return Title
*/
public function getRedirect( $par ) {
$file = $par ?: $this->getRequest()->getText( 'file' );
$redirect = null;
if ( $file ) {
$redirect = SpecialPage::getSafeTitleFor( 'Redirect', "file/$file" );
}
if ( $redirect === null ) {
// The user input is empty or an invalid title,
// redirect to form of Special:Redirect with the invalid value prefilled
$this->mAddedRedirectParams['wpvalue'] = $file;
$redirect = SpecialPage::getSafeTitleFor( 'Redirect', 'file' );
}
// @phan-suppress-next-line PhanTypeMismatchReturnNullable Known to be valid
return $redirect;
}
/**
* Return an array of subpages beginning with $search that this special page will accept.
*
* @param string $search Prefix to search for
* @param int $limit Maximum number of results to return (usually 10)
* @param int $offset Number of results to skip (usually 0)
* @return string[] Matching subpages
*/
public function prefixSearchSubpages( $search, $limit, $offset ) {
$title = Title::newFromText( $search, NS_FILE );
if ( !$title || $title->getNamespace() !== NS_FILE ) {
// No prefix suggestion outside of file namespace
return [];
}
$searchEngine = $this->searchEngineFactory->create();
$searchEngine->setLimitOffset( $limit, $offset );
// Autocomplete subpage the same as a normal search, but just for files
$searchEngine->setNamespaces( [ NS_FILE ] );
$result = $searchEngine->defaultPrefixSearch( $search );
return array_map( static function ( Title $t ) {
// Remove namespace in search suggestion
return $t->getText();
}, $result );
}
protected function getGroupName() {
return 'media';
}
}
/** @deprecated class alias since 1.41 */
class_alias( SpecialFilepath::class, 'SpecialFilepath' );
|
