Intro to Promotion Tools

Localist offers several tools to help you promote your events. These tools include Channels, Widgets, Bulletin and the Localist API – each of which provide different approaches to event promotion, and user discovery.

What’s a Channel?

Channels are a separate page from your homepage (which is a Channel too!). A Channel will generate a new page on your platform. Channels pull events based on existing Classifications or date ranges to showcase in one place. This tool should be used when you want to display a custom layout, make an umbrella page with several event lists, short-term event series, and topical themes.

Channel Administration 

  • A Channel can only be added and edited by a User with the Channel Admin permission level.

What’s a Widget?

Simply put, a Widget is an ambassador for your calendar. This tool enables you to 1) publish your events anywhere you’d like, and 2) using the Public Widget Builder, anyone, at any time, can generate an embed code and add your list of events to their own website that return web traffic to your main calendar page. A Widget’s content can be curated around any of the Classification types, which means flexibility and customization options for your end user!

Widget Administration 

  • As long as the Public Widget Builder is visible on your platform, any User can create a custom Widget using the Classification types.
  • On the backend, to build a Custom Widget Template, a User must have the Platform Admin permission level.

What’s Bulletin?

Bulletin is Localist’s event email engine, giving you the ability to send newsletters, manage contacts, and track analytics as a part of your event marketing strategy. Our out of the box template offers drag-and-drop components including Event Listings, Event Spotlight, Hero Image, RSS Feeds and an HTML Component. With the Digest feature, a User can even build their own personalized event updates email.

Bulletin Administration

  • Anyone with the Bulletin Admin Permission can create and edit Bulletins.

What’s the Localist API?

The Localist API is our most tech-heavy promotion tool. Events are pulled with standard HTTP calls, and the Localist API returns raw JSON data that is not formatted or styled. Your team will be responsible for styling the presentation, as well as building the application that can ingest and parse the JSON data.

Localist API Administration 

  • The Localist API is read-only and publicly accessible.

Channels vs. Widgets

Below is a Venn Diagram and breakdown of the similarities and differences between Channels and Widgets.

Differences

Adding

  • Channels: A User with the Permission levels of Channel Admin can edit and add Channels.
  • Widgets: Anyone can add a Widget, as the Widget builder is publicly available as long as you are linking to it. By default, the — Share Events Box — Add Event Block is turned on, but can be manually turned off.

Unique Features 

  • Channels
    • A Channel can be given a custom URL (ex. yourcustomdomain.com/summer_events)
    • A Channel offers several components like the Event Spotlight and a Hero image that you can drag and drop in the Channel Layout Editor to create a unique look and feel!
  • Widgets
    • Widgets adopt the style and URL of whatever page they’ve been embedded on.
    • Once a Widget is generated, it will continue to update without any further changes from the User.

Commonalities

  • They are customizable, meaning they can be built off of any of the Classifications on your platform!
  • Neither require no technical skills to implement.
  • Both fill the purposes of event marketing and event automation, saving you time, and helping drive web traffic back to the platform.

Bulletin

Bulletin is Localist’s own native newsletter tool that allows for effortless email event marketing. Managing campaigns, contacts and templates can all be done from the comfort of your Localist Admin Dash.

Bulletin Admin

If you’re new to Bulletin or Localist, here’s how each piece comes into play:

  1. Templates — WHAT content you will be sending and how it displays
  2. Contacts — WHO will be receiving the content
  3. Campaign — WHEN your audience will receive the content

Creating a Campaign

From your Admin Dashboard, navigate to Bulletin > Campaigns > Select + Add Campaign.

Field Details
Active If checked, the Campaign will send according to what is set in the Schedule section of this form. If unchecked, the Campaign will remain dormant.
Campaign Name Internal name of the campaign.
Sender’s Name Who is this Campaign coming from?
Sender’s Email What email address is this Campaign coming from?
Reply-to Email What email address should recipient replies be sent to?
Campaign Subject The Campaign’s subject line in a recipient’s inbox.
Last Chance Email If a Campaign is scheduled, Localist will send an notification one hour before to the email address set in this field as a final preview. This email includes a one-click “kill switch.”
Allow Unsubscribe If checked, recipients can opt out of receiving this Campaign in the future.
Template Designates the content and layout of the Campaign.

