# http://www.mediawiki.org/
#
# 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
/**
* Run text & title search and display the output
* @addtogroup SpecialPage
*/
/**
* Entry point
*
* @param $par String: (default '')
*/
function wfSpecialSearch( $par = '' ) {
global $wgRequest, $wgUser;
$search = str_replace( "\n", " ", $wgRequest->getText( 'search', $par ) );
$searchPage = new SpecialSearch( $wgRequest, $wgUser );
if( $wgRequest->getVal( 'fulltext' ) ||
!is_null( $wgRequest->getVal( 'offset' ) ) ||
!is_null ($wgRequest->getVal( 'searchx' ) ) ) {
$searchPage->showResults( $search );
} else {
$searchPage->goResult( $search );
}
}
/**
* implements Special:Search - Run text & title search and display the output
* @addtogroup SpecialPage
*/
class SpecialSearch {
/**
* Set up basic search parameters from the request and user settings.
* Typically you'll pass $wgRequest and $wgUser.
*
* @param WebRequest $request
* @param User $user
* @public
*/
function SpecialSearch( &$request, &$user ) {
list( $this->limit, $this->offset ) = $request->getLimitOffset( 20, 'searchlimit' );
$this->namespaces = $this->powerSearch( $request );
if( empty( $this->namespaces ) ) {
$this->namespaces = $this->userNamespaces( $user );
}
$this->searchRedirects = $request->getcheck( 'redirs' ) ? true : false;
}
/**
* If an exact title match can be found, jump straight ahead to it.
* @param string $term
* @public
*/
function goResult( $term ) {
global $wgOut;
global $wgGoToEdit;
$this->setupPage( $term );
# Try to go to page as entered.
$t = Title::newFromText( $term );
# If the string cannot be used to create a title
if( is_null( $t ) ){
return $this->showResults( $term );
}
# If there's an exact or very near match, jump right there.
$t = SearchEngine::getNearMatch( $term );
if( !is_null( $t ) ) {
$wgOut->redirect( $t->getFullURL() );
return;
}
# No match, generate an edit URL
$t = Title::newFromText( $term );
if( ! is_null( $t ) ) {
wfRunHooks( 'SpecialSearchNogomatch', array( &$t ) );
# If the feature is enabled, go straight to the edit page
if ( $wgGoToEdit ) {
$wgOut->redirect( $t->getFullURL( 'action=edit' ) );
return;
}
}
if( $t->quickUserCan( 'create' ) && $t->quickUserCan( 'edit' ) ) {
$wgOut->addWikiMsg( 'noexactmatch', wfEscapeWikiText( $term ) );
} else {
$wgOut->addWikiMsg( 'noexactmatch-nocreate', wfEscapeWikiText( $term ) );
}
return $this->showResults( $term );
}
/**
* @param string $term
* @public
*/
function showResults( $term ) {
$fname = 'SpecialSearch::showResults';
wfProfileIn( $fname );
$this->setupPage( $term );
global $wgOut;
$wgOut->addWikiMsg( 'searchresulttext' );
if( '' === trim( $term ) ) {
// Empty query -- straight view of search form
$wgOut->setSubtitle( '' );
$wgOut->addHTML( $this->powerSearchBox( $term ) );
$wgOut->addHTML( $this->powerSearchFocus() );
wfProfileOut( $fname );
return;
}
global $wgDisableTextSearch;
if ( $wgDisableTextSearch ) {
global $wgForwardSearchUrl;
if( $wgForwardSearchUrl ) {
$url = str_replace( '$1', urlencode( $term ), $wgForwardSearchUrl );
$wgOut->redirect( $url );
return;
}
global $wgInputEncoding;
$wgOut->addHTML(
Xml::openElement( 'fieldset' ) .
Xml::element( 'legend', null, wfMsg( 'search-external' ) ) .
Xml::element( 'p', array( 'class' => 'mw-searchdisabled' ), wfMsg( 'searchdisabled' ) ) .
wfMsg( 'googlesearch',
htmlspecialchars( $term ),
htmlspecialchars( $wgInputEncoding ),
htmlspecialchars( wfMsg( 'searchbutton' ) )
) .
Xml::closeElement( 'fieldset' )
);
wfProfileOut( $fname );
return;
}
$wgOut->addHTML( $this->shortDialog( $term ) );
$search = SearchEngine::create();
$search->setLimitOffset( $this->limit, $this->offset );
$search->setNamespaces( $this->namespaces );
$search->showRedirects = $this->searchRedirects;
$rewritten = $search->replacePrefixes($term);
$titleMatches = $search->searchTitle( $rewritten );
// Sometimes the search engine knows there are too many hits
if ($titleMatches instanceof SearchResultTooMany) {
$wgOut->addWikiText( '==' . wfMsg( 'toomanymatches' ) . "==\n" );
$wgOut->addHTML( $this->powerSearchBox( $term ) );
$wgOut->addHTML( $this->powerSearchFocus() );
wfProfileOut( $fname );
return;
}
$textMatches = $search->searchText( $rewritten );
// did you mean...
if($textMatches && $textMatches->hasSuggestion()){
global $wgScript;
$fulltext = htmlspecialchars(wfMsg('search'));
$suggestLink = ''
.$textMatches->getSuggestionSnippet().'';
$wgOut->addHTML(''.wfMsg('search-suggest',$suggestLink).'
');
}
$num = ( $titleMatches ? $titleMatches->numRows() : 0 )
+ ( $textMatches ? $textMatches->numRows() : 0);
$totalNum = 0;
if($titleMatches && !is_null($titleMatches->getTotalHits()))
$totalNum += $titleMatches->getTotalHits();
if($textMatches && !is_null($textMatches->getTotalHits()))
$totalNum += $textMatches->getTotalHits();
if ( $num > 0 ) {
if ( $totalNum > 0 ){
$top = wfMsgExt('showingresultstotal',array( 'parseinline' ), $this->offset+1, $this->offset+$num, $totalNum);
} elseif ( $num >= $this->limit ) {
$top = wfShowingResults( $this->offset, $this->limit );
} else {
$top = wfShowingResultsNum( $this->offset, $this->limit, $num );
}
$wgOut->addHTML( "{$top}
\n" );
}
if( $num || $this->offset ) {
$prevnext = wfViewPrevNext( $this->offset, $this->limit,
SpecialPage::getTitleFor( 'Search' ),
wfArrayToCGI(
$this->powerSearchOptions(),
array( 'search' => $term ) ),
($num < $this->limit) );
$wgOut->addHTML( "{$prevnext}
\n" );
wfRunHooks( 'SpecialSearchResults', array( $term, $titleMatches, $textMatches ) );
} else {
wfRunHooks( 'SpecialSearchNoResults', array( $term ) );
}
if( $titleMatches ) {
if( $titleMatches->numRows() ) {
$wgOut->wrapWikiMsg( "==$1==\n", 'titlematches' );
$wgOut->addHTML( $this->showMatches( $titleMatches ) );
} else {
$wgOut->wrapWikiMsg( "==$1==\n", 'notitlematches' );
}
$titleMatches->free();
}
if( $textMatches ) {
if( $textMatches->numRows() ) {
if($titleMatches)
$wgOut->wrapWikiMsg( "==$1==\n", 'textmatches' );
else // if no title matches the heading is redundant
$wgOut->addHTML("
");
$wgOut->addHTML( $this->showMatches( $textMatches ) );
} elseif( $num == 0 ) {
# Don't show the 'no text matches' if we received title matches
$wgOut->wrapWikiMsg( "==$1==\n", 'notextmatches' );
}
$textMatches->free();
}
if ( $num == 0 ) {
$wgOut->addWikiMsg( 'nonefound' );
}
if( $num || $this->offset ) {
$wgOut->addHTML( "{$prevnext}
\n" );
}
$wgOut->addHTML( $this->powerSearchBox( $term ) );
wfProfileOut( $fname );
}
#------------------------------------------------------------------
# Private methods below this line
/**
*
*/
function setupPage( $term ) {
global $wgOut;
$wgOut->setPageTitle( wfMsg( 'searchresults' ) );
$subtitlemsg = ( Title::newFromText($term) ? 'searchsubtitle' : 'searchsubtitleinvalid' );
$wgOut->setSubtitle( $wgOut->parse( wfMsg( $subtitlemsg, wfEscapeWikiText($term) ) ) );
$wgOut->setArticleRelated( false );
$wgOut->setRobotpolicy( 'noindex,nofollow' );
}
/**
* Extract default namespaces to search from the given user's
* settings, returning a list of index numbers.
*
* @param User $user
* @return array
* @private
*/
function userNamespaces( &$user ) {
$arr = array();
foreach( SearchEngine::searchableNamespaces() as $ns => $name ) {
if( $user->getOption( 'searchNs' . $ns ) ) {
$arr[] = $ns;
}
}
return $arr;
}
/**
* Extract "power search" namespace settings from the request object,
* returning a list of index numbers to search.
*
* @param WebRequest $request
* @return array
* @private
*/
function powerSearch( &$request ) {
$arr = array();
foreach( SearchEngine::searchableNamespaces() as $ns => $name ) {
if( $request->getCheck( 'ns' . $ns ) ) {
$arr[] = $ns;
}
}
return $arr;
}
/**
* Reconstruct the 'power search' options for links
* @return array
* @private
*/
function powerSearchOptions() {
$opt = array();
foreach( $this->namespaces as $n ) {
$opt['ns' . $n] = 1;
}
$opt['redirs'] = $this->searchRedirects ? 1 : 0;
return $opt;
}
/**
* @param SearchResultSet $matches
* @param string $terms partial regexp for highlighting terms
*/
function showMatches( &$matches ) {
$fname = 'SpecialSearch::showMatches';
wfProfileIn( $fname );
global $wgContLang;
$tm = $wgContLang->convertForSearchResult( $matches->termMatches() );
$terms = implode( '|', $tm );
$off = $this->offset + 1;
$out = "\n";
while( $result = $matches->next() ) {
$out .= $this->showHit( $result, $terms );
}
$out .= "
\n";
// convert the whole thing to desired language variant
global $wgContLang;
$out = $wgContLang->convert( $out );
wfProfileOut( $fname );
return $out;
}
/**
* Format a single hit result
* @param SearchResult $result
* @param string $terms partial regexp for highlighting terms
*/
function showHit( $result, $terms ) {
$fname = 'SpecialSearch::showHit';
wfProfileIn( $fname );
global $wgUser, $wgContLang, $wgLang;
$t = $result->getTitle();
if( is_null( $t ) ) {
wfProfileOut( $fname );
return "\n";
}
$sk = $wgUser->getSkin();
//$contextlines = $wgUser->getOption( 'contextlines', 5 );
$contextlines = 2; // Hardcode this. Old defaults sucked. :)
$contextchars = $wgUser->getOption( 'contextchars', 50 );
$link = $sk->makeKnownLinkObj( $t, $result->getTitleSnippet());
//If page content is not readable, just return the title.
//This is not quite safe, but better than showing excerpts from non-readable pages
//Note that hiding the entry entirely would screw up paging.
if (!$t->userCanRead()) {
return "{$link}\n";
}
$revision = Revision::newFromTitle( $t );
// If the page doesn't *exist*... our search index is out of date.
// The least confusing at this point is to drop the result.
// You may get less results, but... oh well. :P
if( !$revision ) {
return "\n";
}
if( is_null( $result->getScore() ) ) {
// Search engine doesn't report scoring info
$score = '';
} else {
$percent = sprintf( '%2.1f', $result->getScore() * 100 );
$score = wfMsg( 'search-result-score', $wgLang->formatNum( $percent ) )
. ' - ';
}
// try to fetch everything from the search engine backend
// then fill-in what couldn't be fetched
$extract = $result->getTextSnippet();
$byteSize = $result->getByteSize();
$wordCount = $result->getWordCount();
$timestamp = $result->getTimestamp();
$redirectTitle = $result->getRedirectTitle();
$redirectText = $result->getRedirectSnippet();
$sectionTitle = $result->getSectionTitle();
$sectionText = $result->getSectionSnippet();
// fallback
if( is_null($extract) || is_null($wordCount) || is_null($byteSize) ){
$text = $revision->getText();
if( is_null($extract) )
$extract = $this->extractText( $text, $terms, $contextlines, $contextchars );
if( is_null($byteSize) )
$byteSize = strlen( $text );
if( is_null($wordCount) )
$wordCount = str_word_count( $text );
}
if( is_null($timestamp) ){
$timestamp = $revision->getTimestamp();
}
// format description
$size = wfMsgExt( 'search-result-size', array( 'parsemag', 'escape' ),
$sk->formatSize( $byteSize ),
$wordCount );
$date = $wgLang->timeanddate( $timestamp );
// format redirects / sections
$redirect = '';
if( !is_null($redirectTitle) )
$redirect = ""
.wfMsg('search-redirect',$sk->makeKnownLinkObj( $redirectTitle, $redirectText))
."";
$section = '';
if( !is_null($sectionTitle) )
$section = ""
.wfMsg('search-section', $sk->makeKnownLinkObj( $sectionTitle, $sectionText))
."";
// wrap extract
$extract = "".$extract."
";
// Include a thumbnail for media files...
if( $t->getNamespace() == NS_IMAGE ) {
$img = wfFindFile( $t );
if( $img ) {
$thumb = $img->getThumbnail( 120, 120 );
if( $thumb ) {
$desc = $img->getShortDesc();
wfProfileOut( $fname );
// Ugly table. :D
// Float doesn't seem to interact well with the bullets.
// Table messes up vertical alignment of the bullet, but I'm
// not sure what more I can do about that. :(
return "" .
'' .
'' .
'| ' .
$thumb->toHtml( array( 'desc-link' => true ) ) .
' | ' .
'' .
$link .
$extract .
" {$score}{$desc} - {$date} " .
' | ' .
'
' .
'
' .
"\n";
}
}
}
wfProfileOut( $fname );
return "{$link} {$redirect} {$section} {$extract}\n" .
"{$score}{$size} - {$date}
" .
"\n";
}
private function extractText( $text, $terms, $contextlines, $contextchars ) {
global $wgLang, $wgContLang;
$fname = __METHOD__;
$lines = explode( "\n", $text );
$max = intval( $contextchars ) + 1;
$pat1 = "/(.*)($terms)(.{0,$max})/i";
$lineno = 0;
$extract = "";
wfProfileIn( "$fname-extract" );
foreach ( $lines as $line ) {
if ( 0 == $contextlines ) {
break;
}
++$lineno;
$m = array();
if ( ! preg_match( $pat1, $line, $m ) ) {
continue;
}
--$contextlines;
$pre = $wgContLang->truncate( $m[1], -$contextchars, ' ... ' );
if ( count( $m ) < 3 ) {
$post = '';
} else {
$post = $wgContLang->truncate( $m[3], $contextchars, ' ... ' );
}
$found = $m[2];
$line = htmlspecialchars( $pre . $found . $post );
$pat2 = '/(' . $terms . ")/i";
$line = preg_replace( $pat2,
"\\1", $line );
$extract .= "${line}\n";
}
wfProfileOut( "$fname-extract" );
return $extract;
}
/**
* Generates the power search box at bottom of [[Special:Search]]
* @param $term string: search term
* @return $out string: HTML form
*/
function powerSearchBox( $term ) {
global $wgScript;
$namespaces = '';
foreach( SearchEngine::searchableNamespaces() as $ns => $name ) {
$name = str_replace( '_', ' ', $name );
if( '' == $name ) {
$name = wfMsg( 'blanknamespace' );
}
$namespaces .= Xml::openElement( 'span', array( 'style' => 'white-space: nowrap' ) ) .
Xml::checkLabel( $name, "ns{$ns}", $name, in_array( $ns, $this->namespaces ) ) .
Xml::closeElement( 'span' ) . "\n";
}
$redirect = Xml::check( 'redirs', $this->searchRedirects, array( 'value' => '1' ) );
$searchField = Xml::input( 'search', 50, $term, array( 'type' => 'text', 'id' => 'powerSearchText' ) );
$searchButton = Xml::submitButton( wfMsg( 'powersearch' ), array( 'name' => 'fulltext' ) ) . "\n";
$out = Xml::openElement( 'form', array( 'id' => 'powersearch', 'method' => 'get', 'action' => $wgScript ) ) .
Xml::openElement( 'fieldset' ) .
Xml::element( 'legend', array( ), wfMsg( 'powersearch-legend' ) ) .
Xml::hidden( 'title', 'Special:Search' ) .
wfMsgExt( 'powersearchtext', array( 'parse', 'replaceafter' ),
$namespaces, $redirect, $searchField,
'', '', '', '', '', # Dummy placeholders
$searchButton ) .
Xml::closeElement( 'fieldset' ) .
Xml::closeElement( 'form' );
return $out;
}
function powerSearchFocus() {
return "";
}
function shortDialog($term) {
global $wgScript;
$out = Xml::openElement( 'form', array(
'id' => 'search',
'method' => 'get',
'action' => $wgScript
));
$out .= Xml::hidden( 'title', 'Special:Search' );
$out .= Xml::input( 'search', 50, $term ) . ' ';
foreach( SearchEngine::searchableNamespaces() as $ns => $name ) {
if( in_array( $ns, $this->namespaces ) ) {
$out .= Xml::hidden( "ns{$ns}", '1' );
}
}
$out .= Xml::submitButton( wfMsg( 'searchbutton' ), array( 'name' => 'fulltext' ) );
$out .= Xml::closeElement( 'form' );
return $out;
}
}