Home

Theme Editor

You can use Localist’s Theme Editor to access your platform’s HTML to customize how your event data is presented. The template language is Liquid. In this article you will find:

  • Accessing the Theme Editor
  • Actions
  • Modifying Files
  • Language Changes

Using the Theme Editor

Creating a New Theme

  • Navigate to Settings > Appearance
  • Select +Add Theme

    On the +Add Theme page you will be prompted to enter a name for the theme, and which existing theme the new theme will inherit.

  • Select Edit Theme Files to being editing

Actions

Activate: This will tell Localist to make the theme you’re editing live, replacing the previously active theme.

Delete: This will remove the entire theme.

Modifying Files

Modifying a file will cut it off from receiving any future Localist updates. If a file has not been modified, then it will continue to receive updates. If you had a modified file, but select Reset to Default then the file will receive any necessary updates. To ensure that you receive as many updates as possible, we recommend making any possible stylesheet changes outside of the Theme Editor.

When modifying a file, in order for your changes to stick you must save changes before you navigate to another file. If you select another file before saving your changes, you will receive a warning prompt that the file contains unsaved changes. After saving a file, it will be blue bold in the file list.

If you are using a SILK Wrapper, then changes made to the Global Site Shell file will not be applied. After you have saved your changes in a file, a Reset to Default link will appear next to the Save Changes button. Selecting this will remove all changes you’ve made to the specific file.

Information

Partial Description
README This is an internal file available for you to document any common
changes, or things to keep in mind for your staff as you customize your platform.
Public Help Page This is an open HTML page for you to provide a page of guidelines, instructions or an FAQ for your users.

Channels

Partial Description
Channel Page Shell The base shell for all Channels.
Add Events Block Component The default Share Events and Widget Builder box.
App Store Buttons Component Allows you to link directly to any apps you have in the App Store.
Channel Page List Component 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 Component A list of the Communities on your platform.
Department List Component A list of the Department Pages on your platform (with links).
Description Component A description box to add to your Channel.
Event List Component A list of events (each list will have its own label to toggle between lists).
Event Spotlight Component Showcase a specific event.
Event and Featured Tabs Component Each section where the event list or Featured Events Carousel appears.
Featured Section Component Add a Featured Events Carousel(s) to your Channel.
Filter List Component Your platform’s Filter list (you cannot have a Channel specific filter list).
Group List Component A list of the Group Pages on your platform (with links).
HTML Component Any HTML embed you would like (i.e. a weather bot for a festival).
Hero Image Component An image that can link to a website (great for advertisements).
Map Component A map of all your events in the Channels with pins at each event location with a list of events happening there.
Minicalendar Component The navigational mini calendar.
Place List Component A list of the Place Pages on your platform (with links).
Platform Navigation Component The navigation buttons to help your users find events (All Events, Places to Go, Groups, Departments).
Social Links Component Add a Facebook, Twitter, and/or Instagram button linking to your respective account(s).
Submit Event Button Component Takes users to the Public Event Submission Form.
Website Link Component Add a link to an external website, like a festival page or registration form

Events

Partial Description
Page Shell The base shell for all Event Pages: Name, photo, time, dates + instances, place, filters, tags, website, cost, groups, departments, hashtag, custom fields, subscribe links, recent activity (comments, photos, reviews), event owner edit, admin edit.
Invite Friends The lightbox content and messaging that is displayed when a user selects the Invite Friends button.
Public Event Submission Form Name, description, schedule (start date, start time, end time, repeating, summary), location (place, room, address), additional details (hashtag, website, custom fields), photo, filters, departments, groups, ticketing (cost, link).
User Multi-Day Select The lightbox content and messaging that is displayed when a user selects the I’m Interested button on events that have multiple instances.
_edit_sidebar The right sidebar of the Public Event Submission Form. Includes “Adding an Event” and “Batch Event Add” boxes. Often used for custom guidelines, disclaimers and organization specific tips.
_event_attendees The People Interested box on Event Pages.
_event_buttons Buy Tickets/Register, Invite Friends and I’m Interested buttons on Event Pages.
_event_status A user’s “I’m Interested” status and functionality on Event Pages.
_right_sidebar The right sidebar for all Event Pages: Getting Here (map) box, event directions and all other “Event” partials.
_share_links AddThis social sharing options displayed on the left side of the browser on all Event Pages.

Groups

Partial Description
Page Shell The base shell for all Group (and Department) Pages: Metadata, photo, name, website, description, filters, custom fields, upcoming events, recent events, Group feed, recent activity, follow group, followers.
_group_buttons Follow Group, Twitter, Facebook.
_group_members Followers box on all Group (and Department) Pages.
_group_request_form The lightbox and messaging for when a Group requires approval to follow.

Homepage

Partial Description
_add_event_block The default Share Events and Widget Builder box in the right sidebar.