Delivery

There are two delivery options available:

Field Details
Send manually You will need to navigate to the Campaign and select Send Now in the top bar each time you’d like it to be sent.
Send on a schedule Once a schedule is set, the Campaign will send automatically until otherwise specified.

  • Start Date: The first date the Campaign will be sent.
  • Send Time: You can send the Campaign at the top of any hour.
  • Repeating: Select from a variety of default scheduling patterns. See below for further customizing your schedule.
  • Summary: This will update as you customize the above options.

Managing a Campaign

Customizing Schedules

If you are using a schedule to send your Campaign, a list of Scheduled Dates will appear to the right of the form after saving.

Pencil = edit the time of instance
Trash = disable instance entirely
Magnifying glass = preview the Campaign as it will appear on the future send date

 

Once saved, the Campaigns page will reflect the next run date and time:

Subscribers

Within a Campaign, you have two options for designating recipients:

Field Details
Contact List This option will import an already existing Contact List.
Additional Contacts This option allows you to upload a CSV or copy/paste a list of email addresses that will only be stored with the current Campaign.

Additional Tools

The following tools and links can be found in the top bar of the Campaign page:

Field Details
Copy This will create an exact duplicate of the last saved version of the Campaign.
Subscribe Widget Just like a Localist Widget, this tool provides an embed code that can be placed on any web page (within Localist or externally), so your audience can opt-in to receiving the Campaign in the future.
Edit Content & Layout This will take you to the corresponding Template for the Campaign.
Email Preview Send yourself the exact version of the Campaign your audience will receive.
Browser Preview View the exact version of the Campaign your audience will receive in your browser.

Creating Contact Lists

From your Admin Dashboard, navigate to Bulletin > Contact Lists > Select + Add Contact List. Once you have saved the name of the list you will be taken to the list’s dashboard. To Add new contacts, select Add Contacts in the top bar. You will have two options:

Field Details
Emails Copy and paste a list of emails using the format email@mail.com, Full Name.
File Template Download a CSV template to fill out and upload.

  • Replace Existing: If selected, any previously uploaded emails will be removed and the only emails saved will be the ones currently being added.

Once a list has been used in a Campaign, you can monitor your recipient’s status:

Additional Options

Field Details
Copy This will duplicate the current contact list and create a new list with the same contacts.
Settings Here you can change the name of the contact list or delete the list entirely.

Content & Layout

From your Admin Dashboard, navigate to Bulletin > Campaigns > Select a Campaign or click + Add Campaign (then create a Campaign) > Edit Content & Layout.

Templates are one-column, but components can be removed, added and re-ordered. The following Components are available:

Brand Header

  • “Localist Events”: This will reflect what is set as your Calendar Display Name in your platform’s Global Options.
  • “Weekly Events”: This will reflect what is set in the component’s “title” field.

Call to Action

  • Title: The copy that will display on the button.
  • URL: The webpage where you would like the Call to Action to send your audience.

Description

  • Title: “About this email”
  • Description: Include a short blurb about why your audience is receiving this Bulletin or other relevant information.

Event List

The following options will appear in an Edit Component list on the right side:

Field Details
Title Text that appears on the left as the header of the list tab (“Trending Events”).
Label Text that a user selects to switch event lists (“Trending” below).
Container CSS Classes Enter a unique selector to target only this Channel’s component with custom CSS.
Sort Events You can sort events By EventScore (trending) or By Date (chronologically).
Number of Events Choose from 1, 2, 3, 4, 5, 10, 25, or 50 events.
Time Period Keeping “Today” selected ensures that the Channel will include content within a rolling time period starting from today and ending a maximum of 366 days in the future. To create a non-rolling time period, select “Custom” to specify a different start date, then continue by number of days past the start date that the period should include.
Include in Trending By selecting this option, Localist will create a Trending Event List that only includes events from all current Event Lists that also have this option selected.

  • For example, if you have Event Lists for “Athletics” (Include in Trending), “Workshops” (Include in Trending) and “Tours” (not in trending) – the Trending list that Localist creates will only include Athletics and Workshops events.
  • The Trending Events list created by selecting Include in Trending will be the default list view on your Homepage or Channel.
