Thanks! Please check the following:
Please read carefully! All purchases are final. Refunds will not be provided under any circumstances.

System requirements
License agreement
Refund policy
Purchase process
Customer support

System requirements
All the stacks sold through this website require RapidWeaver and the Stacks plugin. They will not install or work with any other publishing platforms (like Flow, Drupal, Blocs or Wordpress).

We recommend you aim towards installing the latest version of RapidWeaver that your computer is capable of running (preferably RapidWeaver 7 or greater) and Stacks 3 or later. Both are a separate purchase if you do not own them already.

Stacks4Stacks generously provides you fully-functioning free demo versions of everything sold on this website. This enables you to fully test addons before committing to a purchase. There are no time or functionality limitations applied.

If you cannot get the free demo version to work, DO NOT proceed with purchasing the stack - because the purchased stack is unlikely to work any better for you. Please request technical assistance first.

License agreement

You may use a purchased stack an unlimited number of times in personal or commercial projects and request technical support.

We permit you to install stacks onto all computers that you own. You are permitted to make private archival backup copies (e.g. iCloud, Disk Blaze, Google Drive or Dropbox).

You may not resell, redistribute or make a stack available for download, remove copyright credits, license information, or claim the stack to be your own creation. This includes free stacks, demo stacks or paid stacks, in modified or unmodified states.

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 from this website, 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. Refunds cannot be provided (we physically cannot un-download or remove stacks from your computer) under any circumstances.

You are reminded to make use of the free demo versions already provided on the website, to fully evaluate stacks for compatibility and suitability before making a purchase.

If you cannot get the free demo version to work, DO NOT proceed with purchasing the stack - because the purchased stack is unlikely to work any better for you. Please request technical assistance first.

Be certain that the stack you are buying is actually the one you want, and that you don't already own it or are confusing it with another stack of similar name or functionality.

Purchase process
The checkout system is provided by Paddle. An attempt is made to display prices in your local currency, with relevant taxes applied.

To complete your order, you must supply a valid email address. Your purchase receipt and download link will be sent to this address you supply. If you do not receive your purchase shortly after completing it, please carefully check your spam or junk mail folders.

Your purchases are available to re-download at anytime, via this secure order lookup page.

Prices shown on the website include any applicable VAT or sales tax. You will be sent a full receipt by email. Charitable and bulk discounts may be available on request. Please get in touch if you have any queries about our pricing.

Our order process is conducted by our online reseller is the Merchant of Record for all our orders. Paddle provides all customer service inquiries relating to order processing. Paddle also provides an order lookup system, commonly referred to as your Paddle Account.

Customer support
If you have questions that relate specifically to a stack, you should make contact via the contact page.

General questions can be asked on the RapidWeaver Community Forums.
As you would expect, Locator is compatible with all common web browsers and devices. On narrower screens, the location list reflows to display under the map container. As a bonus feature, clicking the 'Directions' link against a list item opens the full Google Maps website or app; giving users step-by-step instructions and an estimate of time for getting to the location (directions are only supported with XML data types). You will find Locator to be a remarkably clever and flexible stack to use; invaluable for use in dozens of different projects.

Locator is using Google Maps API 3. The database of store locations can be generated from an exported Google Earth KML file or manually coded in either XML or JSON formats. A great many options are provided in Locator, making it the most customisable solution of its kind available for RapidWeaver.

Of course, Locator is not only limited to displaying the location of businesses. It can also be leveraged to display other data on a Google Map. Locator could quite easily be used to display a map of sporting fixtures, campuses, real estate for sale, events, places of interest, businesses and just about any other spacial data. Likewise Locator can be configured to just display just a simple static map with one highlighted pin (no search box or list of locations). Locator is a highly configurable map stack which offers excellent value for money.

A visitor to your website starts a location search, by entering a town name or other location in the search box. Or you can enable auto-geolocation (if your website has SSL support). When a location search is run, the location from the user is geocoded and compared to locations in your database. The locations are shown visually on a Google Map (with map pins) and the details of the locations are also shown (closest first) as an interactive list. Clicking pins or location items brings the details of that pin into view.


