Customized event lists 

Events listing page

The main listing page for events  can be reached by adding /events to the url. Communico uses <keyword>.libnet.info as a default url for library clients.

For example, for Seasons Library who's keyword is 'seasons', their events listing page would be seasons.libnet.info/events

By default, the events listing page displays a list of all events at all locations for the current day.

Prefiltered events list options 

You can create customized, pre-filtered listings by using the following options based on this url format:
<keyword>.libnet.info/events?

Event categories & locations

a= Age
l= Location
t= Event Type
term= Keyword or Search Tag

Event categories & locations

ea= Exclude Age
el= Exclude Location
et= Exclude Event Type
(Exclude term is not currently supported)

Date references

r= Date Range (today, tomorrow, thismonth, nextmonth, thisweek, nextweek)
r= Rolling dates (days, weeks, months). Use when combined with n= for rolling dates.
n= Period reference for rolling dates. Use numerical value. 
start= Start Date (2020-01-01) or Today
end= End Date (2020-02-01)

Display

v= View (list or grid)

Filter by Age group

For example if you have an age group 'Adults' and just want to display events for that age group, add the age group after a=

<keyword>.libnet.info/events?a=Adults

Filter by Location

Add the location, for example, 'Wintertown' after l=

<keyword>.libnet.info/events?l=Wintertown

Filter by Event type

Add the event type, for example, 'Games' after t=

<keyword>.libnet.info/events?t=Games

Filter by exclusion

It is now possible to exclude variables within the custom URL. For example, with 'exclude location', partners can now list all events except those at the Bookmobile location.

To exclude certain event categories, insert an ‘e’ in front of the reference. The exclude function is currently available on the age, location and event type filters.

• ea= (exclude) Age
• el= (exclude) Location
• et= (exclude) Event Type

Examples

• Exclude adults age category: /events?ea=adults
• Exclude Falltown location: /events?el=Falltown
• Exclude Chess Clubs event type: /events?et=Chess%20Clubs

Note:

Where an event has multiple age group or event types included, these will override the exclude filter. For an event with the age categories of teens, elementary and early learners, if an age group exclude filter of ‘teens’ filter is applied to the URL, the event will still display because the event is also for teens and early learners. The filter to exclude ‘teens’ will only apply to events where teens is the only age group category for that event.

Filter by View

The default view  by 'List' but you can also view as calendar or 'Grid'.
Add the view type, after v=

<keyword>.libnet.info/events?v=grid

Filter by Date Range

The default range is 'today' but you can also view as tomorrow, thismonth, nextmonth, thisweek, nextweek. 

Add the Date Range, after r=

<keyword>.libnet.info/events?r=thismonth

If you wish to showcase events with a fixed start and end time, use the ‘start’ and ‘end’ variables. The start variable can reference today to have a date range with a rolling starting point, but fixed end point. For example, the following URL link would display events from today until the first of August: /events?start=today&end=2022-08-01.

Note: date range option does not work for the grid view.

Filter by rolling dates

You can filter by rolling periods in relation to today, for example to show events for the next 30 days. 

• r= Date Reference (days, weeks, months).
• n= Number of days, weeks, months reference required.

These filters are combined as follows:

• r=<date reference>&n=<number>

Examples 

• 30 days from today: /events?r=days&n=30
• 35 days from today: /events?r=days&n=35
• Four weeks from today: /events?r=weeks&n=4
• Three months from today: /events?r=months&n=3
  
  

Combining filters

You can combine filters by adding '&' between the filters.

For example Event type 'Games' at 'Wintertown' branch next month would be:

<keyword>.libnet.info/events?t=Games&l=Wintertown&r=nextmonth

URL encoding

URLs can only be sent over the Internet using the ASCII character-set.

Since URLs often contain characters outside the ASCII set, the URL has to be converted into a valid ASCII format.

URL encoding replaces unsafe ASCII characters with a "%" followed by two hexadecimal digits.

URLs cannot contain spaces. URL encoding normally replaces a space with a plus (+) sign or with %20.

For example, Story Time would be encoded as Story%20Time.

After creating your text string, use an online encoder to ensure it is valid.