Show Link to All Events If checked, a “view more events” link will be displayed at the bottom of the Event List that will link users to the regular, unfiltered All Events page.
Include All Matching Instances If checked, all instances matching the date range specifications will be included. If unchecked, only the first instance of a recurring event will be included.
Included You can specify to include events related to all available Classifications (Filters, Places, Groups, Departments, Tags, and Keywords).
Excluded You can specify to exclude events related to all available Classifications (Filters, Places, Groups, Departments, Tags, and Keywords).

Event Spotlight

  • Name: This is for internal reference and is displayed on the drag/drop component.
  • Show Event-Specific CTA: Unchecking this will remove the “Learn More” button.

Header


The header component allows you to tack on a header to all other available components–there will not be a break between the header and the next component. This example includes the Header, Subtitle + RSS component.

  • Name: “Newsworthy”
  • Subtitle: “Recent reports and updates from around time.”

Hero Image

  • Name: This is for internal reference and is displayed on the drag/drop component.
  • Photo: The default size is 644px (W) x 480px (H).
  • URL: The webpage where you would like the Call to Action to send your audience.
  • Header: “UPCOMING EVENTS”
  • Description: Include a short blurb about why your audience is receiving this Bulletin.
  • Call to Action: “JOIN US”

HTML

  • Name: This is for internal reference and is displayed on the drag/drop component.
  • Add any HTML embed as desired.

Link List

  • Name: “Other Links”

RSS

  • Import any valid RSS feed. Choose to display 1-10 items at a time.

Social Links

  • Enter a Facebook, Twitter and/or Instagram URL and Localist will generate corresponding icons.

Submit Event Button

  • Name: The copy the button will reflect.

Digest

Bulletin allows administrators to curate and send targeted event Campaigns and Digest allows the audiences to curate their own. Digests are customizable to suit your interests and are a great way to stay informed and engaged in your community without having to proactively visit this site.Your audience can access the Digest Builder two ways:

  1. Through the user menu when logged into the platform.
  2. By navigating to the “Share Events” box on your platform.

Creating a Digest

The following options are available:

Field Details
Active If unchecked, the Digest will be saved, but it will not be sent.
Title This will be displayed in the Digest and in the user’s dashboard for reference.
Send Day Choose any day of the week.
Number of Results Choose any number between 1-50.
Days Ahead Choose any amount between 1 day and 365 days.

Content

Users can further specify what kinds of events they’d like to include in their Digest:

Field Details
Classifications Filters, Groups, Departments, Places, Keywords and Tags.
Only Show Featured Only Featured Events matching the other designated specifications will be pulled.
Only Show Sponsored Only Featured Events matching the other designated specifications will be pulled.
Include All Matching Instances By default only the first instance of a recurring event will be included. If checked, all instances matching the date range specifications will be included.
Content Must Match Select one of the following:

  • At least one Place, Group, Keyword or Tag, and one Filter item
  • Any Place, Group, Keyword, Tag, or Filter item
  • At least one Place and Group, and all Keywords, Tags, and Filter items
  • Any place or Group, and at least one Keyword or Tag, and one Filter item
Excluded Content Users can exclude specific content based off of Keywords, Tags and all Filters.

Localist API

The Localist API is a simple HTTP-based interface. Standard HTTP calls will return JSON your application can use. For terms of use, concepts and resources, Localist’s master API documentation can be found here: https://developer.localist.com/doc/api

Public

Frequently Asked Questions

Is there a way for an event to appear in an API call, but does not appear on the public-facing calendar?

Yes, with a combination of event Permissions and API parameters. First, you’ll flag your event’s Permissions as Restricted: Widgets which will make your event only available in Widgets by default. Then, when building your API call, tack on the for=widget parameter.

Basic Rules

  • Localist’s API is read-only and publicly accessible.
  • Calls will pull 10 items per page by default, but can be increased to up to 100 per page (this is well-above industry standard).
  • The maximum date range that the API call pull from is 370 days from today or the start date you specify.
  • If a start date is not specified, then the API will default to only pulling event data from today.

Building an API Call

