Website logo
⌘K
Introduction
PORTAL
Agency Whitelabelling
PAGES
Pages - Accessing Page Data
Pagination Layouts
Page Templates
FORMS
CATEGORIES
Filtering WebApps and Modules by Categories
Outputting Categories on WebApp / Module / eCommerce Layouts
Outputting Category Fields in any Location
Category Detail Layouts
FAQ - Categories
COMPANY INFORMATION
Company Information
SITE SEARCH
Site Search
PUBLIC API/ZAPIER
Zapier - Formatting arrays correctly
Public API/Zapier Changelog
MODULES
Module Marketplace
Building Custom Modules
Siteglide Modules
Front-end Submit Modules
DATA STRUCTURES
Creating WebApps from the CLI
Field Types
WEBAPPS
Front-end Submit WebApps
Layouts
Search and Filtering
Understanding Custom Field Names and IDs
FAQ - WebApps
CRM
User Details
User Secure Zones
Storing User's Favourite WebApp / Module Items
User's Form Submissions (Cases)
How Users Edit their Email and Password Front End
Editing a User's CRM record Front End with Custom Field Sets
CLI
Introducing Siteglide CLI
CLI Changelog
Secure Zones with CLI
Page Templates with Siteglide CLI
Pages with Siteglide CLI
Includes with Siteglide CLI
Managing Email Templates
Migrate - Manual Form setup
Migrate - Convert existing Forms
Liquid
Accessing Assets
Liquid Dot Notation
Using WebApp Collections- Tutorial
Using the current_user object with Secure Zones
Preventing Duplicate Content with Query Parameters- Canonical URL and Robots.txt
FAQ - Liquid
GraphQL
Tutorial Overview
About GraphQL
Tutorial 1- Your First Query
Tutorial 2 - Pagination
Tutorial 3 - Filtering the Results
Tutorial 3 - Answers to the First Filtering Challenge
Tutorial 4 - Advanced Filtering
Tutorial 4 - Challenge Answers
Tutorial 5 - Using Liquid to run GraphQL queries on your Site
Tutorial 6 - Variables
Tutorial 6 - Answers to the Variables Challenge
Tutorial 7 - Sorting
Tutorial 8 - Building a Liquid API GET Endpoint Page powered by GraphQL queries
Best Practice and Performance
Module/WebApp Caching
Getting Started with Liquid Caching - to Reduce Server Response time and Improve Performance
Includes
ecommerce/basic_payment
ecommerce/checkout_standard
Frequently Asked Questions
How do I control Timezones?
Using Liquid Logic to Check if a field exists, or is empty on the Front End
How do I learn more about Liquid?
How to setup a multi domain start page
Docs powered by Archbee
MODULES
...
Siteglide Modules
Events

Browse by Category

8min

You can dynamically output a navigation menu of Categories which have Events assigned to them. The User can then filter the Events.

Document image


Prerequisites

  • You have Installed Events Module
  • You have added at least one Category to an Event

Introduction

This Article will show:

  • How to include this Navigation Option when including the Events List
  • The Default Layouts with explanation
  • How to give the User Feedback on the type of results they are seeing.

To Include this Option

Include the following liquid to dynamically get a list of available Events Categories for the User to select:

HTML
{%- include 'modules/siteglide_system/get/get_categories'
    categories_layout: 'design_system/1/categories'
    categories_layout_type: 'list' 
-%}


The parameters refer to Layouts which will be used to display the Category links. 

  • categories_layout should be the path to the folder in the Events Module where your Category Navigation files are stored.
  • The category_layout_type is the sub-folder where the wrapper and item files are stored for filtering the Events list by category e.g. list. The category_layout_type exists because some Events layouts may have a different partial layout for Categories within a Events preview, footer or sidebar.

Default Layout Examples with Explanation

wrapper.liquid

HTML
<div class="row no-gutters">
  <div class="col-12">
    <h2>Categories</h2>
    <ul>
      {%- include 'modules/siteglide_system/get/get_items'
        item_layout: 'item' 
      -%}
    </ul>
  </div>
</div>


item.liquid

HTML
<li>
       <a
              href="{{context.headers.PATH_INFO}}?category={{this.id}}" 
              title="Category: {{this.properties.name}}"
       >
              {{this.properties.name}}
       </a>
</li>


The link should be the slug of your Events List view followed by ?category={{this.id}}. Siteglide will be able to read the Category id from the URL and populate the List View on refresh. In this example we use the context object to automatically get the slug of the current Events Page.

User Feedback - Displaying the currently applied filter

Document image


You may wish to give the User some feedback about the current filter/ search terms that are applied on the Events List. For Categories, you can use {{context.exports}} object to get the name of the category you are filtering by:

HTML
{% if context.params.category %}
  {{context.exports.categories.data[context.params.category].name}} Events
{% endif %}




Updated 11 Apr 2023
Did this page help you?
PREVIOUS
Browse Events by Keyword
NEXT
List View
Docs powered by Archbee
TABLE OF CONTENTS
Prerequisites
Introduction
To Include this Option
Default Layout Examples with Explanation
wrapper.liquid
item.liquid
User Feedback - Displaying the currently applied filter
Docs powered by Archbee