Events

 

This documentation was modified on 05/08/2019, with Recurring Events

CREATING EVENTS | EVENT RSVP | RESPONSIVE EVENT CALENDAR | RECURRING EVENTS

CREATING EVENTSCREATING EVENTS

Creating ‘Events’ is a highly recommended step, as you want to keep visitors of your website informed on things going on in the store. The steps below give you all the options available when doing so. The only required options are those noted with a red asterisk*.

CREATE AN EVENT

Navigate to: Content > Add Content > Event

There are several available fields for you to utilize to create the content of your page:

1. Title*: This text will be used in 4 places:
   • The title displayed in your browser window
   • The header on your published page
   • It will also be used to construct the actual URL of the page
   • The Event name displayed on the ‘Event Calendar’
2. Body: Use the built-in WYSIWYG editor to add text, images, links, and any type of content that tells visitors about the event.  Not familiar with the WYSIWYG icons? Review our "WYSIWYG Editor Key".
3. Event Date*: The start date/time and end/date time appear on the event page itself as well as control where the event is placed on the ‘Event Calendar’.
4. Event Address: Location of the event that will appear on the event page.
5. Books: Are there specific books associated with this event? Add them here.
6. You can customize the settings of any of these tabs to your preference:
   • Menu Settings
   • Book Outline
   • Revision Information
   • URL Path settings
   • Meta tags
   • Authoring Information
   • Publishing Options
7. Save

You have now created your event. If you did not place it in a menu during setup you may do so now by visiting Structure > Menus > Menu of choice and adding it appropriately. Otherwise, your ‘Event’ is created, the node is published and it is automatically added to the ‘Event Calendar’ which is located at www.yoursitename.com/event.

EVENT RSVPEVENT RSVP (IndieCommerce Members Only)

An RSVP element can be added to any event using a simple webform. In the example below, we create a simple webform that asks for the number of attendees and a reservation name. Information about creating more detailed webforms can be found here Creating Webforms.

CREATE THE WEBFORM
Each event should have its own RSVP webform. The title of the webform should reflect the event the RSVP is for.

Navigate to: Content > Add Content > Webform

1. Enter a title - Example: Vivian Howard Dinner & Signing RSVP
2. Save
3. Select ‘Webform’ tab
4. Create a field for collecting a name
   • Enter a label - Example: Reservation Name
   • Select the type - Text field
   • Click add - Configure the text field
   • Save Component
5. Create a field for the number of attendees
   • Enter a label - Example: Number of guests
   • Select the type - Number
   • Click add - Configure the Number field
   • Save Component
6. Select the ‘Emails’ tab and configure your email preferences
7. Select the Form settings tab and configure your preference

CONFIGURE THE EVENT CONTENT TYPE (this is a one-time setup)

Navigate to Structure > Content Types > Event > Manage Fields

1. Add a new field for ‘ RSVP Form’
   • Label - Example: RSVP Form
   • Field type - Entity Reference
   • Widget - Select List
2. Save
3. On the next page, set the ‘Entity Selection’ to ‘Webform’ and Save field settings
4. On the next page, confirm the ‘Number of Values’ is 1 and Save
5. Select ‘Manage Display’
6. Set the format for the RSVP Form to ‘Rendered Entity’ and Save
7. Select the gear icon,  disable ‘Show Links’ and select ‘Update’
8. Save

ADD THE RSVP FORM TO THE EVENT

Navigate to Content

1. Select ‘Edit’ for the event
2. Locate the ‘RSVP Form’ field and select the appropriate webform in the list
3. Save

We recommend you review your event page and test the RSVP form.

RESPONSIVE EVENT CALENDAR RESPONSIVE EVENT CALENDAR (IndieCommerce Members Only)

You will need to request that ABA enable the ‘Responsive Event Calendar’ module for you. You may do so by navigating to: Store > Configuration > Account Information and Preferences > Store Features.

By default, all published events are added to the event calendar (yoursitename.com/event). The Responsive Event Calendar module adds additional features:

1. Pop-up: On desktop, a pop-up on mouse-over displaying additional event information will appear - Event title, date/time and a snippet of the body (est. 230 characters including spaces).
2. Responsive List:  On mobile, the default monthly calendar is now responsive and events are displayed in a list format. Only the dates that have events will display and when there are no events in a month, a message appears stating ‘No events available’.

NOTE:

• The Responsive Event Calendar features can only be used if you provide a start and end time for all events. If you have 'all day' / 'multi day' events you will still need to add start and end times
• There is a setting that will allow you to use the Responsive List without also displaying the Pop-up, visit Store > Configuration > Account Information & Preferences > Store Preferences and enable the ‘Disable Pop-up on Event calendar’ setting.
   

RECURRING EVENTS RECURRING EVENTS(IndieCommerce Members Only)