All API calls must start with http://your.custom.domain/api/2/

  • Events: http://your.custom.domain/api/2/events
  • Places: http://your.custom.domain/api/2/places
  • Groups: http:/your.custom.domain/api/2/groups
  • Departments: http:/your.custom.domain/api/2/departments

Paging: http://your.custom.domain/api/2/events?type=38570&pp=100&page=1

  • This will pull 100 results per page so to access the next 100 you would change the 1 in page=1 to 2, etc.

Date Range

  • Start and End date: http://your.custom.domain/api/2/events?type=38570&pp=100&page=1& start=2014-10-01&end=2014-11-01
  • Today + number of future days: http://your.custom.domain/api/2/events?days=90 (the maximum is 370 days).

API Token

Since the Localist API is publicly accessible, only public info is available. Things that aren’t public surround user data, so for example, who is attending an event. A token tells the API, “this is a trusted person”, and allows them to access the private data — think of this like a password. To give someone a token, you’ll need to follow the steps below:

  • Navigate to the Admin Dash > Settings > Apps
  • On the righthand side of the page, click ‘Add App

    Fill out Name (this can be internal, like ‘Localist Integration’) and App Website (the URL where the data will be used or your main domain)

  • Click ‘Save Changes
  • Click ‘Manage Access Tokens‘ in the top right corner

    +Create Access Token > Fill out details > Create Token

  • You’ll see the token on the resulting page, which you can pass along to the person who needs access to private data in the API

Widgets

A widget enables you to create events once in Localist and publish everywhere with Widgets. Administrators and users can embed and display events or series of events on pages separate from the main calendar, such as the organization’s website homepage, partner organizations websites or other pages.

Frequently Asked Questions

Who can create Widgets?

Any public site visitor can make a Widget — this means that your events can be promoted all over the web! For example, another department within your organization or a community partner can make a Widget of your events for their sites, which will ultimately drive traffic back to your calendar.

What is a Widget vs a Widget template?

Templates are the various Widget designs from which you can select in the Widget builder. While Widgets are the actual display of your events on another page.

Can I sort by Widget by Trending?

Once you’ve generated your Widget URL, you can add &sort=ranking to indicate that the Widget should sort events by the Trending algorithm.

Can I create a past events Widget?

You can have a rolling past events Widget — i.e. “the last 30 days”. For example, once you’ve generated your Widget URL you can replace the days parameter with &days=-30 to indicate that the Widget should pull events from the previous 30 days.

Why is the Localist logo only displaying, but no event content?

Most likely, the reason the Widget is not displaying on the website because of SSL protocol alignment issues. For context, SSL refers to when a website offers encryption, which is noted in the URL using https (secure) vs http (non-secure). When it comes to embedding content, you can embed content using https (like a Widget) on a non-secure/http page, but you cannot do the reverse and embed content using http on a secure/https page. This is often called upgrading security (allowed: posting https on an http site) or downgrading security (not allowed: posting http on an https site).

How long can it take for my Widget to update if an event’s content changes?

It can take anywhere between 15-20 mins for updates to be reflected in your Widget.

Does the “View All Events” redirect to the same results as outlined in the Widget?

At this time, the “View All Events” link on default Widgets links back to your calendar Homepage.

The Widget Builder

Public

The Widget Builder can be accessed by navigating to Content > Widgets > Public Widget Builder or by default it is publicly linked in the homepage’s Share Events box.

Widget Builder Fields

Field Details
Template Select the default template or one of your custom Widget templates.
Number of Results You can enter any number up to 50.
Days Ahead You can enter any number up to 365.
Groups/Departments The builder allows you to select one group. If you’d like to pull multiple groups’ or departments’ events you can tack on more groups or departments to the URL (&groups=group_a&groups=group_b OR &departments=department_a&departments=department_b).
Places Select all that apply.
Filters Select all that apply.
Keywords and Tags Enter all applicable words.
Show Only Featured When checked, only events flagged as a Featured Event will be included.
Show Only Sponsored When checked, only events flagged as a Sponsored will be included.
Include All Matching Instances If checked, the Widget will display all recurring instances. If not checked, the Widget will only display the first instance in the recurring chain.
Hide Past Events Hide all events in the past.
Content Must Match Select one of the following:

  • At least one Place, Group, Keyword or Tag, and one Filter item
  • Any Place, Group, Keyword, Tag, or Filter item
  • At least one Place and Group, and all Keywords, Tags, and Filter items
  • Any place or Group, and at least one Keyword or Tag, and one Filter item
