Customizing the event page layout

The Event Page Editor is used to customize the look and feel of the event pages that are used in your calendars.

Important things to know about the editor:

  • The event page editor is used to set the look of the event pages for all of your calendars -- there are no calendar-specific event templates.
  • Changes that you make to the event page are applied immediately -- there is no draft/preview mode for the editor.
  • The details of the event are controlled in the Event Display & Registration box.

You can get to the Event Page Editor from:

  1. Go to Admin > Look & Feel from the command bar.
  2. Click on the Event Page Editor tab.

getting to the event page editor


Customizing the event page layout

The layout of each page consists of columns and boxes. Each column can have multiple boxes, and each box can contain multiple content items. You can choose to use just a single column, or divide the page into 2 or 3 columns. When using multiple columns, you can also adjust the width of each column, as well.

  1. To add or remove columns, use the # of Columns dropdown to select the number of columns to display.
  2. To customize the width of your columns, use the Column Widths as % dropdown to select the desired layout.
  3. Click the Save button to apply your changes.

Example of customizing columns 


Types of boxes

Click on a panel below for more info about each type of box you can add.

These are the simplest boxes you can add and will display content items directly on the page. You can configure these boxes to display with or without a header and borders.

Example of a standard box

These boxes utilize templates to display the information about a particular event. Each template consists of two parts:

  • HTML code: this provides the structure for the event templates.
  • Tokens: these insert content from the event into the template. For example, the {{title}} token will display the event's title wherever it's placed in the HTML code of your template.

