2020 Group walks & events manager: Additional Features Guide Contact for further information and support: [email protected] Ramblers Charity England & Wales No: 1093577 Scotland No: SC039799 Registered office: 2nd Floor, Camelford House 87-90 Albert Embankment London SE1 7TW Group walks & events manager: Additional Features Guide Contents 1. Introduction................................................................................................................... 3 2. Linking to specific pages on the Ramblers website .................................................. 3 2.1 Linking to area and group pages ......................................................................... 3 2.2 Linking to the Find a walk tool ............................................................................. 4 2.3 Linking to individual walk details ........................................................................ 5 3. Viewing reports ............................................................................................................ 5 4. Exporting walk details as a CSV ................................................................................. 6 4.1 Select the walks .................................................................................................... 6 4.2 Export the walk details ......................................................................................... 6 4.3 Fields in the export CSV ....................................................................................... 7 5. Using feeds .................................................................................................................. 9 5.1 Types of Feed ........................................................................................................ 9 5.2 RSS, JSON feeds – Group Walks Finder ............................................................. 9 5.3 Group Walks Finder RSS feed ........................................................................... 10 5.4 JSON feeds .......................................................................................................... 10 5.5 GeoJSON feed ..................................................................................................... 11 Page 2 of 14 Version 1.3 March 2020 © Copyright Ramblers 2020. All rights reserved. MH 24/03/2020 Group walks & events manager: Additional Features Guide 1. Introduction There are three guides to help you to use the features of the group walks and events manager: Getting Started Guide for Editors: A quick start guide to getting set up on the system, adding a walk and editing walk details Editors Manual: A comprehensive manual covering the key features of group walks and events manager, including printed programmes, contacts, contributors and adding bulk walks using the spreadsheet. Additional Features Guide: Covers some of the more advanced features of the system, including feeds, viewing reports and linking to a walk. 2. Linking to specific pages on the Ramblers website 2.1 Linking to area and group pages All walks listed on the system automatically appear on the appropriate area and group pages. Group pages have a box with the next six walks; area pages have a box with the next 12 walks run not only by the area but all the area’s groups. A link to More walks takes the user to a full listing. Page 3 of 14 Version 1.3 March 2020 © Copyright Ramblers 2020. All rights reserved. MH 24/03/2020 Group walks & events manager: Additional Features Guide Area and group pages have ‘friendly urls’ in the format www.ramblers.org.uk/ group-name. You can find a list of these in the Area and Group webpages toolkit. Find your area or group page under Go walking > Find a group, or by following the clickable links from your area or group name on all your walk listings. 2.2 Linking to the Find a walk tool You can create links direct to the Find a walk search tool to show just your group’s walks. This is equivalent to what someone would see if they went to the Find a walk page and used the Walks run by filter. The simplest way to use this feature is to link to a list of all your walks using a link like this: www.ramblers.org.uk/find-a-walk.aspx?group=XX99&tab=walks where XX99 is your standard Group shortcode. For example the link to Farnham & District Group would be http://www.ramblers.org.uk/find-a-walk.aspx?group=SR03&tab=walks. You can link to other views of the Find a walk page by adding more “variables” to the web address, separated with ‘&’ symbols. • area selects walks run by a specific area and all its groups. For example area=CF shows all walks run by Forth Valley, Fife & Tayside Area and its groups. • group selects walks run by a specific group. For example group=CF05 shows all walks run by Dundee & District Group. • tab selects a particular tab on the page. o tab=map shows the interactive map o tab=walks shows the list of group walks o tab=routes shows the list of Ramblers Routes o tab=events shows the list of events • layer selects a particular layer on the interactive map o layer=walks shows group walks on the map o layer=routes shows Ramblers Routes on the map o layer=events shows events on the map o You can show more than one layer, separating them by commas, for example layer=walks,events shows both walks and events on the map • lat, lng zooms the map to a point specified by a latitude and longitude, and shows walks within a 25 mile (40 km) radius of that point. For example lat=55.952348&lng=- 3.1931979 zooms the map to show walks within a 25 mile (40 km) radius of the Scott Monument in Princes Street Gardens, Edinburgh. If you use this feature, you must provide values for both latitude and longtitude, and also provide a placename (below). The placename doesn’t have to correspond to the latitude and longtitude, Page 4 of 14 Version 1.3 March 2020 © Copyright Ramblers 2020. All rights reserved. MH 24/03/2020 Group walks & events manager: Additional Features Guide though it’s helpful if it does! You can find latitudes and longitudes for any place in Britain using various methods at www.gridreferencefinder.com. Take care with longitudes: make sure you include the minus sign (-) at the start if shown. • placename inserts a place name into the search box on the Find a walk tool. You need to use this in conjunction with latitude and longtitude (above). • force=1 should clear any previous search. The Find a Walk tool tends to remember previous searches which may occasionally lead to confusing results. So for example: http://www.ramblers.org.uk/find-a-walk.aspx?tab=map&layer= walks,events&lat=56.457653&lng=-2.9694250&placename=Dundee will link to a map showing all walks and events within a 25 mile (40 km) radius of Dundee station. 2.3 Linking to individual walk details Every walk in the system has a walk ID which is included in the address for the walk detail page. For example http://www.ramblers.org.uk/go-walking/find-a-walk-or-route/walk- detail.aspx?walkID=3633077. It’s easy to find these links simply by going to the relevant walk detail page and looking in the address bar, but the ID also appears in the detail page itself, under the map. 3. Viewing reports You can access basic reports on your group walks from the Walks & Events screen by clicking on Reports in the navigation bar. The first row gives an overall summary of your current walks (those with a date and time in the future). Underneath total published walks, you can see information regarding Total Attendance. To make sure these figures are populated, please update the details of your walk after it has taken place (see the Editors Manual). Page 5 of 14 Version 1.3 March 2020 © Copyright Ramblers 2020. All rights reserved. MH 24/03/2020 Group walks & events manager: Additional Features Guide 4. Exporting walk details as a CSV As well as uploading walks details in CSV files, you can download walks details in the same format, for example for importing into your own spreadsheets, databases or word processor tables. 4.1 Select the walks Go to the main Walks & Events screen. If you edit for more than one group, select the group you want to export details for under Show walks by (note that currently you can’t export details for more than one group at a time). Then select the walks you want to include in your export from the list of walks. You can use the search functions and change search options under the + sign. 4.2 Export the walk details Now click on Export on the bar below the walks list. Page 6 of 14 Version 1.3 March 2020 © Copyright Ramblers 2020. All rights reserved. MH 24/03/2020 Group walks & events manager: Additional Features Guide Your browser should ask you if you want to open or download a CSV file. Select Download and save the file. You can now open the file in a spreadsheet package and process the data as you choose. 4.3 Fields in the export CSV The export CSV isn’t an exact copy of the import CSV – this is because additional information which it’s useful to be able to download, such as walk IDs and days of the week, is added by the system. So the export contains all the fields in the import CSV, in the same order, but with additional fields added at the end. Fields included in the CSV are as follows: Field name Notes Date* As displayed on walk Title* As displayed on walk Description* As displayed on walk Linear or Circular* Linear/circular Starting location† Always blank Starting postcode† As displayed on walk Starting gridref† As displayed on walk Starting location details As displayed on walk Show exact starting point?* Yes/No