Excluded Content Any Filters specified in these drop downs will not be included in the Widget. This is helpful in an “all, but one” situation.

Display Options

Field Details
Widget Type You have the option of a List Widget or a Mini Cal + List Widget.

  • The List + Mini Cal Widget provides a drop down of all available Event Type Filters to narrow down what events the list displays. The mini cal and “today’s events”/”this week’s events” will change the list results accordingly. The mini calendar extends 12 months.
Style Localist provides three out-of-the-box styles to choose from:

  • Modern
  • Card
  • Classic
Hide Descriptions Event descriptions will not be shown.
Truncate Descriptions Description, location, and event image will be hidden upon page load, however, when an event is clicked this information will appear.
Render HTML in Descriptions This allows any HTML entered in admin (bold, etc.) to be displayed automatically.
Hide Event Images Photos will be completely hidden.
Hide Event Times Times will be completely hidden.
Hide ‘View All Events’ Link The view all events link will be completely hidden.
Open Links in New Window If an event is selected, another window will open.

Generating Your Widget

After you have made all necessary specifications, you will see two options to generate your Widget results.

Field Details
Preview Widget This will open your Widget results in another tab. On this page you can confirm that the correct events are showing and that the output options are working as expected.
Generate Embed Code This will display the embed code for your Widget to be included on your website.

Custom Widget Templates

Localist allows you to create Widgets with custom code that changes the overall look, feel, and behavior of Localist’s standard Widgets. You can use this tool to build Widgets that match the aesthetic of your homepage, a sub-page, or a separate website.

Platform Admin

Adding a Widget Template

  • Navigate to Content > Widgets
  • Select +Add Widget Template
  • Name your Widget and choose which template to copy from as a starting point
    • Display Name:  This is what will be displayed in the public facing Widget builder’s style drop down.
    • Internal Name:  This will be automatically filled in.
      • For example, if you enter “Pinterest Board” for the Display Name then the Internal Name will be pinterest-board. This is displayed in the URL the widget builder generates when using a custom theme.
    • Copy From:  This allows you to pick another default or custom widget’s HTML to build off of. The Defaults are Modern, Classic, and Card:
  • Save Changes

Other Widget Templates

In Content > Widgets you’ll automatically see your Widget theme templates (Classic, Modern, Card, & Mini Calendar + List) along with the following:

Field Details
Places List This displays a list of Place profiles with name, image and description in the List (Classic) style.

  • Generating a preview:  Visit yourcustomdomain.com/widget/places?format=html.
  • Creating a script tag:  <script src=yourcustomdomain.com/widget/places></script>
  • Filtering
    • You can pull places with a certain type by adding types[]=1234 (ID is found in the admin URL)
    • Restrict the list amount by adding num=5
    • Sort list in alphabetical order by adding order=name
Logged-In User Plans This displays a list of events that a user has selected “I’m Interested” on. User must be currently logged in.

  • Generating a preview:  Visit yourcustomdomain.com/widget/plans?format=html.
  • Creating a script tag:  <script src=yourcustomdomain.com/widget/plans></script>
Badge This creates a See More Events button that can be added to any webpage or as a compliment to a widget event list.

  • Generating a preview:  Visit yourcustomdomain.com/widget/badge?format=html.
  • Creating a script tag:  <script src=yourcustomdomain.com/widget/badge></script>
 _platform_styles This file affects the List (Classic), Logged-In User Plans and Place List widgets.

Widget Parameters

These are additional parameters that can be used for the Widget, in addition to those available on the Widget builder.

Parameter Details

  • Each parameter should be passed in as standard parameter in the Widget URL.
  • Parameters marked as array can be specified as:
    • Array parameter (example: venues[]=1&venues[]=2 )
    • Comma separated values (venues=1,2 )
  • Two forms cannot be mixed.
  • Boolean parameters are true for values of 1, y, yes, true. In many cases, the presence of the parameter is all that is required.
  • When in doubt, don’t include false parameters.

