Standardised file description headers; first path
[lhc/web/wiklou.git] / includes / specials / SpecialLinkSearch.php
1 <?php
2 /**
3 * Implements Special:LinkSearch
4 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
9 *
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
14 *
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
19 *
20 * @file
21 * @ingroup SpecialPage
22 * @author Brion Vibber
23 */
24
25
26 /**
27 * Special:LinkSearch to search the external-links table.
28 */
29 function wfSpecialLinkSearch( $par ) {
30
31 list( $limit, $offset ) = wfCheckLimits();
32 global $wgOut, $wgUrlProtocols, $wgMiserMode, $wgLang;
33 $target = $GLOBALS['wgRequest']->getVal( 'target', $par );
34 $namespace = $GLOBALS['wgRequest']->getIntorNull( 'namespace', null );
35
36 $protocols_list[] = '';
37 foreach( $wgUrlProtocols as $prot ) {
38 $protocols_list[] = $prot;
39 }
40
41 $target2 = $target;
42 $protocol = '';
43 $pr_sl = strpos($target2, '//' );
44 $pr_cl = strpos($target2, ':' );
45 if ( $pr_sl ) {
46 // For protocols with '//'
47 $protocol = substr( $target2, 0 , $pr_sl+2 );
48 $target2 = substr( $target2, $pr_sl+2 );
49 } elseif ( !$pr_sl && $pr_cl ) {
50 // For protocols without '//' like 'mailto:'
51 $protocol = substr( $target2, 0 , $pr_cl+1 );
52 $target2 = substr( $target2, $pr_cl+1 );
53 } elseif ( $protocol == '' && $target2 != '' ) {
54 // default
55 $protocol = 'http://';
56 }
57 if ( !in_array( $protocol, $protocols_list ) ) {
58 // unsupported protocol, show original search request
59 $target2 = $target;
60 $protocol = '';
61 }
62
63 $self = Title::makeTitle( NS_SPECIAL, 'Linksearch' );
64
65 $wgOut->addWikiMsg( 'linksearch-text', '<nowiki>' . $wgLang->commaList( $wgUrlProtocols ) . '</nowiki>' );
66 $s = Xml::openElement( 'form', array( 'id' => 'mw-linksearch-form', 'method' => 'get', 'action' => $GLOBALS['wgScript'] ) ) .
67 Xml::hidden( 'title', $self->getPrefixedDbKey() ) .
68 '<fieldset>' .
69 Xml::element( 'legend', array(), wfMsg( 'linksearch' ) ) .
70 Xml::inputLabel( wfMsg( 'linksearch-pat' ), 'target', 'target', 50, $target ) . ' ';
71 if ( !$wgMiserMode ) {
72 $s .= Xml::label( wfMsg( 'linksearch-ns' ), 'namespace' ) . ' ' .
73 Xml::namespaceSelector( $namespace, '' );
74 }
75 $s .= Xml::submitButton( wfMsg( 'linksearch-ok' ) ) .
76 '</fieldset>' .
77 Xml::closeElement( 'form' );
78 $wgOut->addHTML( $s );
79
80 if( $target != '' ) {
81 $searcher = new LinkSearchPage;
82 $searcher->setParams( array(
83 'query' => $target2,
84 'namespace' => $namespace,
85 'protocol' => $protocol ) );
86 $searcher->doQuery( $offset, $limit );
87 }
88 }
89
90 /**
91 * @ingroup SpecialPage
92 */
93 class LinkSearchPage extends QueryPage {
94 function setParams( $params ) {
95 $this->mQuery = $params['query'];
96 $this->mNs = $params['namespace'];
97 $this->mProt = $params['protocol'];
98 }
99
100 function getName() {
101 return 'LinkSearch';
102 }
103
104 /**
105 * Disable RSS/Atom feeds
106 */
107 function isSyndicated() {
108 return false;
109 }
110
111 /**
112 * Return an appropriately formatted LIKE query and the clause
113 */
114 static function mungeQuery( $query , $prot ) {
115 $field = 'el_index';
116 $rv = LinkFilter::makeLikeArray( $query , $prot );
117 if ($rv === false) {
118 // LinkFilter doesn't handle wildcard in IP, so we'll have to munge here.
119 if (preg_match('/^(:?[0-9]{1,3}\.)+\*\s*$|^(:?[0-9]{1,3}\.){3}[0-9]{1,3}:[0-9]*\*\s*$/', $query)) {
120 $rv = array( $prot . rtrim($query, " \t*"), $dbr->anyString() );
121 $field = 'el_to';
122 }
123 }
124 return array( $rv, $field );
125 }
126
127 function linkParameters() {
128 global $wgMiserMode;
129 $params = array();
130 $params['target'] = $this->mProt . $this->mQuery;
131 if( isset( $this->mNs ) && !$wgMiserMode ) {
132 $params['namespace'] = $this->mNs;
133 }
134 return $params;
135 }
136
137 function getSQL() {
138 global $wgMiserMode;
139 $dbr = wfGetDB( DB_SLAVE );
140 $page = $dbr->tableName( 'page' );
141 $externallinks = $dbr->tableName( 'externallinks' );
142
143 /* strip everything past first wildcard, so that index-based-only lookup would be done */
144 list( $munged, $clause ) = self::mungeQuery( $this->mQuery, $this->mProt );
145 $stripped = LinkFilter::keepOneWildcard( $munged );
146 $like = $dbr->buildLike( $stripped );
147
148 $encSQL = '';
149 if ( isset ($this->mNs) && !$wgMiserMode )
150 $encSQL = 'AND page_namespace=' . $dbr->addQuotes( $this->mNs );
151
152 $use_index = $dbr->useIndexClause( $clause );
153 return
154 "SELECT
155 page_namespace AS namespace,
156 page_title AS title,
157 el_index AS value,
158 el_to AS url
159 FROM
160 $page,
161 $externallinks $use_index
162 WHERE
163 page_id=el_from
164 AND $clause $like
165 $encSQL";
166 }
167
168 function formatResult( $skin, $result ) {
169 $title = Title::makeTitle( $result->namespace, $result->title );
170 $url = $result->url;
171 $pageLink = $skin->linkKnown( $title );
172 $urlLink = $skin->makeExternalLink( $url, $url );
173
174 return wfMsgHtml( 'linksearch-line', $urlLink, $pageLink );
175 }
176
177 /**
178 * Override to check query validity.
179 */
180 function doQuery( $offset, $limit, $shownavigation=true ) {
181 global $wgOut;
182 list( $this->mMungedQuery, $clause ) = LinkSearchPage::mungeQuery( $this->mQuery, $this->mProt );
183 if( $this->mMungedQuery === false ) {
184 $wgOut->addWikiMsg( 'linksearch-error' );
185 } else {
186 // For debugging
187 // Generates invalid xhtml with patterns that contain --
188 //$wgOut->addHTML( "\n<!-- " . htmlspecialchars( $this->mMungedQuery ) . " -->\n" );
189 parent::doQuery( $offset, $limit, $shownavigation );
190 }
191 }
192
193 /**
194 * Override to squash the ORDER BY.
195 * We do a truncated index search, so the optimizer won't trust
196 * it as good enough for optimizing sort. The implicit ordering
197 * from the scan will usually do well enough for our needs.
198 */
199 function getOrder() {
200 return '';
201 }
202 }