You can now add recurring events to your site. For example, if you have a story time that occur regularly, or a weekly book club, you can now easily add those to your site using one of the two options detailed below. One option allows you to create a new content type and list these events separately from your default calendar. The other, modifies your existing event content type to allow multiple date entries.

NOTE: Creating a calendar with recurring events requires ABA to enable the ‘Date Repeat API’ and ‘Date Repeat Field’ modules for your site. If you have not done so already, please contact us with a request to enable those for you. Example: Please enable the  ‘Date Repeat API’ and ‘Date Repeat Field’ for us so that we may create a calendar with recurring events.

OPTION 1: CREATE A NEW CONTENT TYPE (if you want the recurring events to be listed separately from your default calendar)
Every site has an ‘Event’ content type created by default. With this option, you can create a new content type called ‘Recurring Event’ in which the date field can be made to accept multiple values.

NOTES:

• This will create a new content type on your site
• ‘Date’ field will have several options similar to the Google Calendar
• New content type will not appear in the default events calendar
• Can create a new calendar for these recurring events
• Will not appear in the ‘Upcoming Events’ view
• Will not be included in events feed (e.g. Shelf Awareness)
• Store staff should remember which content type to use - ‘Event’ or ‘Recurring Event’
• All recurring events have to be at the same time (e.g.  11am on Sundays)
• If using book lists, cannot have different books on each instance

CREATE THE CONTENT TYPE

Navigate to: Structure > Content Types > Add New Content Type

1. Fill in the ‘Name’ - Example: Recurring Event
2. Fill in the ‘Description’ - Example: Recurring Event - Event hosted by the store that occurs more than once
3. Fill in ‘Title field label’ - Example: Recurring Event
4. Save and add fields
5. Add new field - Label: Recurring Event Date - Field Type: Date - Widget: Pop-up calendar - Save
6. Under ‘Field Settings’ select ‘Collect an end date’ (optional) and set ‘Repeating date’ to Yes (required)
7. Save field settings

You have now created your new content type.

CREATE CONTENT UNDER THE NEW CONTENT TYPE

Navigate to: Content > Add Content > Recurring Event

1. Fill in ‘Recurring Event’ name - Example: Storytime
2. Fill in the ‘Body’ with any details about the event
3. Set the initial start and end date for the event Example: 6/24/2019 11 am to 6/24/2019 12 pm
4. Select ‘Repeat’
5. Complete the ‘Repeat’ settings as needed
6. Save

You have now created one event with the Recurring Event content type. You can repeat steps 1-6 at any time to add additional events with the same content type.

MANAGE THE DISPLAY OF THE NEW CONTENT TYPE

Navigate to: Structure > Content Types > Recurring Event > Manage Display

1. Select the gear icon to the far right of the date’ field
2. Adjust the following settings:
3. Choose how users view dates and times: Date and Time format
4. Display: Which dates are displayed
5. Multiple Values
6. Show: the number of dates to list on any given event
7. Starting from: We recommend entering the word now into this field so that only dates starting from now, forward appear.
8. Ending with: leave blank
9. Repeat rule: opt to hide the repeat rule itself from display
10. Update

OPTION 2: MODIFY THE EXISTING EVENT CONTENT TYPE (If you want the recurring events to be included on your default calendar)
By modifying the ‘EventDate’ field on the existing event content type, you can add multiple dates to a single event.

NOTES:

• This modifies the existing content type by changing the ‘Event date’ field
• ‘Date’ field can have a pop-up calendar option, no other bells and whistles
• Will appear in the default events calendar
• Will appear in the ‘Upcoming Events’ view
• Will be included in events feed (e.g. Shelf Awareness)
• Recurring events can be at any time (e.g.  11am on May/5, 10am on May/12)
• If using book lists, cannot have different books on each instance

MODIFY THE EVENT CONTENT TYPE

Navigate to: Structure > Content Types > Event > Manage Fields > Event Date

1. Set the ‘Number of Values’ to Unlimited
2. Save settings

Now when you go to create or edit existing events, you will be able to add multiple event dates/times. By default, all of the dates you add will be displayed on the event page. You can modify the event display to limit the number of dates that display by modifying the Event content type again.

NOTE: Once you have changed the setting to unlimited, if you change it back to a limited number, you will lose all the recurring events you have entered.

Navigate to: Structure > Content Types > Event > Manage Display

1. Select the gear icon to the far right of the ‘Event Date’ field
2. Adjust the following settings:
3. Choose how users view dates and times: Date and Time format
4. Display: Which dates are displayed
5. Multiple Values
6. Show: the number of dates to list on any given event
7. Starting from: We recommend entering the word now into this field so that only dates starting from now, forward appear.
8. Ending with: leave blank
9. Update

NOTE: If you have a view created that displays these recurring events as well, your view settings may need to be modified to display one date at a time. If you need assistance with this, write to [email protected]