Filter Parameters

Parameter Description Type Default
num number of events to return number 10
days number of days in the future (1-365)
HEADS UP: If you’d like to create a past events Widget, you’ll add to indicate how many days in the past you’d like to pull from. For example, days=-30.
number 7
start date the Widget should start (YYYY-MM-DD) date today
venues only return events at these venues (ID or username) array none
school only return events assigned to these schools (ID or username) array platform specific
campuses only return events assigned to these campuses (ID or username) array platform specific
groups only return events assigned to these Groups array none
departments only return events assigned to these Departments array none
skip_recurring do not include recurring events boolean FALSE
all_instances show all instances of recurring events (instead of only the next instance) boolean FALSE
picks only include events flagged as Featured boolean FALSE
sponsored only include events flagged as Sponsored boolean FALSE
tags return events with any of these Tags or Keywords array (string) none
types return events with any of these Filter values array (type ID) none
exclude_types exclude events matching these Filter values array (type ID) none
match_all controls matching requirements for Tags/Filters:

  • Not set (default): matches events that have at least one of the listed Tags/Filters.
  • All: matches events that have all listed Tags/Filters.
  • Any: matches events that have at least one of the listed Tags/Filters
array (string) none
sort sort events by the ‘Trending’ algorithm array chronological

Output Parameters

Parameter Description Type Default
hidedesc hide descriptions boolean FALSE
hideimage hide images boolean FALSE
image_size returns:

  • tiny (20×20)
  • small (50×50)
  • medium (80×80)
  • big (200×150)
  • big_300 (300×225)
array (string) small
show_keywords show Keywords assigned to events boolean FALSE
show_times shoe event start times boolean TRUE
show_year show the year of the event date boolean FALSE
show_types show Event Type Filters below the event description boolean FALSE
style suppress default style array (string) none
target_blank opens event and venue links in a new window boolean none
html_descriptions output the raw HTML in event descriptions boolean FALSE
format=rss convert to RSS feed HTML

Feature Face-Off: Widgets vs. API

If you’re evaluating whether to use the Localist API or Localist Widgets to spread event content outside of Localist, first ask yourself 2 questions:

  1. Are you looking to integrate Localist content into another system’s internal interface? If yes, then you will need to use the API.
  2. Do you have the technical expertise or resources to build and implement a tool that displays JSON data on a web page? If no, then you will need to use a Widget.

Outside of these two scenarios, the choice between the API and widget depends on your preferences. That said, we recommend always using the widget builder if you are only looking to display content on other pages as it’s quicker and generates styled data.

– HEADS UP –

Here are some helpful troubleshooting tips to try before you reach out to the support team!

 

  • Widget is not displaying on the page: You will need to check the Widget’s URL — if you have SSL on your platform the URL should display ‘https’ and not ‘http’.
  • Event is not being included in a Widget: Check the Classification, date range, number of Events, & that all is content matching.
  • Widget is not displaying like the preview: The CSS on the page may be altering the Widget, so you’ll need to change the CSS on the containing page.

Channels

Channels are a Promotion tool that pull your events based on already existing Classifications (or date ranges) to showcase them in one place. Channels were designed for short-term events like festivals or topics that have many different components but one theme. Channels are highly customizable with drag and drop components so you can make them have a different look and feel than the rest of your platform. Your homepage is a Channel so it can be customized in the same way as any other Channel.

Channel Admin

Frequently Asked Questions

How can I create a new tab on my homepage?

Your homepage is a Channel, so start by navigating to Content > Channels > select Edit Layout for the Channel in question. Next, select + Add Component > Event List within the already present Event Tabs component. You’ll see an editor appear to the right where you can designate a title and how you’d like to include events in the list, such as by Classification.

How can we create an internal calendar?

The first option here would be to create a hidden Channel and give out the URL to a select group of people who will be able to access the calendar. Second, you could make a restricted Widget, which you can then place on an external private web page.

When to Use Channels

