RapidSearch

 


The original search addon for RapidWeaver. First developed back in 2007, RapidSearch is the easiest way of adding a convenient Google custom search to any RapidWeaver website big or small.

No techie stuff like PHP, MySQL databases or complicated software installs are required. No ugly iFrames or messy code to ruin your website appearance. No monthly or yearly subscription fees. Just everything you need in a single drag-and-drop stack, for not much more than the cost of a coffee, or three.

Simply register a new custom search with Google (the easy-to-follow instructions are shown below), drop a RapidSearch stack into your page, fill-in the required details and publish. Seriously, that's all there is to do!

RapidSearch uses the full power of the Google search engine. Each time Google indexes your website, it updates the search results automatically. So this is very-much a search solution you can setup once and forget about.

Unlike some other search plugins for RapidWeaver, RapidSearch works over your entire website; including blogs, e-commerce pages, file downloads and albums. You can configure RapidSearch to search up-to 5 separate websites or subdomains from within the same stack. RapidSearch provides safe search filters for both web and image searches. Anything you've password protected will remain strictly hidden.

RapidSearch is responsive and works in all major web browsers and devices. Plus you can be assured of this stack working reliably in all popular RapidWeaver themes and with different frameworks like Twitter Bootstrap, Zurb Foundation and UIKit. Backed by fast and friendly support direct from the developer.

System requirements

The RapidSearch stack requires the following system requirements:

  1. An Intel Mac running RapidWeaver 6 or later from Realmac Software
  2. Stacks 3.0 or later from YourHead Software
  3. A modern, HTML5 mobile responsive RapidWeaver theme (recommended)
  4. A Google account, for generating a CSE ID code

We generously provide a FREE demo version of RapidSearch which you may download using the button above. This demo can be installed onto your computer, so you can fully explore all the options provided and ensure the stack meets your requirements. The free demo version is fully functioning; with the exception that automatic updates are disabled, a credit is displayed below the stack and the stack fades out of view after 60 seconds. If you decide to purchase RapidSearch, you will get emailed a download link to an unlocked version of the stack; and any settings or content you've created with the demo will be preserved upon installing the paid version.

You can see a working example of RapidSearch below. The shadow effect is created using the Shady stack from Stacks4Stacks.

Setup instructions
RapidSearch relies on Google for search results, so with this in mind it is wise to configure things at the Google end first. Don't worry, it is quite simple to do if you follow the steps exactly in the order shown and get the important bits of information correct. Start by clicking this link and going to the Google CSE website (CSE stands for 'custom search engine'). You may get prompted to signup or login to your Google account.

Click on the Add button to start the process of creating a new custom search engine for RapidSearch to use. Google wants some basic information from you; like the website address to search, the language and what you want to name the search engine (for future reference). Don't worry about any of the Advanced Options, as RapidSearch will configure anything further that it requires. Click the Create button, when you've given Google this basic information about your new search engine.

All going well, you should now see a 'congratulations' screen, informing you that the custom search engine was successfully setup and is ready. Before you close this window, please click the Public URL button. This contains an important segment of information we need for RapidSearch.

Take a close look at the web browser address bar (in Safari you may need to go Safari > Preferences > Advanced and check the Show full website address option). You should see in the browser address bar ?cx= followed by a long string of letters and numbers (pictured below).
Stacks Image 11
 
Once you've found this ID code, copy it carefully to your clipboard or a plain text file. You'll need this ID code in RapidSearch. Then you can close this browser window. If you ever need to get the code again, just login to your Google CSE account and click the Public URL button again.

To install RapidSearch in RapidWeaver, download the .zip file. If you computer does not automatically unpack the file for you, double-click the .zip file to expand it. You should see a file named RapidSearch.stack with a yellow lego brick icon. Double-click this icon or drag and drop it onto the RapidWeaver icon in your dock. You should see a message to say the stack was installed.

