v3.0.0

v3.0.0 brings compatibility with Perch 3 alongside some minor updates.

Key Features

• Customisable addressSlug and URL options, similar to Perch Blog
• Initial support for the Perch 3 Import APIs
• UI updated to use Perch 3's new SmartBar and AdminListing APIs
• FieldType is now included as part of the application

Upgrading

Copy the new folder over the existing root_locator directory. Once logged into Perch, visit the application which will begin updating older address records with a new addressSlug field.

As always we recommend backing up and testing the update first on a local development copy.

v2.1.0

v2.1.0 adds some requested features to the Locator app to make importing large data sets more pleasant. Additionally, there is a new custom field type that allows locator data to be included in other areas of Perch.

Key Changes

• Custom field support has been re-added to the import process. Including additional columns in the CSV will include the data in the addressDynamicFields store.
• Added a new field type. Instructions can be found here: [](Locator Field Type)
• Updated composer packages to their latest versions.

Upgrading

Upgrading can be completed by simply overwriting the existing addons/root_locator directory with this latest release. There are no database or template changes.

For upgrading from v1.x, please check the guide in the readme.

v2.0.0

Version 2 of the locator up is a ground-up rewrite to allow greater flexibility in how you are able to use and manage locatable data within your front-end templates.

Key Changes

• Locations can be listed, filtered and searched using the native Perch filtering API. Previously only searches could return data.
• Locations are now searchable in the native Perch search handler. For Runway based sites, locations can be searched in the admin panel - useful for sites with many addresses
• The queue handling system has been rewritten to prevent failed jobs clogging the geocoding queue. Jobs will be attempted 3 times before being classes as failed. If the API quota is reached the entire queue is rescheduled for 24 hours later.
• Simplified CSV importing.
• JSON output is controlled through templates - this gives you greater control over the returned data and any custom fields that you wish to add.
• Internal library updates make sure the core of the application runs on the latest possible technology.
• UI improvements to better match the current Perch conventions - and in preparation of the coming 2.9 release.
• The previous app prefixes have been replaced with the standardised Root Studio app namespace.

Upgrading

A full upgrade guide for those running v1.x can be found in the new README. Previous locations can be imported into the new version but there will be breaking template and API changes.

Missing Features

Due to time and scope refocusing some previous features have been removed. These will be re-added in forthcoming releases once they have been reviewed and reimagined.

Support

We are a busy studio producing numerous Perch and bespoke websites every month. There are only a few of us so it is not always possible to give our full attention to these applications. Bugs will be fixed when they occur on our client websites and security fixes will be given top priority as would be expected. Requests will be considered but we are not able to commit ourselves to providing regular feature updates.

v1.1.2

Fixes an issue where repeatedly failing jobs could block the queue.

v1.1.1

This release aims to tidy up some minor issues that have been experienced while using the app on production websites.

Google APIs

Due to a recent policy update, Google's APIs now require API keys. In order to ensure this application works reliably it's recommended that you should create and set the key in the Perch settings region. In the Google API Console you should enable:

• Google Maps API
• Google Static Maps API

For more information, see Issue #14.

Change Log

• Adds more UI text into Perch's $Lang api
• Fixes some text issues with Page titles and alert bars
• Fixes some minor PHP warning outputs when certain data is not available
• Adds more elegant error handling when unable to connect to Google's API
• Due to recent Google policy changes, the app will now warn users if they do not have an API key set.
• Adds some example Google Maps integration code
• Adds a character range filter to help users sort through large location data on the main listing page.
• Under the hood changes to tidy up the codebase and avoid using breakable conditional code.

v1.1.0

This release improves the functionality of CSV importing, making them more robust in the event of failure and hooking into the categories / dynamic fields of Perch. This release also fixes some bugs when returning data with unprocessed location data.

Additionally, some language bugs have been squashed to prevent some admin UI strangeness.

Change Log

• Do not return locations if no marker is associated bug
• Removed required fields from addresses enhancement
• Location listing order needs to be reversed bug
• Labels incorrect on batch size select field bug
• '10' on category field on location add/edit page bug
• Category data should be added to JSON output enhancement
• CSV imports need to have category mapping support enhancement
• CSV Error handling needs to display failed rows enhancement
• CSV imports should automatically populate dynamic fields enhancement

Initial Release

Initial release with CSV import support, basic templating and Geocoding capabilities.

v1.0.1

Fixes minor issues with results listing

• Missing 'markerDistance' property for non-distance based searches
• Distances are now in order for address based queries.