In order to give context to a group of events, it makes sense to give those events a dedicated page for users to land on. This might lead you toward Localist’s Landing Pages (Places, Groups and Departments). These do a great job when it comes to showcasing event hosts and their events, while contributing to your platform’s overall taxonomy. This means that while these should always be your default option, there are a few occasions where it may make sense to build a Channel for instead of/in addition to your Landing Pages – after all Channels don’t contribute to your platform’s taxonomy.

When You Should Use Channels:

  1. To display a custom layout – If you want a page that showcases your events while providing more than just the default Landing Page options, you can add these extra elements if you create a Channel. These extra elements can include Featured Carousels, HTML elements, flipped displays, mini calendars, website links, and more. Ex. A branch library location homepage with its own Featured Events Carousel and CTAs back to their main website.
  2. Umbrella pages with several event lists – For example, a College within a University might want to collect the events for all its Departments on one page. So long as these Departments are set up as their own individual landing pages, a Channel can curate event lists for each Department. Ex. An athletics page with lists of events for each sport.
  3. Short-term event series – Do you have an annual festival that only has events for one week a year? If so, you can always create a Channel based on a Tag or Keyword. The Channel allows you to add the context your users crave using an HTML component and you can then easily turn this Channel’s visibility to hidden once the series ends. Ex. Fall Festival, Alumni Weekend, Family Weekend, Black History Month.
  4. Topical Themes – Does a certain topic matter to your community? Or does it apply to a subset of users, so it should not be a Filter? No problem! You can set up a Channel to pull in those events through a Tag or Keyword and showcase them all in one place with any other relevant info! Ex. Events friendly for children with special needs, volunteer opportunities, Alumni Channel.

When You Should Not Use a Channel

  1. When you need to build a Widget – Since Channels do not contribute to your calendar’s taxonomy, you cannot build Widgets around a Channel. Both Channels and Widgets are Promotion tools used to pull and display events. If you already built a Channel around a specific set of Classifications or date ranges, you can absolutely use that same criteria to curate a Widget!
  2. To trigger fallback images – At this time, the Photo Fallback Chain only applies to Landing Pages and Event Types. As a result, you must create a Landing Page in order to add a fallback image to the chain.

Channel Ideas

With this increased flexibility, you may not know where to start. Here is a list of a few types of content that can benefit from a Channel:

  • Overarching topics, like Sustainability
  • Festivals
  • Seasons
  • Regions/Neighborhoods
  • Conferences
  • Colleges or Schools
  • Holidays
  • Tours
  • Festivals
  • Organizations
  • Semesters or an Academic Calendar
  • Athletics

Adding Channels

From your Admin Dashboard, navigate to Content > Channels > Select + Add Channel.

Settings

Field Details
Copy Layout From You can create your Channel using your homepage or another Channel as a base for the layout. You also have the option to start with a blank layout.
Page Title This will appear in the browser tab.
Header Text This will appear at the top of the page (This Summer’s Hottest Events).
Custom URL This is the URL suffix for your Channel (ex. yourcustomdomain.com/summer_events).
Visibility Your options are:

  • Visible: Seen by all users, default setting.
  • Hidden: Only those with the link will be able to see the Channel.
  • Disabled: Only visible to Channel Admins via the Admin Dashboard.
Cover Photo Localist automatically detects if the image is light or dark, which controls whether the header text appears as black or white.

  • Desktop Default:  1140 pixels wide x 200 pixels tall
  • Smartphones Default:  420 pixels wide by 200 pixels tall
  • File size:  Cover Photos load fastest if they are an sRGB JPG file at least 1140 pixels wide and 200 pixels tall and less than 100 kilobytes. For profile pictures and cover photos with your logo or text, you may get a better result by using a PNG file.
Column Layout You have three options:

  • Wide/Narrow: Your Channel will have a grid_8/grid_4 layout
  • Even: Your Channel will have a grid_6/grid_6 layout
  • Narrow/Wide: Your Channel will have a grid_4/grid_8 layout
Lock Navigation to Channel By default, navigation is locked, which means selecting All Events, Filters, or Mini Cal dates will update the Channel. If unchecked, these links will take the user out of the Channel and to the results pages containing all events.
Custom CSS This is open to all standard CSS for display changes, such as size and color tweaks.