Message Management

Partial Description
Page Shell  The base shell for all Users’ messaging center.
User Contact Form  Admin contact form for users. Also includes right sidebar guidelines for contacting Admins.
_compose_form  Compose a message to friends page.
_conversation  View conversation with a friend: select a message, view previous conversations.
_conversation_list_item  View conversations within a list: delete conversation.

Modals

Partial Description
_edit_text Group description editor (only appears for Group Officers). Allows Group Officers to edit the description text of their Group without having access to the Admin Dash.
_login The login lightbox including content from _login_message and _login_methods.
_login_message Includes lightbox description copy: “Login to interact with events, personalize your calendar, and get recommendations.”
_login_methods Includes all available login option buttons.
_ticket_lightbox Pop up lightbox that is displayed when a User clicks “I’m Interested,” but the event has an external registration link (i.e. a “you still need to register!” reminder).

Photo Management

Partial Description
Page Shell Landing page for a user’s photos available via “Photos” in the User Menu.
_album_contents List of user uploaded photos available via “Photos” in the User Menu.
_edit_photo Includes caption, photo location, related events and ability to make a photo a user’s default.
_no_photo “Click on a photo” box in the right side column on the “Photos” dashboard.

Review Management

Partial Description
Page Shell Landing page for a user’s reviews available via “Reviews” in the User Menu.
_manage_reviews_list Includes a list of events needing review and previously posted reviews.
_review_form The form for submitting a review of an event including these options: “I didn’t like it,” “Meh” and “It was great!”

Search Results & Month Views

Partial Description
Search Results Page Shell The initial landing page displayed after completing a search. This page is available at /search.
User & Place Calendar Page Shell The page resulting from selecting “view full calendar” from a User Profile or Place Page.
_calendar_filter Similar to browse_filter. It’s the filter list that appears on the side of Place/User calendars.
_event_list Event listings on all pages starting with /calendar.
_minicalendar The navigational mini calendar on Search Results pages.
_result_block The initial landing page for all search results.
_right_side The right sidebar for all search results.
_subscribe Google Cal, iCal, Outlook and RSS subscription links on search and filtered results pages.

Shared Among Multiple Views

Partial Description
_activity_photo The photo section of Event, Place, Group and Department pages.
_browse_filter Filter and Community lists on all pages except Channels (including Homepage). 
_comment The comment section of Event, Place, Group and Department pages.>
_comment_form The form used for commenting directly on Event, Place, Group and Department pages.
_event_item All Event listings on your Localist platform: Name, Event Type Filters, description, start date, start time, Place, photo, I’m Interested, Register/Buy Tickets CTA.
_featured_section All Featured Event carousels on your Localist platform: Name, photo, description, start date and start time.
_flash_message The alert bar that appears near the top whenever something is saved, a form submission error, etc.
_minicalendar The Mini Calendar on all pages except Channels (including Homepage).
_nav_after The space before the platform nav section (Submit, All Events, Groups, Departments, Places to Go).
_nav_before The space after the platform nav section (Submit, All Events, Groups, Departments, Places to Go).
_next_page_link The pagination containers that include back and next arrows when viewing event’s by Day, Week or Month.
_platform_nav Includes Submit an Event, All Events, Groups, Departments and Places to Go buttons.
_recent_activity This is the interface for Comments, Reviews and Photos included on Event, Group, Department and Place pages.
_review The review section of Event, Place, Group and Department pages.
_review_form The form for submitting a review of an event including these options: “I didn’t like it,” “Meh” and “It was great!”
_upload_photo_form Photo upload functionality included in the Recent Activity section on Event, Group, Department and Place pages.

User Authentication

Partial Description
Password Forgot Form Landing page for starting the password reset process for a local account. This page is available at /auth/forgot.
Password Reset Form Landing page for setting a new password for a local account.
User Account Verification Users are taken to this page after their email address has been verified.
User Login The non-lightbox login page. Viewable at http://calendar.url/auth/login. By default, it includes the files from the login lightbox on a static page.
User Signup Landing page for creating a new account. This page is available at /signup.

Users

Partial Description
Dashboard Shell The base shell for all user dashboards available via User Menu > Dashboard: Welcome message, user’s upcoming events, Widget CTA, Platform Nav and Profile Completeness.
Public User Page Shell The base shell for all user profiles available via User Menu > Public Profile: name, photo, upcoming events, recent activity, places followed and friends.
Add Digest The form used to initially create a new Digest.
Calendar Digests The Digest management page available via Settings > Digest in the User Menu.
Digest Edit The form used to edit a current Digest.
Edit Profile The base shell for the user settings page available via User Menu > Settings: account settings, notifications, Bulletins and privacy.
Manage Friends & Places Landing page for a user’s Friends & Places available via “Friends & Places” in the User Menu.
Manage Groups Landing page for a User managing the Groups they “follow” available via “Following” in the User Menu.
Notification Settings Interface where users can customize their notification settings available via Settings > Notifications in the User Menu.
Privacy Settings Interface where users can customize their privacy settings available via Settings > Privacy in the User Menu.
_feed_item The individual items in the list of updates and notifications in a User’s Dashboard.
_feed_list The list of updates and notifications in a User’s Dashboard.
_form The Digest Email builder form available at /digester/summaries/new.