Here is a working example of Locator, with all the default options applied.


      Follow these setup instructions carefully for adding Locator to your website. Please note that Stacks 3.5 or later is required.
      1. Once installed into Stacks / RapidWeaver, open the Stacks Library and search for 'locator'
      2. Drag and drop a copy of the stack into your webpage
      3. In the stack settings provide your Google Maps API key. If you don't know what one of these is, read the chapter below
      4. Choose the data type and source, for your locations. Locator supports exported Google Earth KML files or a manually coded database of locations in either XML or JSON formats. Please read the details below carefully, regarding data formats available to use
      5. Customise any of the other stack settings, like styles or localisations
      6. Preview your webpage in RapidWeaver. Test the search box to make sure the map and locations are shown.

      Locator contains complex Javascript code that needs to be loaded in a specific order. Therefore we advise against using Locator on complicated webpages that feature lots of sliding, toggle or parallax features. Locator may conflict with some other stacks, so please make use of the free demo provided. Only a single locator stack can be used per-page.

      Support policy: We are happy to answer basic, general questions about the stack and discuss things like simple CSS modifications. We cannot provide detailed one-to-one support with either getting an API key from Google setup or generating your database of locations. These latter tasks are outside of our normal free support remit, and therefore billable by the hour. You can get in contact via the support page, to discuss your requirements.

      Locator comprises of a very long list of customisable options. Don't be put-off by how complicated the stack looks; many of the settings can be ignored for basic use. As always, hovering your mouse over individual settings will display an informational tooltip. These tooltips contain useful information.

      Data formats

      Locator needs a simple database of locations, that it can pin onto the map and display the closest locations in a list. We currently give you the option of three data file formats; these being KML, XML or JSON formats.

      By far the easiest way to create your database of locations file is in Google Earth (this is a free download). Within Google Earth, create a new folder (Add > Folder) and add pins. You'll find that you can drag these pins around on the map. Each pin can be assigned information and simple HTML markup. HTML tags like <br> can be used to line-break longer addresses or other info. Once done, select the new folder in the Places sidebar containing your pins, click File > Save > Save Places, and export the file in KML format. Add the KML file to your RapidWeaver project (as a resource) or publish it to your web server. In the Locator settings, link to your generated KML file. KML requires no complicated coding. As discussed above, basic HTML might be needed to improve the appearance of pin information. KML also carries the benefit of letting you re-open files at a later time (in Google Earth) to edit them again. Google Earth is widely available for different operating systems, as a free download. Many tutorials exist for Google Earth if you have not used it before. You can download a sample KML locations file here (right-click and 'save as' if the link does not work in your browser).

      We actually recommend XML as the preferred format, because it offers a 'structured' template to supply Locator all the required information it needs. Through using XML, you will be able to make use of features like directions. XML files are surprisingly easy to open in any code editor and work with. You can clearly see all the data for each location. It really isn't much more difficult than editing a spreadsheet! Latitude and longitude coordinates can be extrapolated from Google Earth (moving your mouse cursor over a map displays the coordinates in the status bar). Within titles or descriptions, replace any special characters (like ampersands) with HTML entity equivalents. Once done with your editing, the XML file can be saved. Attach your XML file as a resource in RapidWeaver or upload it to the web server and link to it from there. You can download a sample XML locations file here (right-click and 'save as' if the link does not work in your browser).

      The third and final option for data is JSON format. If you have previously built a store locator for Wordpress or a similar platform, then your data was probably saved into a MySQL database table. Often the only way to export that data is in JSON format. Therefore this data format provides a useful ability to reuse store location data you may have previously created for another platform or addon. You can download a sample JSON locations file here (right-click and 'save as' if the link does not work in your browser).

      Generating your Google Maps API key

      An API key needs to be registered with Google, before you to use Locator on your website. The Google website has the most up-to-date information available on generating API keys, so please refer to this link:

      The API key supplied with Locator is fine to use for quick, casual testing. But this key is prone to being cancelled or changed at any time (without warning). So you really must register your own API key, if you intend to use the stack in your website.

      It is recommended that you signup for email notifications, so that Google can send you any important notifications or give you advanced notice of any possible future changes to your API keys. API key generation can sometimes take a couple of minutes, so please be patient and keep the browser window open! Other than needing the Geocode API, normally the API key Google generates does not need any other 'credentials' or 'permissions' applied to it. Locator is quite clever, in that it can talk-back to Google servers to request anything further it needs.

      Give your API key a distinct name like 'My Locator Stack'. Make a note of the API key (it will look like a random string of letters and numbers). If you anticipate that your store locator is going to be very popular, carefully review the API usage. In extreme circumstances, you may need to purchase additional allowances.