Emphasis Exclusive

A more prominent display is now available for Channel cover photos. Channel Admins also have the option to add a bold, solid background in the color of their choice.

Want access to the feature? Learn more about upgrading here!

Channel Layout

After saving your new Channel, you’ll automatically be redirected to the Channel Layout page. In the future, you can access this page by selecting the Edit Layout button for the Channel you wish to edit on the Channels page.

Channel Components

By default the base of each Channel is a left column and right column, just like the rest of the calendar pages. To re-order the components, just simply click and drag throughout the list to appear in the order you prefer. To add a new one, click Add Component above the relevant column. All components have a corresponding Container CSS Classes field that allows you to designate a specific class for targeting. For example, if you enter xyzsubmitbutton then you can target .xyzsubmitbutton {background-color: red; } and only have the rule apply to the submit button on that specific Channel.

The available components are listed below:

Component Details
Add Event Block The default Share Events and Widget Builder box.
App Store Button Allows you to link directly to any apps you have in the App Store.
Calendar Nav The Mini-Calendar.
Channel List A list of some or all of the Channels on your platform. You are able to select which ones you want to appear.
Community List A list of the Communities on your platform.
Department List A list of the Department Pages on your platform (with links).
Description Add a description to your Channel.
Event List Add a list of events (each list will have its own label to toggle between lists).
Event Spotlight Showcase a specific event.
Event Tabs Each section where the event list appear.
Featured Groups Add a list of sponsors to your Channel.
Featured Tabs Add a Featured Events Carousel(s) to your Channel.
Featured Users Add a list of speakers to your Channel.
Filter Events Your platform’s Filter list (you cannot have a Channel specific filter list).
Group List A list of the Group Pages on your platform (with links).
Header Add a header to your Channel (great for a banner or notice).
Hero Image Add an image that can link to a website (great for advertisements).
HTML Add any HTML embed you would like (i.e. a weather bot for a festival).
Map Add a map of all your events in the Channels with pins at each event location with a list of events happening there.
Place List A list of the Place Pages on your platform (with links).
Platform Nav The navigation buttons to help your users find events (All Events, Places to Go, Groups, Departments.
RSS Add an RSS feed of events.
Social Links Add a Facebook, Twitter, and/or Instagram button linking to your respective account(s)./td>
Submit Event Button Takes users to the Public Event Submission Form.
Website Link Add a link to an external website, like a festival page or registration form.

Specifying Channel Events

By default, a Channel includes one Event Tabs: Group component that displays a Trending Event List and an Upcoming Event List as well as one Featured Tabs: Group with one Featured Slider assigned to it.

To modify the content of your Event Tabs, select an Event List. The following options will appear in an Edit Component list on the right side:

Field Details
Title Text that appears on the left as the header of the list tab (“Trending Events”).
Label Text that a user selects to switch event lists (“Trending” below).
Container CSS Classes Enter a unique selector to target only this Channel’s component with custom CSS.
Sort Events You can sort events By EventScore (trending) or By Date (chronologically).
Number of Events Choose from 1, 2, 3, 4, 5, 10, 25, 50, 75 or 100 events.
Time Period Keeping “Today” selected ensures that the Channel will include content within a rolling time period starting from today and ending a maximum of 366 days in the future. To create a non-rolling time period, select “Custom” to specify a different start date, then continue by number of days past the start date that the period should include.
Include in Trending By selecting this option, Localist will create a Trending Event List that only includes events from all current Event Lists that also have this option selected.

  • For example, if you have Event Lists for “Athletics” (Include in Trending), “Workshops” (Include in Trending) and “Tours” (not in trending) – the Trending list that Localist creates will only include Athletics and Workshops events.
  • The Trending Events list created by selecting Include in Trending will be the default list view on your Homepage or Channel.
Show Link to All Events If selected, a “view more events” link will be displayed at the bottom of the Event List that will link users to the regular, unfiltered All Events page.
Included You can specify to include events related to all available Classifications (Filters, Places, Groups, Departments, Tags, and Keywords).
Excluded You can specify to exclude events related to all available Classifications (Filters, Places, Groups, Departments, Tags, and Keywords).