SearchHighlighter Class Reference

Highlight bits of wikitext. More...

Public Member Functions
	__construct ($cleanupWikitext=true)
	caseCallback ($matches)
	Do manual case conversion for non-ascii chars. More...
	extract ($text, $start, $end, &$posStart=null, &$posEnd=null)
	Extract part of the text from start to end, but by not chopping up words. More...
	highlightNone ($text, $contextlines, $contextchars)
	Returns the first few lines of the text. More...
	highlightSimple ($text, $terms, $contextlines, $contextchars)
	Simple & fast snippet extraction, but gives completely unrelevant snippets. More...
	highlightText ($text, $terms, $contextlines, $contextchars)
	Wikitext highlighting when $wgAdvancedSearchHighlighting = true. More...
	linkReplace ($matches)
	callback to replace [[target|caption]] kind of links, if the target is category or image, leave it More...
	position ($text, $point, $offset=0)
	Find a nonletter near a point (index) in the text. More...
	process ($pattern, $extracts, &$linesleft, &$contextchars, &$out, &$offsets)
	Search extracts for a pattern, and return snippets. More...
	removeWiki ($text)
	Basic wikitext removal. More...
	splitAndAdd (&$extracts, &$count, $text)
	Split text into lines and add it to extracts array. More...

Protected Attributes
	$mCleanWikitext = true

Detailed Description

Highlight bits of wikitext.

Definition at line 29 of file SearchHighlighter.php.

Constructor & Destructor Documentation

SearchHighlighter::__construct

(

$cleanupWikitext = true

)

Definition at line 32 of file SearchHighlighter.php.

Member Function Documentation

SearchHighlighter::caseCallback

(

$matches

)

Do manual case conversion for non-ascii chars.

Parameters

array

$matches

Returns

string

Definition at line 310 of file SearchHighlighter.php.

References $matches, $wgContLang, and global.

SearchHighlighter::extract	(		$text,
			$start,
			$end,
		&	$posStart = null,
		&	$posEnd = null
	)

Extract part of the text from start to end, but by not chopping up words.

Parameters

string	$text
int	$start
int	$end
int	$posStart	(out) actual start position
int	$posEnd	(out) actual end position

Returns

string

Definition at line 329 of file SearchHighlighter.php.

References position().

Referenced by highlightText(), and process().

SearchHighlighter::highlightNone	(		$text,
			$contextlines,
			$contextchars
	)

Returns the first few lines of the text.

Parameters

string	$text
int	$contextlines	Max number of returned lines
int	$contextchars	Average number of characters per line

Returns

string

Definition at line 547 of file SearchHighlighter.php.

SearchHighlighter::highlightSimple	(		$text,
			$terms,
			$contextlines,
			$contextchars
	)

Simple & fast snippet extraction, but gives completely unrelevant snippets.

Used when $wgAdvancedSearchHighlighting is false.

Parameters

string	$text
array	$terms	Escaped for regex by SearchDatabase::regexTerm()
int	$contextlines
int	$contextchars

Returns

string

Definition at line 496 of file SearchHighlighter.php.

References $line, $lines, $pre, $wgContLang, as, and global.

SearchHighlighter::highlightText	(		$text,
			$terms,
			$contextlines,
			$contextchars
	)

Wikitext highlighting when $wgAdvancedSearchHighlighting = true.

Parameters

string	$text
array	$terms	Terms to highlight (not html escaped but regex escaped via SearchDatabase::regexTerm())
int	$contextlines
int	$contextchars

Returns

string

Definition at line 46 of file SearchHighlighter.php.

References $count, $last, $line, $matches, $processed, $term, $wgContLang, as, extract(), global, NS_FILE, process(), and splitAndAdd().

SearchHighlighter::linkReplace

(

$matches

)

callback to replace [[target|caption]] kind of links, if the target is category or image, leave it

Parameters

array

$matches

Returns

string

Definition at line 469 of file SearchHighlighter.php.

References $matches, $wgContLang, global, NS_CATEGORY, and NS_FILE.

SearchHighlighter::position	(		$text,
			$point,
			$offset = 0
	)

Find a nonletter near a point (index) in the text.

Parameters

string	$text
int	$point
int	$offset	Offset to found index

Returns

int Nearest nonletter index, or beginning of utf8 char if none

Definition at line 361 of file SearchHighlighter.php.

References $s.

Referenced by extract().

SearchHighlighter::process	(		$pattern,
			$extracts,
		&	$linesleft,
		&	$contextchars,
		&	$out,
		&	$offsets
	)

Search extracts for a pattern, and return snippets.

Parameters

string	$pattern	Regexp for matching lines
array	$extracts	Extracts to search
int	$linesleft	Number of extracts to make
int	$contextchars	Length of snippet
array	$out	Map for highlighted snippets
array	$offsets	Map of starting points of snippets

Access:

protected

Definition at line 402 of file SearchHighlighter.php.

References $line, $out, as, and extract().

Referenced by highlightText().

SearchHighlighter::removeWiki

(

$text

)

Basic wikitext removal.

Access:

protected

Parameters

string

$text

Returns

mixed

Definition at line 445 of file SearchHighlighter.php.

Referenced by splitAndAdd().

SearchHighlighter::splitAndAdd	(	&	$extracts,
		&	$count,
			$text
	)

Split text into lines and add it to extracts array.

Parameters

array	$extracts	Index -> $line
int	$count
string	$text

Definition at line 294 of file SearchHighlighter.php.

References $count, $line, as, and removeWiki().

Referenced by highlightText().

Member Data Documentation

SearchHighlighter::$mCleanWikitext = true

protected

Definition at line 30 of file SearchHighlighter.php.

---

The documentation for this class was generated from the following file:

• includes/search/SearchHighlighter.php