Search with Google

Replace WordPress default search with Google Custom Search results.

Contributors: rtCamp, Kiran Potphode, Shalin Shah

Tags: google, search, cse, custom search engine, programmable search, programmable search engine, google cse, google custom search engine, google programmable search, google programmable search engine, google search

Requires at least: 4.8

Tested up to: 6.4.2

License: GPLv2 or later

Requires PHP: 7.4

Description

This plugin will replace the WordPress default search query with server-side results from either the Custom Search Site Restricted JSON API or the Custom Search JSON API. You can make your selection within the settings > Reading > Search type. This replacement is done on the WordPress back-end, so results appear as normal within WordPress search.

Requirements

• Google API Key
• Programmable Search engine ID

Setup

• Get Google API key. An API key is a way to identify your client to Google.
• Get Programmable Search engine ID. In settings, restrict the Search engine to only search for your one site.
• On WordPress dashboard, set API Key and Custom Search Engine ID in the plugin settings. Dashboard > Settings > Reading > Search with Google Settings.
• Select the search type from Custom Search Site Restricted JSON API or Custom Search API. (Refer #Notes section for more details)

Notes

• Custom Search Site Restricted JSON API can show only 100 search results for the query.
• A result page can have maximum of 10 results.
• Assistance for Custom Site Restricted Search JSON API is scheduled to cease as of December 18, 2024. Read more. Due to this modification, we are introducing an opt-in feature that enables the use of solely the Custom Search API, as opposed to the Custom Site-restricted Search API. This will allow you to continue using the Custom Search API after December 18, 2024.
• Custom Site Search API has a daily limit of 10,000 queries per day. Read more.

Contribute

Reporting a bug 🐞

Before creating a new issue, do browse through the existing issues for resolution or upcoming fixes.

If you still need to log an issue, making sure to include as much detail as you can, including clear steps to reproduce your issue if possible.

Creating a pull request

Want to contribute a new feature? Start a conversation by logging an issue.

Once you're ready to send a pull request, please run through the following checklist:

1. Browse through the existing issues for anything related to what you want to work on. If you don't find any related issues, open a new one.

2. Fork this repository.

3. Create a branch from develop for each issue you'd like to address and commit your changes.

4. Push the code changes from your local clone to your fork.

5. Open a pull request and that's it! We'll with feedback as soon as possible (Isn't collaboration a great thing? 😌)

6. Once your pull request has passed final code review and tests, it will be merged into develop and be in the pipeline for the next release. Props to you! 🎉

BTW, We're Hiring!