Widgets & Embedding

Partial Description
Widget Builder Form Landing page for building Localist Widgets. This page is available at /help/widget.
_examplewidget Includes “Put Events on Your Site” and “Widget Help” boxes in the right sidebar of the Widget Builder page.
_feed_event When using the Widget Builder to generate an RSS feed, this is the file it will use. Allows the admin to change the output of RSS for all RSS widgets on the platform (or they can make a new widget).

Wrapper

Partial Description
Global Site Shell Base shell for all Localist pages. Includes <head> elements and can be used to embed scripts. This file is disable when using a SILK Wrapper.
_footer Localist added footer. Includes “powered by Localist” messaging. This file is disabled when using a SILK Wrapper.
_header Localist added header. Includes logo, user menu and Localist search bar. This file is disable when using a SILK Wrapper.
_search_bar Localist specific search bar. When using a SILK Wrapper this is added to your platform with an HTML comment.
_user_menu Localist specific user menu. When using a SILK Wrapper this is added to your platform with an HTML comment.

Events

Events are available in two formats:

  1. Listing = event_item
  2. Landing page = event

Listing Example: {% if event_item.is_past == true %}This is a past event!{% end %}

Landing Page Example: {% if event.is_past == true %}This is a past event!{% end %}

Details

Attribute Description
.name Full title of the event
.url URL to the event’s unique landing page
.description_text Plaintext event description
.description Full HTML event description
.place Name of the event’s location
.venue Name of the Place Page connected to the event
.ical_url ICS subscription link for the event
.photo The photo assigned to the event
.tags All Localist Tags included with the event
.keywords All Localist Keywords included with the event
.website The external Event Website included with the event

Date & Time

Attribute Description
.starts_at Full start date and start time
.ends_at Full end date and end time
.start_date Date the event starts
.start_time Time the event starts
.end_time Time the event ends
.first_date Date of the earliest instance of a recurring event
.last_date Last date of the latest instance of a recurring event
.next_instance Next upcoming instance of a recurring event
.future_instances Next 8 instances of a recurring event
.created_at Timestamp of the event’s creation
.updated_at Timestamp of the event’s last update

Statuses

Attribute Description
.is_sponsored The event has been marked as Sponsored
.is_over The event’s end time has passed
.is_past The event’s start date > today
.has_many_future_instances The event has recurring future instances
.is_verified The event has been approved and is live
.is_rejected The event has been rejected and is not live
.allows_attendance Users can use the “I’m Interested” functionality for the event
.has_instances The event is a recurring event with multiple instances
.has_tickets Localist Tickets are required for one or more instances of the event
.needs_registration Localist Registration is required for one or more instances of the event
.has_external_tickets An external ticket/registration URL is included with the event

Language Changes

Language Changes refer to any time the default language on the platform is changed to display a different word or phrase. The majority of languages are made by the customer using the Theme Editor to modify the platform’s HTML. However, there are some pieces that need to be changed on Localist’s end. Localist Language Changes include:

  • Vocab:  All Events, Groups, Places to Go, Submit an Event, I’m Interested, People Interested, Buy Tickets, and Register
  • Date + Time Format: capitalization of am/pm (AM/PM vs. am/pm), adding a space after the time (8 pm vs. 8pm), adding/removing zeros at the top of the hour (8:00 vs. 8), and lengthening/shortening the date format ( Sept. 1 vs. September 1 vs. 9/1)
  • Localist language changes do not include Filters, Custom Fields, or Homepage tabs.

Changes Implemented by Your Team

The files noted are found in the HTML Theme Editor by navigating to Settings > Appearance> Select Edit Files for the appropriate theme.

  • Example file: Homepage > _add_event_block. Homepage is the section in the theme editor and _add_event_block is the actual file.

 

Localist Platform Homepage

Share Events Box: Homepage > _add_event_block

 

Public Event Submission Form

Adding an Event + Batch Event Add Boxes: Events > Public Event Submission Form

 

Landing Pages

Getting Here map header:

  • Place Landing Page: Places > Place Page Shell
  • Event Landing Page: Events > _right_sidebar

 

Recent Activity Section (header, comment, review, photo and no recent activity): Shared Among Multiple Views > _recent_activity

 

Upcoming Events header, Recent Event header & “View full calendar” link:

  • Place Landing Page: Places > Place Page Shell
  • Group Landing Page: Groups > Page Shell