You would probably want to create a new Stacks page in your RapidWeaver project specifically to host the RapidSearch stack on. So add a new stacks page to your project. It is wise to open the RapidWeaver Page Inspector and give this new page a sensible folder name of something like 'search'. The file name of index.html can be left as it is; if you have tidied links enabled in RapidWeaver.

Open the Stacks Library and search for RapidSearch. Drag and drop a copy of the stack into your webpage. Keep the stack selected in edit mode and open the settings for this stack. Straight away in the RapidSearch settings, you should see the box for your custom search ID (the code to extracted out of the web browser address bar earlier). So enter this carefully in the box (take care not to include spaces or any other characters).

You can go-ahead and change any of the other RapidSearch stack settings. Most of the settings should be self-explanatory. If you mouseover the settings, you will see an information tooltip about what each one does. RapidSearch does work to some degree inside RapidWeaver preview, but as it often the case, it is best to get a page published to a live web server online to make sure everything is working as expected.

And this is about all there is towards setting up RapidSearch! As you can hopefully see, it's relatively easy to do; and undoubtedly that's the reason this stack has always been so popular. The important bit to get right is the CSE code from Google, and once you have that then things should work as expected. If you do have any further questions about the capabilities of RapidSearch or how to get it working, feel free to get in contact with us, and we'll be happy to assist. Our FAQ page also covers a number of topics.

Optimizing your website for SEO (search engine optimization)
RapidSearch uses Google search results. Therefore it is of paramount importance your website is already performing well in Google search results or you have the correct pieces in place to ensure your new website will do well on Google in future.

The best way to ensure Google reliably indexes your website on a regular basis is to setup a free Google Webmaster Tools account, if you've not done so already. Here you can directly feed Google a copy of your sitemap.xml file that RapidWeaver automatically generates. This file updates every time something changes on your website (you might have seen it briefly listed in the progress window when publishing a website). The sitemap.xml file is stored in the root directory of your website, so if your website address is http://example.com then the sitemap.xml file will be at http://example.com/sitemap.xml at all times. Google will check your sitemap.xml file every couple of hours. If it sees something has changed, it will send-along a search bot to analyze the page in closer detail and readjust that part of its search index. It's all very clever stuff! As always, the more optimized your website is, the faster these changes will show in RapidSearch.

An excellent free article on RapidWeaver SEO was published on the ThemeFlood themes knowledgebase and worked really well for thousands of people. More recently, Realmac Software have put together this training course about SEO. We can also be hired to perform audits of your website SEO and make suggestions of simple and safe changes you can implement to better your SEO score. Please get in contact if this is something you are interested in knowing more about.
Thanks! Please check the following:
System requirements
This stack requires RapidWeaver and the YourHead Stacks plugin. It will not work with other platforms (like Wordpress). We recommend you aim towards installing the latest version of RapidWeaver that your computer is capable of running (preferably RapidWeaver 6 or greater) and Stacks 3 or later.

License agreement
You may use this purchased stack an unlimited number of times in personal or commercial projects, request technical support and receive free updates in future.

This stack can be installed or synced onto all computers that you own. You are permitted to make archival backup copies of the stack.

You may not resell or make this stack available for download, remove copyright credits or license information.

The software is provided "as is" without any implied or expressed warranty of merchantability or fitness for purpose. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise arising from, out of or in connection with the software or the use or other dealings in the software.

Refund policy
By purchasing this stack, you agree that your purchase will be available immediately via digital download and that you waive your statutory right of withdrawal.

All purchases are final and refunds will not be provided (we physically cannot un-download or remove stacks from your computer).

You are reminded to make use of the free demo version already provided on the website, to fully evaluate this stack for compatibility and suitability before purchase.

Customer support
If you have questions that relate specifically to this stack, you should make contact via the support page. We aim to answer all messages within 12 hours, Monday to Friday.

If you require a faster response at weekends or during public holidays, please post your question(s) to the RapidWeaver forums, where a support volunteer may be able to assist you quicker.