MediaWiki  REL1_31
SearchSuggestion Class Reference

Search suggestion. More...

Collaboration diagram for SearchSuggestion:

Public Member Functions

 __construct ( $score, $text=null, Title $suggestedTitle=null, $suggestedTitleID=null)
 Construct a new suggestion. More...
 
 getScore ()
 Suggestion score. More...
 
 getSuggestedTitle ()
 Title object in the case this suggestion is based on a title. More...
 
 getSuggestedTitleID ()
 Title ID in the case this suggestion is based on a title. More...
 
 getText ()
 The suggestion text. More...
 
 getURL ()
 Suggestion URL, can be the link to the Title or maybe in the future a link to the search results for this search suggestion. More...
 
 setScore ( $score)
 Set the suggestion score. More...
 
 setSuggestedTitle (Title $title=null)
 Set the suggested title. More...
 
 setSuggestedTitleID ( $suggestedTitleID=null)
 Set the suggested title ID. More...
 
 setText ( $text, $setTitle=true)
 Set the suggestion text. More...
 
 setURL ( $url)
 Set the suggestion URL. More...
 

Static Public Member Functions

static fromText ( $score, $text)
 Create suggestion from text Will also create a title if text if not empty. More...
 
static fromTitle ( $score, Title $title)
 Create suggestion from Title. More...
 

Private Attributes

float null $score
 The suggestion score. More...
 
Title null $suggestedTitle
 the suggested title More...
 
int null $suggestedTitleID
 NOTE: even if suggestedTitle is a redirect suggestedTitleID is the ID of the target page. More...
 
string $text
 the suggestion More...
 
string $url
 the suggestion URL More...
 

Detailed Description

Search suggestion.

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 A search suggestion

Definition at line 25 of file SearchSuggestion.php.

Constructor & Destructor Documentation

◆ __construct()

SearchSuggestion::__construct (   $score,
  $text = null,
Title  $suggestedTitle = null,
  $suggestedTitleID = null 
)

Construct a new suggestion.

Parameters
float$scorethe suggestion score
string | null$textthe suggestion text
Title | null$suggestedTitlethe suggested title
int | null$suggestedTitleIDthe suggested title ID

Definition at line 60 of file SearchSuggestion.php.

References $score, $suggestedTitle, $suggestedTitleID, $text, setSuggestedTitle(), and text.

Member Function Documentation

◆ fromText()

static SearchSuggestion::fromText (   $score,
  $text 
)
static

Create suggestion from text Will also create a title if text if not empty.

Parameters
float$scoreSuggestions score
string$text
Returns
SearchSuggestion

Definition at line 177 of file SearchSuggestion.php.

References $score, $text, and Title\makeTitle().

Referenced by SearchSuggestionSet\fromStrings().

◆ fromTitle()

static SearchSuggestion::fromTitle (   $score,
Title  $title 
)
static

Create suggestion from Title.

Parameters
float$scoreSuggestions score
Title$title
Returns
SearchSuggestion

Definition at line 166 of file SearchSuggestion.php.

References $score, and $title.

Referenced by SearchSuggestionSet\fromTitles(), and SearchEngine\processCompletionResults().

◆ getScore()

SearchSuggestion::getScore ( )

Suggestion score.

Returns
float Suggestion score

Definition at line 131 of file SearchSuggestion.php.

References $score.

Referenced by SearchSuggestionSet\append(), and SearchSuggestionSet\prepend().

◆ getSuggestedTitle()

SearchSuggestion::getSuggestedTitle ( )

Title object in the case this suggestion is based on a title.

May return null if the suggestion is not a Title.

Returns
Title|null

Definition at line 95 of file SearchSuggestion.php.

References $suggestedTitle.

Referenced by SearchEngine\extractTitles(), and SearchEngine\processCompletionResults().

◆ getSuggestedTitleID()

SearchSuggestion::getSuggestedTitleID ( )

Title ID in the case this suggestion is based on a title.

May return null if the suggestion is not a Title.

Returns
int|null

Definition at line 115 of file SearchSuggestion.php.

References $suggestedTitleID.

Referenced by SearchSuggestionSet\append(), and SearchSuggestionSet\prepend().

◆ getText()

SearchSuggestion::getText ( )

The suggestion text.

Returns
string

Definition at line 74 of file SearchSuggestion.php.

References $text.

◆ getURL()

SearchSuggestion::getURL ( )

Suggestion URL, can be the link to the Title or maybe in the future a link to the search results for this search suggestion.

Returns
string Suggestion URL

Definition at line 148 of file SearchSuggestion.php.

References $url.

◆ setScore()

SearchSuggestion::setScore (   $score)

Set the suggestion score.

Parameters
float$score

Definition at line 139 of file SearchSuggestion.php.

References $score.

Referenced by SearchSuggestionSet\append(), and SearchSuggestionSet\prepend().

◆ setSuggestedTitle()

SearchSuggestion::setSuggestedTitle ( Title  $title = null)

Set the suggested title.

Parameters
Title | null$title

Definition at line 103 of file SearchSuggestion.php.

References $title, PROTO_CURRENT, and wfExpandUrl().

Referenced by __construct(), and setText().

◆ setSuggestedTitleID()

SearchSuggestion::setSuggestedTitleID (   $suggestedTitleID = null)

Set the suggested title ID.

Parameters
int | null$suggestedTitleID

Definition at line 123 of file SearchSuggestion.php.

References $suggestedTitleID.

◆ setText()

SearchSuggestion::setText (   $text,
  $setTitle = true 
)

Set the suggestion text.

Parameters
string$text
bool$setTitleShould we also update the title?

Definition at line 83 of file SearchSuggestion.php.

References $text, Title\makeTitle(), setSuggestedTitle(), and text.

◆ setURL()

SearchSuggestion::setURL (   $url)

Set the suggestion URL.

Parameters
string$url

Definition at line 156 of file SearchSuggestion.php.

References $url.

Member Data Documentation

◆ $score

float null SearchSuggestion::$score
private

The suggestion score.

Definition at line 51 of file SearchSuggestion.php.

Referenced by __construct(), fromText(), fromTitle(), getScore(), and setScore().

◆ $suggestedTitle

Title null SearchSuggestion::$suggestedTitle
private

the suggested title

Definition at line 39 of file SearchSuggestion.php.

Referenced by __construct(), and getSuggestedTitle().

◆ $suggestedTitleID

int null SearchSuggestion::$suggestedTitleID
private

NOTE: even if suggestedTitle is a redirect suggestedTitleID is the ID of the target page.

the suggested title ID

Definition at line 46 of file SearchSuggestion.php.

Referenced by __construct(), getSuggestedTitleID(), and setSuggestedTitleID().

◆ $text

string SearchSuggestion::$text
private

the suggestion

Definition at line 29 of file SearchSuggestion.php.

Referenced by __construct(), fromText(), getText(), and setText().

◆ $url

string SearchSuggestion::$url
private

the suggestion URL

Definition at line 34 of file SearchSuggestion.php.

Referenced by getURL(), and setURL().


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