Custom Google Search
INACTIVE NOTICE: This plugin is unsupported by WPMUDEV, we've published it here for those technical types who might want to fork and maintain it for their needs.
Translation files can be found at https://github.com/wpmudev/translations
Custom Google Search leverages the awesome power of the world's number one search engine to enhance your sites search results.
Activate this plugin and instantly make the search tool on your site infinitely more powerful. Eliminate lists of irrelevant results with search powered by Google.
Get better search results instantly
Enhanced WordPress search
Make sure your users always find what they are looking for. Enhance WordPress with the most powerful search engine on the web.
For help with installing plugins please refer to our Plugin installation guide. Once installed login to your admin panel for WordPress or Multisite and activate the plugin:
- On regular WordPress installs – visit Plugins and Activate the plugin.
- For WordPress Multisite installs – Activate it blog-by-blog (say if you wanted to make it a Pro Sites plugin), or visit Network Admin > Plugins and Network Activate the plugin.
Once activated, you'll see a new menu item in your admin: Settings > Custom Google Search.
Create a custom search engine at Google
To use the plugin, you'll first need to create a custom search engine through Google, you can do that here: Google Custom Search Simply select to create a new search engine, you'll then see a few options.
1. Enter the sites you wish to search.
2. Enter a name of the custom search.
3. Click the CREATE button to create the search engine.
You'll see a Congratulations page, where you'll be presented with a few buttons.
Click the 'Get code' button. You'll be taken to a page displaying the HTML script code you'll use to include your custom search in your site.
Select the code, then copy it to your computer's clipboard (press CTRL-C on PC, CMD-C on Mac). We'll use that copied code within the plugin's settings.
Configure the Settings
Let's check out the settings, go to Settings > Custom Google Search.
Paste the code that you previously copied from Google into the 'Embed Code/Search ID' field. Select from the 'Display search results as' options as follows:
- Standard Page - results will be displayed in a search page using the standard page template.
- Search Page - shows results in the theme's search template.
- Generated Page (risky) - will display a full width search with no sidebar.
Select a Style for the visual display of search elements. You'll have the following options:
Tick the 'Open clicked search result in same window' option in order to have clicked links show in the same window, otherwise they will open in a new window. Tick the 'Hide search button' option so the search button won't be seen, users can simply press the ENTER key to execute searches. Tick the 'Show sidebar on search page' in order to show a sidebar when using the Generated Page option above. Specify your site's protocol from the following:
- Protocol-relative URLs
Select a theme for the popup used by the widget from the following:
Custom Google Search Widget
There will also be a new widget available at Appearance > Widgets:
For the 'Display results' option, you can select from the following:
- in pop-up - displays results in a pop-up, using the theme specified in settings.
- at bottom of widget - displays results within the widget.
- on search page - takes user to search page where results are shown.
The Front-end Experience
Custom Google Search integrates with WordPress and replaces standard searches with Google search results. Results will be shown depending on your settings. Here's how it looks with relatively default settings, using the Default style:
You'll also be able to access searches directly, just as with regular WordPress searches, like so: yoursite.com/?s=wpmu Simply replace the 'wpmu' with your own search term.
We hope you enjoy using Google Custom Search and that it provides great search features for your site!