includes/SpecialSearch.php

   1 <?php
   2 # Copyright (C) 2004 Brion Vibber <brion@pobox.com>
   3 # http://www.mediawiki.org/
   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 /**
  21  * Run text & title search and display the output
  22  * @addtogroup SpecialPage
  23  */
  24
  25 /**
  26  * Entry point
  27  *
  28  * @param $par String: (default '')
  29  */
  30 function wfSpecialSearch( $par = '' ) {
  31         global $wgRequest, $wgUser;
  32
  33         $search = $wgRequest->getText( 'search', $par );
  34         $searchPage = new SpecialSearch( $wgRequest, $wgUser );
  35         if( $wgRequest->getVal( 'fulltext' ) ||
  36                 !is_null( $wgRequest->getVal( 'offset' ) ) ||
  37                 !is_null ($wgRequest->getVal( 'searchx' ) ) ) {
  38                 $searchPage->showResults( $search );
  39         } else {
  40                 $searchPage->goResult( $search );
  41         }
  42 }
  43
  44 /**
  45  * implements Special:Search - Run text & title search and display the output
  46  * @addtogroup SpecialPage
  47  */
  48 class SpecialSearch {
  49
  50         /**
  51          * Set up basic search parameters from the request and user settings.
  52          * Typically you'll pass $wgRequest and $wgUser.
  53          *
  54          * @param WebRequest $request
  55          * @param User $user
  56          * @public
  57          */
  58         function SpecialSearch( &$request, &$user ) {
  59                 list( $this->limit, $this->offset ) = $request->getLimitOffset( 20, 'searchlimit' );
  60
  61                 if( $request->getCheck( 'searchx' ) ) {
  62                         $this->namespaces = $this->powerSearch( $request );
  63                 } else {
  64                         $this->namespaces = $this->userNamespaces( $user );
  65                 }
  66
  67                 $this->searchRedirects = $request->getcheck( 'redirs' ) ? true : false;
  68         }
  69
  70         /**
  71          * If an exact title match can be found, jump straight ahead to it.
  72          * @param string $term
  73          * @public
  74          */
  75         function goResult( $term ) {
  76                 global $wgOut;
  77                 global $wgGoToEdit;
  78
  79                 $this->setupPage( $term );
  80
  81                 # Try to go to page as entered.
  82                 $t = Title::newFromText( $term );
  83
  84                 # If the string cannot be used to create a title
  85                 if( is_null( $t ) ){
  86                         return $this->showResults( $term );
  87                 }
  88
  89                 # If there's an exact or very near match, jump right there.
  90                 $t = SearchEngine::getNearMatch( $term );
  91                 if( !is_null( $t ) ) {
  92                         $wgOut->redirect( $t->getFullURL() );
  93                         return;
  94                 }
  95
  96                 # No match, generate an edit URL
  97                 $t = Title::newFromText( $term );
  98                 if( ! is_null( $t ) ) {
  99                         wfRunHooks( 'SpecialSearchNogomatch', array( &$t ) );
 100                         # If the feature is enabled, go straight to the edit page
 101                         if ( $wgGoToEdit ) {
 102                                 $wgOut->redirect( $t->getFullURL( 'action=edit' ) );
 103                                 return;
 104                         }
 105                 }
 106                 $wgOut->addWikiText( wfMsg( 'noexactmatch', wfEscapeWikiText( $term ) ) );
 107
 108                 return $this->showResults( $term );
 109         }
 110
 111         /**
 112          * @param string $term
 113          * @public
 114          */
 115         function showResults( $term ) {
 116                 $fname = 'SpecialSearch::showResults';
 117                 wfProfileIn( $fname );
 118
 119                 $this->setupPage( $term );
 120
 121                 global $wgOut;
 122                 $wgOut->addWikiText( wfMsg( 'searchresulttext' ) );
 123
 124                 #if ( !$this->parseQuery() ) {
 125                 if( '' === trim( $term ) ) {
 126                         $wgOut->setSubtitle( '' );
 127                         $wgOut->addHTML( $this->powerSearchBox( $term ) );
 128                         wfProfileOut( $fname );
 129                         return;
 130                 }
 131
 132                 global $wgDisableTextSearch;
 133                 if ( $wgDisableTextSearch ) {
 134                         global $wgForwardSearchUrl;
 135                         if( $wgForwardSearchUrl ) {
 136                                 $url = str_replace( '$1', urlencode( $term ), $wgForwardSearchUrl );
 137                                 $wgOut->redirect( $url );
 138                                 return;
 139                         }
 140                         global $wgInputEncoding;
 141                         $wgOut->addHTML( wfMsg( 'searchdisabled' ) );
 142                         $wgOut->addHTML(
 143                                 wfMsg( 'googlesearch',
 144                                         htmlspecialchars( $term ),
 145                                         htmlspecialchars( $wgInputEncoding ),
 146                                         htmlspecialchars( wfMsg( 'searchbutton' ) )
 147                                 )
 148                         );
 149                         wfProfileOut( $fname );
 150                         return;
 151                 }
 152
 153                 $search = SearchEngine::create();
 154                 $search->setLimitOffset( $this->limit, $this->offset );
 155                 $search->setNamespaces( $this->namespaces );
 156                 $search->showRedirects = $this->searchRedirects;
 157                 $titleMatches = $search->searchTitle( $term );
 158                 $textMatches = $search->searchText( $term );
 159
 160                 $num = ( $titleMatches ? $titleMatches->numRows() : 0 )
 161                         + ( $textMatches ? $textMatches->numRows() : 0);
 162                 if ( $num > 0 ) {
 163                         if ( $num >= $this->limit ) {
 164                                 $top = wfShowingResults( $this->offset, $this->limit );
 165                         } else {
 166                                 $top = wfShowingResultsNum( $this->offset, $this->limit, $num );
 167                         }
 168                         $wgOut->addHTML( "<p>{$top}</p>\n" );
 169                 }
 170
 171                 if( $num || $this->offset ) {
 172                         $prevnext = wfViewPrevNext( $this->offset, $this->limit,
 173                                 SpecialPage::getTitleFor( 'Search' ),
 174                                 wfArrayToCGI(
 175                                         $this->powerSearchOptions(),
 176                                         array( 'search' => $term ) ),
 177                                         ($num < $this->limit) );
 178                         $wgOut->addHTML( "<br />{$prevnext}\n" );
 179                 }
 180
 181                 if( $titleMatches ) {
 182                         if( $titleMatches->numRows() ) {
 183                                 $wgOut->addWikiText( '==' . wfMsg( 'titlematches' ) . "==\n" );
 184                                 $wgOut->addHTML( $this->showMatches( $titleMatches ) );
 185                         } else {
 186                                 $wgOut->addWikiText( '==' . wfMsg( 'notitlematches' ) . "==\n" );
 187                         }
 188                         $titleMatches->free();
 189                 }
 190
 191                 if( $textMatches ) {
 192                         if( $textMatches->numRows() ) {
 193                                 $wgOut->addWikiText( '==' . wfMsg( 'textmatches' ) . "==\n" );
 194                                 $wgOut->addHTML( $this->showMatches( $textMatches ) );
 195                         } elseif( $num == 0 ) {
 196                                 # Don't show the 'no text matches' if we received title matches
 197                                 $wgOut->addWikiText( '==' . wfMsg( 'notextmatches' ) . "==\n" );
 198                         }
 199                         $textMatches->free();
 200                 }
 201
 202                 if ( $num == 0 ) {
 203                         $wgOut->addWikiText( wfMsg( 'nonefound' ) );
 204                 }
 205                 if( $num || $this->offset ) {
 206                         $wgOut->addHTML( "<p>{$prevnext}</p>\n" );
 207                 }
 208                 $wgOut->addHTML( $this->powerSearchBox( $term ) );
 209                 wfProfileOut( $fname );
 210         }
 211
 212         #------------------------------------------------------------------
 213         # Private methods below this line
 214
 215         /**
 216          *
 217          */
 218         function setupPage( $term ) {
 219                 global $wgOut;
 220                 $wgOut->setPageTitle( wfMsg( 'searchresults' ) );
 221                 $subtitlemsg = ( Title::newFromText($term) ? 'searchsubtitle' : 'searchsubtitleinvalid' );
 222                 $wgOut->setSubtitle( $wgOut->parse( wfMsg( $subtitlemsg, wfEscapeWikiText($term) ) ) );
 223                 $wgOut->setArticleRelated( false );
 224                 $wgOut->setRobotpolicy( 'noindex,nofollow' );
 225         }
 226
 227         /**
 228          * Extract default namespaces to search from the given user's
 229          * settings, returning a list of index numbers.
 230          *
 231          * @param User $user
 232          * @return array
 233          * @private
 234          */
 235         function userNamespaces( &$user ) {
 236                 $arr = array();
 237                 foreach( SearchEngine::searchableNamespaces() as $ns => $name ) {
 238                         if( $user->getOption( 'searchNs' . $ns ) ) {
 239                                 $arr[] = $ns;
 240                         }
 241                 }
 242                 return $arr;
 243         }
 244
 245         /**
 246          * Extract "power search" namespace settings from the request object,
 247          * returning a list of index numbers to search.
 248          *
 249          * @param WebRequest $request
 250          * @return array
 251          * @private
 252          */
 253         function powerSearch( &$request ) {
 254                 $arr = array();
 255                 foreach( SearchEngine::searchableNamespaces() as $ns => $name ) {
 256                         if( $request->getCheck( 'ns' . $ns ) ) {
 257                                 $arr[] = $ns;
 258                         }
 259                 }
 260                 return $arr;
 261         }
 262
 263         /**
 264          * Reconstruct the 'power search' options for links
 265          * @return array
 266          * @private
 267          */
 268         function powerSearchOptions() {
 269                 $opt = array();
 270                 foreach( $this->namespaces as $n ) {
 271                         $opt['ns' . $n] = 1;
 272                 }
 273                 $opt['redirs'] = $this->searchRedirects ? 1 : 0;
 274                 $opt['searchx'] = 1;
 275                 return $opt;
 276         }
 277
 278         /**
 279          * @param SearchResultSet $matches
 280          * @param string $terms partial regexp for highlighting terms
 281          */
 282         function showMatches( &$matches ) {
 283                 $fname = 'SpecialSearch::showMatches';
 284                 wfProfileIn( $fname );
 285
 286                 global $wgContLang;
 287                 $tm = $wgContLang->convertForSearchResult( $matches->termMatches() );
 288                 $terms = implode( '|', $tm );
 289
 290                 $off = $this->offset + 1;
 291                 $out = "<ol start='{$off}'>\n";
 292
 293                 while( $result = $matches->next() ) {
 294                         $out .= $this->showHit( $result, $terms );
 295                 }
 296                 $out .= "</ol>\n";
 297
 298                 // convert the whole thing to desired language variant
 299                 global $wgContLang;
 300                 $out = $wgContLang->convert( $out );
 301                 wfProfileOut( $fname );
 302                 return $out;
 303         }
 304
 305         /**
 306          * Format a single hit result
 307          * @param SearchResult $result
 308          * @param string $terms partial regexp for highlighting terms
 309          */
 310         function showHit( $result, $terms ) {
 311                 $fname = 'SpecialSearch::showHit';
 312                 wfProfileIn( $fname );
 313                 global $wgUser, $wgContLang, $wgLang;
 314
 315                 $t = $result->getTitle();
 316                 if( is_null( $t ) ) {
 317                         wfProfileOut( $fname );
 318                         return "<!-- Broken link in search result -->\n";
 319                 }
 320                 $sk = $wgUser->getSkin();
 321
 322                 $contextlines = $wgUser->getOption( 'contextlines',  5 );
 323                 $contextchars = $wgUser->getOption( 'contextchars', 50 );
 324
 325                 $link = $sk->makeKnownLinkObj( $t );
 326
 327                 //If page content is not readable, just return the title.
 328                 //This is not quite safe, but better than showing excerpts from non-readable pages
 329                 //Note that hiding the entry entirely would screw up paging.
 330                 if (!$t->userCanRead()) {
 331                         return "<li>{$link}</li>\n";
 332                 }
 333
 334                 $revision = Revision::newFromTitle( $t );
 335                 $text = $revision->getText();
 336                 $size = wfMsgExt( 'nbytes', array( 'parsemag', 'escape'),
 337                         $wgLang->formatNum( strlen( $text ) ) );
 338
 339                 $lines = explode( "\n", $text );
 340
 341                 $max = intval( $contextchars ) + 1;
 342                 $pat1 = "/(.*)($terms)(.{0,$max})/i";
 343
 344                 $lineno = 0;
 345
 346                 $extract = '';
 347                 wfProfileIn( "$fname-extract" );
 348                 foreach ( $lines as $line ) {
 349                         if ( 0 == $contextlines ) {
 350                                 break;
 351                         }
 352                         ++$lineno;
 353                         $m = array();
 354                         if ( ! preg_match( $pat1, $line, $m ) ) {
 355                                 continue;
 356                         }
 357                         --$contextlines;
 358                         $pre = $wgContLang->truncate( $m[1], -$contextchars, '...' );
 359
 360                         if ( count( $m ) < 3 ) {
 361                                 $post = '';
 362                         } else {
 363                                 $post = $wgContLang->truncate( $m[3], $contextchars, '...' );
 364                         }
 365
 366                         $found = $m[2];
 367
 368                         $line = htmlspecialchars( $pre . $found . $post );
 369                         $pat2 = '/(' . $terms . ")/i";
 370                         $line = preg_replace( $pat2,
 371                           "<span class='searchmatch'>\\1</span>", $line );
 372
 373                         $extract .= "<br /><small>{$lineno}: {$line}</small>\n";
 374                 }
 375                 wfProfileOut( "$fname-extract" );
 376                 wfProfileOut( $fname );
 377                 return "<li>{$link} ({$size}){$extract}</li>\n";
 378         }
 379
 380         function powerSearchBox( $term ) {
 381                 $namespaces = '';
 382                 foreach( SearchEngine::searchableNamespaces() as $ns => $name ) {
 383                         $checked = in_array( $ns, $this->namespaces )
 384                                 ? ' checked="checked"'
 385                                 : '';
 386                         $name = str_replace( '_', ' ', $name );
 387                         if( '' == $name ) {
 388                                 $name = wfMsg( 'blanknamespace' );
 389                         }
 390                         $namespaces .= " <label><input type='checkbox' value=\"1\" name=\"" .
 391                           "ns{$ns}\"{$checked} />{$name}</label>\n";
 392                 }
 393
 394                 $checked = $this->searchRedirects
 395                         ? ' checked="checked"'
 396                         : '';
 397                 $redirect = "<input type='checkbox' value='1' name=\"redirs\"{$checked} />\n";
 398
 399                 $searchField = '<input type="text" name="search" value="' .
 400                         htmlspecialchars( $term ) ."\" size=\"16\" />\n";
 401
 402                 $searchButton = '<input type="submit" name="searchx" value="' .
 403                   htmlspecialchars( wfMsg('powersearch') ) . "\" />\n";
 404
 405                 $ret = wfMsg( 'powersearchtext',
 406                         $namespaces, $redirect, $searchField,
 407                         '', '', '', '', '', # Dummy placeholders
 408                         $searchButton );
 409
 410                 $title = SpecialPage::getTitleFor( 'Search' );
 411                 $action = $title->escapeLocalURL();
 412                 return "<br /><br />\n<form id=\"powersearch\" method=\"get\" " .
 413                   "action=\"$action\">\n{$ret}\n</form>\n";
 414         }
 415 }
 416
 417