In our events module, we have a feature called "Priority". At its most basic, priority is a simple text field attached to an event which you can insert an integer into.
This can subsequently be used to sort or filter a lister, which by default is sorted by event date then time. Some examples of what you can do with the priority field: you can have a lister sort events with priority from low to high, or can filter a lister so only events with a certain priority are shown. You can even use this to force certain events to the top of the event list, like a pinned forum post.
We will walk you through the steps of setting up a basic lister which sorts by priority. Navigate to the module layouts (Green > Layouts > Modules) and edit the default events lister, or make a copy to edit. In the field "Sort Field", type "priority". This forces the lister to sort by the priority that we give each event rather than the default sorting value.
Once you save we are ready to move onto the next step. You will now need to go to the events and edit them to give them a priority (Blue > Events > click Edit). Ensure that each one has a priority - leaving the priority field blank automatically pushes it above any entries which have a priority. Before adding priorities, you can see that the default sorting order was date, then time, as you can see below.
When setting this up, we set the priorities up so that the default sort order would be reversed - test item 1 got priority 4, item 2 was assigned priority 3, etc. As you can see from the screenshot below, the priority has overridden the date and time values as what the lister uses to sort our events.
Congratulations, you have completed the setup!