Extension:GoogleSiteSearch

MediaWiki extensions manual

GoogleSiteSearch Release status: stable
Implementation	Search
Description	Adds to or replaces MW Special:Search results with Google CSE results
Author(s)	Ryan Finnie (Fo0bartalk)
Latest version	3.0 (2019-12-01)
MediaWiki	1.32+
PHP	7.0+
License	GNU General Public License 2.0 or later
Download	Download extension Git [?]: Download Git master browse repository (GitHub) commit history code review
Example	finnix.org search result
Parameters $wgGoogleSiteSearchAttributes $wgGoogleSiteSearchOnly $wgGoogleSiteSearchCSEID
Hooks used SpecialSearchResultsPrepend
Translate the GoogleSiteSearch extension if it is available at translatewiki.net
Check usage and version matrix.

The GoogleSiteSearch extension allows you to add Google Custom Search Engine (CSE) results to "Special:Search" additionally to MediaWiki search results, or optionally, replace them altogether.

Installation

• Go to the Google CSE management page and add a custom search engine. Note down the "Search engine unique ID". It should be in the format numbers:letters.
• Download and place the file(s) in a directory called GoogleSiteSearch in your extensions/ folder.

• Add the following code at the bottom of your LocalSettings.php:

  wfLoadExtension( 'GoogleSiteSearch' );
  $wgGoogleSiteSearchCSEID = 'YOUR_CSE_ID';
  

• Configure as required.
•  Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration

The following configuration paramters are available:

$wgGoogleSiteSearchCSEID

The ID of the created Google custom search engine. Required.

$wgGoogleSiteSearchOnly

Whether to replace the the MediaWiki search results. If true, only the CSE search results are shown. If false, the CSE results are shown above the MediaWiki results. Optional, defaults to false.

$wgGoogleSiteSearchAttributes

An array of optional Custom Search element attributes. For example, to make links open in a new window/tab:

$wgGoogleSiteSearchAttributes = [
    'linkTarget' => '_blank'
];

In addition, the HTML built by the extension is customizable via the "GoogleSiteSearchHTML" hook. For example:

function MyGSSHTML( $specialSearch, $term, &$html ) {
    $html .= '<p>Example append</p>';
}
$wgHooks['GoogleSiteSearchHTML'][] = 'MyGSSHTML';

See also

• Extension:GoogleCustomWikiSearch - offers similar functionality