{"id":"6960337771c75ce9dfa2bc14","title":"2026 01 08","path":"how-to/committee/release-notes/2026-01-08","contentMarkdown":"# 08-Jan-2026 — Advanced search & Server Pagination [ref: #110](https://github.com/nbarrett/ngx-ramblers/issues/110)\n\n## [build 408](https://github.com/nbarrett/ngx-ramblers/actions/runs/20834044019) — [commit 3399b3e](https://github.com/nbarrett/ngx-ramblers/commit/3399b3e6ef5567ef21777a13f331ee54c3c2240e)\n\n\nThis feature was motivated by the need for walks and events view to be viewable for a group or area website and for any walk filter to return results performantly. It's likely that for an area (e.g. Kent) there could be 3,000 — 6,000 walks in history, so it's important that querying this data in any way should still deliver a fast user experience. Before this release, all walks within a date range (regardless of whether they were on the current page), were queried and returned to the browser which took a long time if  the **All Walks**  date range filter was selected.\n### Finding the Walks Page\n- Go to the Walks Programme at `https://<your-site>/walks`. If there is less than 1 page of walks (10 walks per page), no pagination controls will be visible.\n- The display of walks is still the same as it was before but there are initially two visible differences — the **Date Range Selector**, and the **Advanced Search** button — both on the top row of the walks view. \n- The initial selection is **All Walks Today Onwards**, and **Advanced Search** is hidden.  In the screenshot below the **Date Range Selector** has been clicked to show all available options:\n\n![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/832db6ee-1787-4119-bf1b-0ee6c2e5dd43.jpeg)\n\n  - When you now make a walk filtering change in this view, your filter is sent to the server, and you receive only the rows for the current page so performance stays consistent even with thousands of walks in the filter.\n- As an alternative to above, the screenshot below shows a **Past 3 Months** date range filter which returns 16 walks therefore the pagination controls are displayed:\n\n\n![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/e3239c68-093a-419c-9ffd-92983d975c75.jpeg)\n\n\n  ### Advanced Search Details \n  - Opening **Advanced Search** reveals sliders for date and distance, multi-selects for leaders and (in area mode) group codes, day-of-week and grading pickers, accessibility/facility toggles, plus free/cancelled switches:\n\n![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/1c322dc1-bc25-4d22-ab6f-1549eee3ebac.jpeg)\n\n### General Search Fields \n\n\n- Date range selection with slider and preset buttons (Today, 7 Days, 30 Days,\n3 Months, 6 Months, 1 Year, All Time)\n- Custom date range with configurable amount and unit (days/weeks/months/years)\n- Distance range slider to filter walks by length in miles or km\n- Walk leader multi-select dropdown with search capability. Values are populated from the events within the selected date range, ensuring only relevant leaders appear.\n- Multi-select Group code filter exists for multi-group or area sites\n\n\n- Day of week filter to find walks on specific days\n- Difficulty level filter (Easy, Leisurely, Moderate, etc.)\n- Accessibility options filter\n- Facilities filter\n- Free & cancelled walks toggle\n- Changes are made in the URL so you can bookmark a search and go back to it at a later date.\n\n\n* Changing any of the values in the filter view above should change the filtered results in real-time. \n### Walk Search by location\n- The Location Search field provides you with the ability to enter a location or postcode and for the location to be automatically located on the map.\n- Proximity controls let you use your current location or enter a postcode/place, adjust a 1–50 mile radius slider, and preview the coverage on a map before applying it.\n#### Searching for walks in your location\nIf you want to find walks that are close to you, click the **Current Location**:\n\n![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/1f8d54d4-bb43-4b00-afac-bd5db3db27b1.jpeg)\n\n ### Searching for walks in a specific location\nIf you want to find walks that are close to a specific location click **Enter Location**:\n\n![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/facd2b3c-7687-46f2-b211-d6696119d105.jpeg)\n\n\n  ## Intialising Local Data\n\n- The site no longer fetches walks live from the Ramblers feed; instead, it relies on a local copy in the database. That means that when this release is deployed, an empty programme exists until someone runs the sync from the admin panel, so part of “getting the site ready” is making sure you pull\n  down the latest walks before launch.\n- Admins manage this data at `https://<your-site>/admin/system-settings?tab=external-systems`. The last sync time is displayed and a “Sync Now (Incremental)” for the past week or **Full Sync (All Time)** exists.\n\n\n![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/c347f6ec-63bf-426c-a418-ba67f256088f.jpeg)\n\n- A background cron job runs every six hours for installations configured with `WALKS_MANAGER` or` HYBRID` populations, keeping the cache fresh even if no admin manually triggers a sync.\n\n![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/20389de5-6680-4082-bdf6-7354dee045de.jpeg)\n\n## Sync Now vs Full Sync 💡\nYou might be wondering what the difference between the two syncs  buttons are:\n- **Sync Now (incremental)** - This is the one you want for day-to-day use. It only fetches walks that have been added or changed since the last sync ran, so it typically completes in a few seconds. If you've just amended or cancelled one or two walks on Walks Manager, hit this button and the website will reflect your changes almost immediately.\n- **Full Sync (All Time)** - This re-downloads every walk from the Ramblers API from scratch, which takes longer depending on how many walks your group has. You'd really only need this when setting up a brand new website that has no walk data yet. For normal day-to-day updates it's not necessary.","contentHtml":"<h1>08-Jan-2026 — Advanced search &amp; Server Pagination <a href=\"https://github.com/nbarrett/ngx-ramblers/issues/110\">ref: #110</a></h1>\n<h2><a href=\"https://github.com/nbarrett/ngx-ramblers/actions/runs/20834044019\">build 408</a> — <a href=\"https://github.com/nbarrett/ngx-ramblers/commit/3399b3e6ef5567ef21777a13f331ee54c3c2240e\">commit 3399b3e</a></h2>\n<p>This feature was motivated by the need for walks and events view to be viewable for a group or area website and for any walk filter to return results performantly. It&#39;s likely that for an area (e.g. Kent) there could be 3,000 — 6,000 walks in history, so it&#39;s important that querying this data in any way should still deliver a fast user experience. Before this release, all walks within a date range (regardless of whether they were on the current page), were queried and returned to the browser which took a long time if  the <strong>All Walks</strong>  date range filter was selected.</p>\n<h3>Finding the Walks Page</h3>\n<ul>\n<li>Go to the Walks Programme at <code>https://&lt;your-site&gt;/walks</code>. If there is less than 1 page of walks (10 walks per page), no pagination controls will be visible.</li>\n<li>The display of walks is still the same as it was before but there are initially two visible differences — the <strong>Date Range Selector</strong>, and the <strong>Advanced Search</strong> button — both on the top row of the walks view. </li>\n<li>The initial selection is <strong>All Walks Today Onwards</strong>, and <strong>Advanced Search</strong> is hidden.  In the screenshot below the <strong>Date Range Selector</strong> has been clicked to show all available options:</li>\n</ul>\n<p><img src=\"https://ngx-ramblers.org.uk/api/aws/s3/site-content/832db6ee-1787-4119-bf1b-0ee6c2e5dd43.jpeg\" alt=\"\"></p>\n<ul>\n<li>When you now make a walk filtering change in this view, your filter is sent to the server, and you receive only the rows for the current page so performance stays consistent even with thousands of walks in the filter.</li>\n<li>As an alternative to above, the screenshot below shows a <strong>Past 3 Months</strong> date range filter which returns 16 walks therefore the pagination controls are displayed:</li>\n</ul>\n<p><img src=\"https://ngx-ramblers.org.uk/api/aws/s3/site-content/e3239c68-093a-419c-9ffd-92983d975c75.jpeg\" alt=\"\"></p>\n<h3>Advanced Search Details</h3>\n<ul>\n<li>Opening <strong>Advanced Search</strong> reveals sliders for date and distance, multi-selects for leaders and (in area mode) group codes, day-of-week and grading pickers, accessibility/facility toggles, plus free/cancelled switches:</li>\n</ul>\n<p><img src=\"https://ngx-ramblers.org.uk/api/aws/s3/site-content/1c322dc1-bc25-4d22-ab6f-1549eee3ebac.jpeg\" alt=\"\"></p>\n<h3>General Search Fields</h3>\n<ul>\n<li><p>Date range selection with slider and preset buttons (Today, 7 Days, 30 Days,\n3 Months, 6 Months, 1 Year, All Time)</p>\n</li>\n<li><p>Custom date range with configurable amount and unit (days/weeks/months/years)</p>\n</li>\n<li><p>Distance range slider to filter walks by length in miles or km</p>\n</li>\n<li><p>Walk leader multi-select dropdown with search capability. Values are populated from the events within the selected date range, ensuring only relevant leaders appear.</p>\n</li>\n<li><p>Multi-select Group code filter exists for multi-group or area sites</p>\n</li>\n<li><p>Day of week filter to find walks on specific days</p>\n</li>\n<li><p>Difficulty level filter (Easy, Leisurely, Moderate, etc.)</p>\n</li>\n<li><p>Accessibility options filter</p>\n</li>\n<li><p>Facilities filter</p>\n</li>\n<li><p>Free &amp; cancelled walks toggle</p>\n</li>\n<li><p>Changes are made in the URL so you can bookmark a search and go back to it at a later date.</p>\n</li>\n</ul>\n<ul>\n<li>Changing any of the values in the filter view above should change the filtered results in real-time.</li>\n</ul>\n<h3>Walk Search by location</h3>\n<ul>\n<li>The Location Search field provides you with the ability to enter a location or postcode and for the location to be automatically located on the map.</li>\n<li>Proximity controls let you use your current location or enter a postcode/place, adjust a 1–50 mile radius slider, and preview the coverage on a map before applying it.</li>\n</ul>\n<h4>Searching for walks in your location</h4>\n<p>If you want to find walks that are close to you, click the <strong>Current Location</strong>:</p>\n<p><img src=\"https://ngx-ramblers.org.uk/api/aws/s3/site-content/1f8d54d4-bb43-4b00-afac-bd5db3db27b1.jpeg\" alt=\"\"></p>\n<h3>Searching for walks in a specific location</h3>\n<p>If you want to find walks that are close to a specific location click <strong>Enter Location</strong>:</p>\n<p><img src=\"https://ngx-ramblers.org.uk/api/aws/s3/site-content/facd2b3c-7687-46f2-b211-d6696119d105.jpeg\" alt=\"\"></p>\n<h2>Intialising Local Data</h2>\n<ul>\n<li>The site no longer fetches walks live from the Ramblers feed; instead, it relies on a local copy in the database. That means that when this release is deployed, an empty programme exists until someone runs the sync from the admin panel, so part of “getting the site ready” is making sure you pull\ndown the latest walks before launch.</li>\n<li>Admins manage this data at <code>https://&lt;your-site&gt;/admin/system-settings?tab=external-systems</code>. The last sync time is displayed and a “Sync Now (Incremental)” for the past week or <strong>Full Sync (All Time)</strong> exists.</li>\n</ul>\n<p><img src=\"https://ngx-ramblers.org.uk/api/aws/s3/site-content/c347f6ec-63bf-426c-a418-ba67f256088f.jpeg\" alt=\"\"></p>\n<ul>\n<li>A background cron job runs every six hours for installations configured with <code>WALKS_MANAGER</code> or<code> HYBRID</code> populations, keeping the cache fresh even if no admin manually triggers a sync.</li>\n</ul>\n<p><img src=\"https://ngx-ramblers.org.uk/api/aws/s3/site-content/20389de5-6680-4082-bdf6-7354dee045de.jpeg\" alt=\"\"></p>\n<h2>Sync Now vs Full Sync 💡</h2>\n<p>You might be wondering what the difference between the two syncs  buttons are:</p>\n<ul>\n<li><strong>Sync Now (incremental)</strong> - This is the one you want for day-to-day use. It only fetches walks that have been added or changed since the last sync ran, so it typically completes in a few seconds. If you&#39;ve just amended or cancelled one or two walks on Walks Manager, hit this button and the website will reflect your changes almost immediately.</li>\n<li><strong>Full Sync (All Time)</strong> - This re-downloads every walk from the Ramblers API from scratch, which takes longer depending on how many walks your group has. You&#39;d really only need this when setting up a brand new website that has no walk data yet. For normal day-to-day updates it&#39;s not necessary.</li>\n</ul>\n"}