Theme Editor
- Important Note -
This functionality requires a subscription to Localist's Developer Theming package.
If you do not see the option to Edit HTML or Custom CSS containers, please reach out to support@concept3d.com or your dedicated Client Success Manager to learn more!
|
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 HTML.
Using the Theme Editor
Creating a New Theme
- Navigate to Settings > Platform Settings > Appearance tab
- 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 HTML to being editing
Actions
| Field |
Details |
| 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. |
Complete List of Theme Editor Partials
Information
| Partial |
Details |
| 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 |
Details |
| 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 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). |
| Google Map Component |
A map of all your events in the Channels with pins at each event location with a list of events happening there. |
| 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). |
| Header Component |
The header section of a Channel. |
| Hero Image Component |
An image that can link to a website (great for advertisements). |
| Mini Calendar 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). |
| RSS Feed Component |
Add an RSS news feed. |
| 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 |
Details |
| 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-Date 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 |
Details |
| 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 |
Details |
| _add_event_block |
The default Share Events and Widget Builder box in the right sidebar. |
Message Management
| Partial |
Details |
| 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 |
Details |
| _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 |
Details |
| 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. |
Places
| Partial |
Details |
| Place Page Shell |
The base shell for all Place Pages: Metadata, photo, name, website, description, filters, custom fields, upcoming events, recent events, recent activity, follow place, followers. |
| _business_buttons |
Follow Place, Twitter, Facebook. |
| _share_links |
AddThis social sharing options displayed on the left side of the browser. |
Register
| Partial |
Details |
| Registrant Text Page |
This is where you'll edit subscription 'terms' text. |
Review Management
| Partial |
Details |
| 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 |
Details |
| 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 |
Details |
| _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 |
Details |
| 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 |
Details |
| 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. |
| Bulletin Settings |
In the User Menu > Settings > Bulletin tab, this shows a list of all Bulletins the User is subscribed to. |
| Calendar Digests |
The Digest management page available via Settings > Digest in the User Menu. |
| Digest- _example_widget |
In the Digest form (right sidebar), this is a simple description of a Digest. |
| Digest- _form |
The Digest Email builder form available at /digester/summaries/new. |
| 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. |
| _friends_tab_block |
The "following" page in a User's Dashboard. |
| _pending_event |
A list of pending events in the User's Dashboard. |
| _request_item |
A catch all of notifications a User will get if someone wants to follow them. |
| _user_buttons |
User notifications like sending a message or confirming a follow. |
Widgets & Embedding
| Partial |
Details |
| 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 |
Details |
| 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:
| Format |
Details |
| Listing |
event_item
- Listing Example: {% if event_item.is_past == true %}This is a past event!{% end %}
|
| Landing Page |
event
- Landing Page Example: {% if event.is_past == true %}This is a past event!{% end %}
|
Theme Editor Properties
Details
| Property |
Details |
.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
| Property |
Details |
.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
| Property |
Details |
.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 > Platform Settings > Appearance > Select Edit HTML 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
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