When working with tokens, it's important to keep in mind the following:

  • If a token is displaying text content only, it should be enclosed in double braces.
    • For example, the event's title is a text-only field, so you would use {{title}}.
  • If a token is displaying HTML content, it should be enclosed in triple braces.
    • For example, since the event's description can contain rich text formatting, you would use {{{description}}}.
  • To show a token's content only if the field contains a value, put it inside of template tags.
    • For example: {{#presenter}}<p><strong>Presenter:</strong> {{presenter}}</p>{{/presenter}} will only display the content between the {{#presenter}} and {{/presenter}} tags as long as the event's Presenter field is not empty.

For a complete list of available tokens, click on the Template Instructions button under the Event Template text area. If you're creating a new Event Display & Registration box and don't want to start from scratch, or if you simply want to use the latest version of the default template, click on the Restore Default Template button.

Example of editing an Event Display & Registration template

Will display the LibCal profile info for an event's organizer.

Example of a user profile box

The Google Map box allows you to display a Google Map of your event's location. If a specific geolocation was not entered for an individual event, then the map will display the geolocation of the event's campus. If the campus does not have a geolocation assigned (or you are not using campuses), then the geolocation provided in your System Settings will be used.

Example of a Google Map box

If you want to highlight certain information on the page, such as an upcoming change in hours or event locations, alert boxes can be really helpful. Each alert box has a customizable background color, which can help draw users' attention to important messages. Alert boxes are especially attention-grabbing when adding to a page's full width top box.

Example of an alert box

Adding Boxes

Boxes are the containers for the actual content on your page. Before you can add content, you must first add a box to put it in. Each column can have multiple boxes. You also have the ability to add a Top Box and Bottom Box to the page, as well. These are special boxes you can use if you want some contain to span the full width of the page.

  1. At the bottom of the column where you want the box to go, click on the  Add Box in Column button. (Or click on the  Add Full Width Top Box or  Add Full Width Bottom Box to add a top or bottom box, respectively.)
  2. Select the type of box you want to add. (See the following section for more info on each box type.)
    • Standard: these allow you to display content items directly on the page.
    • Event Display & Registration: these contain templates that display the actual content of each event.
    • User Profile: these will display the LibCal profile info for an event's organizer.
    • Alert: these allow you to add a highlighted alert message to the page, and are especially useful as full width top boxes.
  3. Give your box a title (this will display in the box's header).
  4. Depending upon the box type you chose, configure the other settings for that box.
    • Standard, Event Display & Registration, and User Profile : use the Box Display option to customize how the box's header and borders display.
    • Event Display & Registration: use the Event Template text area to customize the template used to display event information. 
    • Alert: use the Alert Color dropdown to select the background color of your alert box.
  5. Save your changes.

Screenshot of the Add Box in Column button

Example of adding an Event Display & Registration box 


Reuse an existing a box

If you want to reuse the same box on multiple pages, you totally can! For example, let's say you want to display the "Today's Hours" box from your Hours page on both your Homepage and Event Page. Instead of recreating the box on each page, all you need to do is add a copy of the original. This will add a linked copy of the box on each page -- that means, when you make an edit to the box, the changes will be reflected in every location.

  1. At the bottom of the column where you want the box to go, click on the  Add Box in Column button. (Or click on the  Add Full Width Top Box or  Add Full Width Bottom Box to add a top or bottom box, respectively.)
  2. In the  Add Box window, click on the  Reuse Box tab.
  3. Find the box you want to reuse from the list and click on its Reuse Box ( ) icon in the Reuse column to add it to the page. (You can only select from boxes that have not already been added to the current page.)

Screenshot of the Add Box in Column button

Example of reusing a box 


Editing or deleting a box

  1. To edit a box, click on the Edit Box ( ) icon next to the box's heading.
    1. To modify the box, make your changes to the box's settings and click the Save button.
    2. To delete the box instead, click on the Delete Box button. This is permanent and cannot be undone, so be careful!

Screenshot of the Edit Box icon

Example of editing a box 


Reordering boxes

Each column on the page can have any number of boxes. As you add more and more boxes, you may find that you want to change the position of some boxes on the page -- perhaps moving your opening hours up and your contact info down. Fortunately, the page editor has a tool to help you do just that. :)

  1. Click on the Reorder Boxes on Page link in the navigation bar.
  2. Drag and drop the boxes into the order you'd like. You can move boxes within the same column, between columns, and even between the full width top and bottom columns.
  3. Save your changes.

Screenshot of the Reorder Boxes on Page link

Example of reordering boxes 


Adding content to boxes

Within standard and alert boxes, you can add many different types of content items. In a nutshell, a content item is the actual "stuff" that your users see on the page. This can include things such as rich text, contact info, opening hours, event lists, etc.

  1. At the bottom of the box where you want the content item to go, click on the  Add Item button.
  2. Select the type of content item you want to add. (You can find more info about each type in the sections below.)
  3. Once you save your content item, click on the  Reorder button if you would like to reposition it within the box.

Example of adding a content item


Types of content items

Click on the panels below for more info about each type of content item you can add to a box.

These content items allow you to add text, images, and tables to your page. These content items provide you with a rich text editor that allows you to easily style your text, much like you can in Microsoft Word. The rich text editor also provides a Source mode, which allows you to embed HTML code into your page, as well. For example, if you wanted to embed a LibAnswers question form, you could switch to the Source mode and paste the widget's embed code in your Rich Text/HTML content item.

Important: LibCal already loads jQuery on every page. When adding or embedding HTML code, please do not include any <script> elements that attempt to load jQuery, too, as it will create errors and cause jQuery-powered elements to stop working. This may prevent you from being able to edit the page.

Example of adding a Rich Text/HTML content item

If you want to display your library's contact information, there's no better way than with a Contact Info content item. These allow you to easily display different types of contact information, such as your phone number, email address, and website, next to corresponding icons. This can make it easy for your patrons to identify how to get in touch with you about your events, bookings, or hours.

Example of Contact Info content items

If you have multiple calendars in your LibCal system, you can easily add links to each one using a Calendar List content item. These can be configured to show either a bulleted list or a button with a dropdown menu. Either way, the list will always reflect the current list of public calendars in your system, so you won't have to update this every time you add or remove a calendar.

Example of a button-style Calendar List content item

If you want to display an entire calendar on a page, then the Calendar content item is the way to go. This will add the selected calendar's full calendar widget to the box; so, for best results, be sure to add this to a larger column or as the top/bottom box.

Example of a Calendar content item

As an alternative to displaying a full calendar, you can display a list of upcoming events instead. This will not only fit better in smaller sized columns, but it will also be more mobile-friendly, as well. You can choose to display up to 25 upcoming events from all public calendars, or from just an individual calendar. These content items can be displayed either as a vertical list, or (for a little more pizzazz) as a horizontal scrolling carousel. Regardless of which you choose, these content items have a customizable template so you can tinker with how each event is displayed.

Example of an Upcoming Events carousel

If you'd like to give patrons the option of searching for events from your page, you can add an Event Search Form content item. These display a simple search which, when submitted, will display results directly on the page. These can be configured to search all public calendars, or just an individual calendar, displaying up to 25 relevant events. Event Search Form content items pair exceptionally well with Upcoming Event content items, as it will allow patrons to search for events if they can't find what they're looking for in your upcoming events list.

Example of an Event Search Form content item

An easy way for patrons to access your public room booking groups is through the Room Booking List content item. These will display links to your public room groups from the Room Bookings module, either as a bulleted list or button with a dropdown menu. You can even include some intro text that displays above the list or button, in case you want to provide directions or info about booking your rooms.

Example of a button-style Room Booking List content item

The Appointments List content item will display a list of all users who have Appointments enabled, either as a bulleted list or a button with a dropdown menu. When a patron clicks on a link for a staff member, you can configure the widget to either go directly to that user's personal Appointments appointment page, or launch the appointment booking widget for that user. If a patron doesn't know which person they want to meet with, then they can select the "View All Staff" option to go to your general Appointments appointment page.

Example of a button-style Appointments List content item

An easy way to share your library's hours is by adding an Opening Hours content item to your page. This will display the opening hours for all libraries and departments added to your LibCal Hours module (under Admin > Hours). You can configure each Opening Hours content item to display today's hours, a table of weekly hours, a calendar of monthly hours, or a list of the location & map info for your libraries & departments.

It can be helpful to mix and match these different types of Opening Hours content items in a tabbed box. For example, you could display your weekly hours on the first tab, your monthly hours on the second tab, and your location & map info on the third tab. This can make it easier for your patrons to get the info they need, without taking up a lot of real estate on the page.

Note: you can customize some of the default text used in the Opening Hours content items by adjusting them in your system's Language Options > Custom Language > Daily Hours Widget panel.

Example of a Opening Hours content item displaying today's hours

If you subscribe to the Equipment Booking module, you can add the Equipment Booking List content item to your page. This will display a list of links to either your locations, equipment categories, or individual items. You can choose to display these links either in a bulleted list, or a button with a dropdown menu. Either way, this provides a helpful shortcut for your patrons to access your equipment bookings catalog.

Example of a button-style Equipment Booking List content item

If you've migrated from the Room Bookings module to the Spaces module, you can add a Space Booking List to your page. This will display a list of links to either your locations or space categories. You can configure the widget to display the links in either a bulleted list, or a button with a dropdown menu. This makes it easy for your patrons to browse and book your public spaces.

Example of a button-style Space Booking List content item


Edit or delete a content item

  1. Click on the Edit Content ( ) icon next to the content item.
    1. To modify a content item, make your changes and click the Save button.
    2. To delete a content item instead, click on the Delete button. This is permanent and cannot be undone, so be careful!

Screenshot of the Edit Content icon

Example of editing a content item 


Previewing the events page

As you work on customizing your page, it can be helpful to pause and see how the finished product looks to the public. This can give you a better sense of how everything will look to your patrons, especially if you're using boxes with the headers and borders hidden.

  1. To preview your page, click on the  Live Preview link in the navbar.
  2. This will open your live page in a new window. Close it to continue editing your page.

Screenshot of the Live Preview link 


Exiting the page editor

Unlike other settings in LibCal, the page editors take you away from main admin area of LibCal. Once you're done making changes, click on the  Return to Look & Feel Page link in the navigation bar to return to the LibCal admin interface.

Screenshot of the Return to Look & Feel Page link

Related Articles