Event & Calendar Guide

How to master feature-rich event registration and calendars.

Download PDF
Current Version: McKinley 10.0
Note: A newer version of this book is available. Use the version dropdown to switch to the newest version.

Updates for McKinley 10.0

Below is a summary of the updates for this version.

  • Added details for using Discount Codes after registration.
  • Added new features and configuration for group placement

Updates for McKinley 4.0

No updates made.

Updates for McKinley 5.0

Below is a summary of the updates for this version.

  • Added chapter on registration payment reminders.
  • Added information on disabling the editing of the information on already saved registrations.
  • New chapter on the Registration Placement Group features.
  • New information on the new Registration Template field for setting the batch name prefix.
  • Documented the new registration instance and following features.

Updates for McKinley 6.0

Below is a summary of the updates for this version.

  • You can now add a workflow to a registration instance and template that will be fired at the completion of the registration process.
  • New "Show Family Members" option on Registration Template when registrants are in the same family.
  • Documented the new digital signatures feature.
  • Added Set Group Member Attribute information to Group Placement chapter and updated screenshot.

Updates for McKinley 7.0

Below is a summary of the updates for this version.

  • Added information on the new wait list feature.
  • Updated Event Registration screenshot.
  • Updated Event Occurrence screenshot.
  • Added information on linking to existing content channel items in the Event Occurrence detail screen in the Calendars chapter.
  • Added Set Group Member Attribute information to Group Placement chapter and updated screenshot.
  • Added filtering options and Group Placement Tab information to Managing Event Registrations chapter.

Updates for McKinley 8.0

Below is a summary of the updates for this version.

  • Updated list of Person Fields available for Event Registrations in the Registration Templates chapter to include "Connection Status".
  • Updated Fee Editor screenshot and callouts.
  • Added iCalendar Feed chapter.
  • Broke Registration Fees out into its own chapter.
  • Broke Discounts out into its own chapter.
  • Updated the Registration Template General Settings documentation to include the Registrar Options feature.

Updates for McKinley 9.0

Below is a summary of the updates for this version.

  • Added Default Payment Amount note
  • Added "Use Current Person" for registrar
  • Updated "Registrant form's" image and "Registrants form fields" image
  • Added Registration Attributes
  • Added Conditional form fields
  • Added Maximum Attendees information in the Instances Image
  • Updated Registration Fees Chapter with new fee types
  • Added Event Occurrence Attribute in the event details section
  • Added Event Item Occurrence Attributes
  • Added chapter on Event Wizard

Updates for McKinley 11.0

Below is a summary of the updates for this version.

  • Registrants can optionally replace an auto-applied discount code with a different code

Welcome

The power of Rock's tools is the synergy they bring when they work together. This is certainly true in the area of event management. So as not to overwhelm though we’ll start by describing each of the available tools as a stand-alone component. Once we have that complete we'll dive into how you can use them together for mind-blowing results.

Enable SSL

Be sure to enable SSL on your website before taking registrations with payments.

Event Registration Overview

For many events it's good to know who will be coming. Rock's event registration features provide a simple tool to not only know who is planning to attend, but also to take care of many of the mundane tasks like event payments. The first thing that people want to know about event registration is the feature list. While not inclusive (you'll have to read further for that), below is a list of the major features contained in event registration:

  • Free/Paid Registrations
  • Partial Payments
  • Additional Fees
  • Single or Multiple Registrant Registrations
  • Discounts (Percentage and Fixed Amounts)
  • Notifications
  • Custom Entry Forms
  • Confirmation and Reminder Emails

Didn't see a feature you need? Keep reading...it's probably in here.

The Basics of Event Registration

Before getting too deep, let's establish some of the key terms and concepts related to event registration.

Registrar vs. Registrant

There are two parties involved with every registration that occurs. The registrar, the person who is actually entering the registration, and the registrant, the person who is registered for the event. In some cases this could be the same person. For instance, Ted Decker may register himself for an upcoming event. Many times though this will not be the case. Ted Decker might register his two children for camp. In this latter case, Ted would be the registrar while his two children, Noah and Alexis, would be registrants. While we're often most interested in the registrants for an event, we also need to be able to store and report on the registrars.

Registration Templates vs. Registration Instances

As you use the event features you'll find that many of your registrations are actually identical in terms of costs, fees and fields. To simplify the process of creating new registrations in these cases we've created the concept of a Registration Template. The template is where you'll configure the majority of the settings for a registration (things like costs, required entry fields, fees, etc.). Once the template is complete, you can create instances of them that configure the settings that would be specific to the event (registration start and end dates, contact info, etc.). Still a little confused? Let’s look at some examples.

It's likely that you'll create an event registration for events like a new members class. These classes happen often, but their event registration configurations will all be the same. You would create a registration template for this class, then create registration instances from this template with the proper dates and contacts.

On the other hand, an event like summer camp is probably different each year. In this case you may have a custom template with a single instance each year.

The split between templates and instances has one final benefit. It allows you to separate security for configuring a registration from the security settings for implementing a new registration. For instance, you'll probably want to limit who can adjust costs, fees and discounts, while delegating who can set up a new registration for a reoccurring event.

The Role of Groups

By this point you've probably seen how important groups are in Rock. Groups also play a role in event registration. In many cases the end point of the event registration process is the placement of the registrants into a group that you configure. While you're not required to have your event registrations add people to groups, in most cases you'll want to enable things like event check-in.

You can also do other clever things with the relationship between registrations and groups. Since nothing is keeping you from having more than one registration linked to a single group, you can handle complex registration scenarios. Say that your summer camp can only take so many boys vs. girls. In Rock you could set up two different registrations with separate caps for boys and girls. Both of these registrations can also put their registrants into the same group, giving you a single list of all children attending camp. After the registration is complete, you can then add the registrants to one or more additional groups using the Group Placement features.

See our Rock Your Groups guide for more information.

A Typical Event Registration

Hang in there - we're almost to the meat. First let’s make a quick overview of what an event registration will look like to your members. The example below uses the default registration out of the box. While you'll see that this experience is simple and mobile-friendly, we plan to create even simpler experiences for very basic registrations (think: give me your name and we're done).

Let's get some background on the registration we're walking through below. In this case Ted Decker will be registering his two children Noah and Alexis, as well as Alexis' best friend Katie for camp. The camp costs $200 but also has an optional fee for a t-shirt.

Registration Walk-through
1Step one
Tell us how many people you plan on registering. Technically, you'll only see this screen if you've enabled Allow Multiple Registrants. Otherwise you'll be limited to a single registrant. As you can see, Ted has selected three registrants.
2Information 1
And we’re off! We'll start by entering the information required for the first child. In this case Ted has entered Katie's information.
3Information 2
Now we see the entry form for the next child. Let's pause here for a second and mention that while this case has one form for each registrant, Rock allows you to configure multiple entry screens for each registrant. OK, back to the registration. You'll see that Ted has entered Alexis' information. Notice how we've put an asterisk marking part the page. Since the registration was configured to Ask if registrants are in the same family, that's exactly what it's doing. This will help make sure that the data that is entered into Rock is consistent with the actual family structure of the individuals being registered.
4Information 3
Now it's Noah’s turn. Again notice the family selection. Ted has selected that Noah is in the same family as Alexis.
5Payment
Now it's time to pay up! Here we see a nice break down of the costs and fees. We have the opportunity to enter a discount code as well as enter the amount we wish to pay today. You'll also note that the registrar can enter their information here too. Like the registrants, they can select which family they belong to.
6Confirmation
Done!

Event Wizard

The process to create an event has a lot of moving parts, and it’s essential to include all the right information in them. The Event Wizard is a tool designed with your staff in mind. This gives administrators an easy way to train the rest of the team on how to create events.

You might be thinking, “When would I ever need to use this tool?” Great question. The fact is you don’t need this tool to create event registrations, but once you see its capabilities, you’ll be asking, “Why would we ever create events any other way?”

Overview

Creating events involves much more than the event details. Events include but are not limited to, registrations, groups, calendar occurrences, and well... finances.

Let’s jump right in and look at this tool, and all it has to offer.

Take the Step

Summer is coming, and that means camp is right around the corner. You’ve had camps in previous years, so the registration template is solid with everything a registration needs for this event to be successful. This year, you and the rest of the administrative staff have decided to pass the baton to staff members to create their registrations in Rock. This is a huge deal, pat yourself on the back for this great handoff.

But wait! The Students Director isn’t the most tech savvy person to be creating registrations in Rock. Are you sure this is a good idea? Yes, it’s still a good idea; in fact, it’s the best idea you’ve had in a while. It takes five simple steps to create a typical registration, and some of these steps are even optional.

Administrators have no fear, check out the Event Wizard Block Properties section for details on customizing this tool for the whole staff. As for the rest of your staff, use the below steps for training purposes on using this tool

Wizard in Use

Ted Decker has recently stepped into the temporary role of overseeing all students’ and kids’ events, and they are making plans for this year’s summer camp. With all the details in hand, Ted is going to log into his Rock account and begin creating the registrations for camp.

He’ll open the Event Wizard page (that you have so kindly configured for him) and he’ll begin by choosing the registration template. Mentioned above, the registration templates will already be created and ready for use. If for some reason someone needs a different template, you’ll want to create that for them and make sure it’s allowed on their Event Wizard block settings.

Follow along the step by step settings on the Event Wizard below.

Registration Template
Page 1
1 Registration Template
A drop down with preconfigured registration templates. This will populate the instance tab with the needed information for the type of event
2 Campus
Choose a specific campus that the registration belongs to or choose “all”
This option is only enabled if calendar events are enabled in the block settings
If this option is enabled and a specific campus is selected (rather than “All”), it will also set the campus for the group created in step 3
3 Contact
Use the person picker to choose the primary contact for the registration. This will be the logged in person automatically
Registration Instance
Page 2
1 Registration Name
This is the name that will be shown during the registration process. It’s used to describe the event that you are registering for
2 Registration Starts
The date the registration is open
3 Registration Ends
The date the registration is closed
4 Send Reminder Date
The date and time a reminder will be sent
5 Maximum Attendees
The total amount of people allowed to attend the event
6 Cost
Registration Cost
7 Account
The account where the payments will be collected. This can be set by default in the template. It is a required field.
8 Public Name
This section will autofill from the registration name. It can optionally be changed to something different from the registration name
9 Slug
A slug is a standard web term that refers to a part of a web address that identifies a page or component of a page using human-readable keywords
10 Registration Customization
Contains the Registration instructions, additional reminder details, and additional confirmation details. Review the Registration Instance section in this manual for more details
Registration Instance
Page 3
1 New Group Name
Create your event group that the registration will place registrants into
2 Parent Group
Choose a parent group for the new group to be under
3 Location
Based on the check-in block settings this option will be available
4 Schedule
Follows the same rules are the location option
Registration Instance
Page 4
1 Event
Dropdown to choose a preconfigured Event Item from the calendar list
2 New Event
If the block setting allows for it, the user can create a new event on this page
Registration Instance
Page 5
1Location Description
The description where the event will be held
2Schedule
When will the event occur? Check out the Event Occurrences section for more details
3Occurrence Notes
This note will be shown on the calendar details screen on the public website

The rest of this document provides more details for the steps above with some additional settings that can be set. However, this tool will get any event off the ground and ready for registrants.

Event Wizard Block Properties

Registration Instance
Block
1 Name
Block property name
2 Default Account
Selects the financial account which will be pre-filled on page 2 if the cost is set on the instance
3 Default Calendar
The default calendar which will be pre-selected if the staff person is permitted to create new calendar events
4 Available Registration Template
The list of templates the staff person can pick from
5Root Group
The start of the group tree for the staff person to pick a parent group
6 Registration Instance Page
Determines which page the "View Registration Instance" link in the final confirmation screen will take you to
7 Group Viewer Page
Determines which page the "View Group" link in the final confirmation screen will take you to
8 Require Group
Yes or No to require a group for created event registrations
9 Set Registration Instance Active
If unchecked, the new registration instance will be created, but marked as inactive
10 Enable Calendar Events
If calendar events are not enabled, registrations and groups will be created and linked, but not linked to any calendar event
11 Allow Creating New Calendar Events
If set to “yes” the staff person will be offered the “new event” tab on page 4 and create both a new event and a new occurrence for that event
12 Require Calendar Event
Yes or No to require the staff person to put this registration in an event
13 Include Inactive Calendar Items
Show inactive calendar items to choose from in the list
14 Completion Event
A workflow that will be launched when a new registration is created
15Check-in Group Types
Select group types which should enable check-in. If the selected registration template is one of these types, check-in options will be enabled for the group
16Display Link to Event Details Page on Confirmation Screen
Check this box to show the link to the event details page in the wizard confirmation screen
17External Event Details Page
Determines which page the link in the final confirmation screen will take you to if the Display Link is enabled

Registration Templates

As you've already read, templates contain a majority of the Event Registration's configuration. There's a lot to cover, so let's get started. To keep it simple, we'll break the screen down into bite-sized chunks. You can edit registrations under Tools > Event Registration.

General Settings

General Settings
1 Template Name
The name of your template.
2 Active
When a template should not be used anymore you can deactivate it. You could also delete it, but that would also delete all the registrations that use it.
3 Category
To help organize registrations, you can organize and secure them by category.
4 Description
You can optionally provide a description for the template.
5 Group Type / Group Member Role / Group Member Status
These fields help tell Rock what settings to use when it drops the person into a group. In this case they will be placed into the group with the Role of Member and the Status of Active.
6 Allow Multiple Registrants
Fairly straight forward.
7 Maximum Registrants
This indicates how many people you can register at one time.
8 Registrar Options
This option allows the event coordinator to auto-complete the registrar's information with the first registrant's information as well as hide the registration form altogether. This is useful and streamlines the process when the person registering is also the registrar (say, for example when someone is registering themselves for an event). The options for this setting are:
  • Prompt for Registrar - This default setting displays the standard registration form and process.
  • Prefill First Registrant - This setting auto-completes the registration with the first registrant's information. This is helpful when the registrants don't log in to register for the event but you still want to auto-complete their information.
  • Use First Registrant - This setting also auto-completes the registration with the first registrant's information, but it also hides the registration panel during the Review Registration step of the process unless the form doesn't collect the registrant's email address. In this case, the registration panel will be displayed during the Review Registration step since that information is required for registration communications.
  • Use Logged In Person - This setting will use the information of the person who is currently logged in to your website. Any information that is known about the registrar will be "locked" and unable to be edited, but any missing information (for instance, if their email address is blank on their record) will be able to be filled in during the Review Registration step, as above.
9 Registrants In The Same Family
Creating the family structures during the registration process can be tricky. This setting allows you to give Rock hints about the people that are registering for the event. If you're hosting a pastors' conference, you'll probably want to enter No since the registrants are most likely not in the same family. Rock will then create new families for each registrant. Yes will assume that all the registrants are in the same family. Ask enables the cool functionality you saw during the walk-thru above. It provides a very elegant way for the registrar to tell you the family make-up.
9a Show Family Members
Selecting Yes or Ask on the previous Registrants in same Family option, will enable this setting. Checking Yes here allow users who are logged in to select one of their existing family members for each registrant in a convenient drop down list -- a real time saver for family events. If you choose Ask, the family list will not be available until you indicate that the current registrant is in the same family as the currently logged in person.
10 Enable Wait List
Checking this box will enable the waitlist functionality. See the chapter on waitlists below.
11 Notify
When someone registers for an event we often can’t wait to find out. This setting allows you notify several different parties.
  1. Registration Contact: This is configured on the registration instance.
  2. Group Followers: The groups that the registration is linked to can be followed by people with view permissions.
  3. Group Leaders: All of the individuals that have roles that are marked Is Leader in the group linked to the registration will receive an email.
12 Add Person Note
When checked registrars and registrants will have a note added to their timeline that denotes that they have registered for the event.
13 Login Required
Requiring the guest to login ensures that a duplicate record is not created for the registrar, but it does come at the cost of requiring the guest to login (and possibly register for a login) on your site.
14 Set Cost On
This setting determines where the cost will be set, on the template where all registration instances will share it, or on the instance.
15 Cost
The cost of the registration.
16 Minimum Initial Payment
This is the minimum amount that must be paid at the time of registration. Leaving the field blank will have the effect of requiring full payment.
17 Financial Gateway
The financial gateway you would like the financial transactions to be processed with.
18 Batch Name Prefix
Optional prefix to add the financial batches. If left blank the prefix from the registration block will be used.
19 Default Payment Amount
This is an optional setting that lets you specify the amount to be filled in by "default" when registering for an event. The amount you configure here will be filled in automatically, but the registrar will have the option of changing the amount down to the Minimum Initial Payment, if they wish. Note: this only works if the Minimum Initial Payment is greater than zero
20 Registration Workflow
This setting allows you to set a workflow to be run with each registration. A similar setting exists on the instance if you need a different workflow per instance.
21 Allow External Updates to Saved Registrations
This setting keeps individuals from editing a registration once it has been saved. It's common that someone may come back to a registration to make a remaining payment. While there they can change any of the registrant information. Disabling the feature keeps these edits from occurring.
22 Required Signature Document
Here you can set a digital signature document to be sent out after each registration. The 'In-line Signature' setting determines if the digital signature should occur during the registration process (after filling in each registrant) or if the request for a digital signature should be sent via email after the registration is complete.
23 Show Communication Settings
Since the communications settings for a template are rarely changed we've hidden them from everyday viewing. Select this checkbox to view these settings.

Digital Signatures

Let's take a moment to point out a really powerful feature that we glossed over a bit. Rock can automate the sending of requests to get digital signatures after each registration. We cover this topic in detail in the Admin Hero Guide.

Forms

Now for the fun part - creating the entry form. When you see the power here you'll have no choice but to smile.

Form Field List

At a minimum you must collect the registrant's first and last name. But in most cases you'll want to add at least a couple more fields.

Form Field Editor

When adding fields, you have your choice of where and how they're stored. Let's look at each type.

  • Person Field: These fields come right off the person's record. They include things like:
    • Campus
    • Address
    • Email
    • Birthdate
    • Gender
    • Marital Status
    • Phone Numbers
    • Connection Status
  • Person Attribute: This type allows you to take what they've entered and place it into a person attribute.
  • Group Member Attribute: This allows you to store their entered values into a group member attribute of the linked group.
  • Registration Attribute: The final type allows you to configure new attributes that will be stored within the registration.

You'll notice a few other settings on the add screen. These settings allow you to:

  • Common Value: Filling out forms can be tedious. This setting allows you to take the entered value from the first registration and auto-populate the same field for the subsequent registrants.
  • Internal: This setting allows you to define the attribute, but keep it from being displayed on the external registration form. It will be made available however when editing the form internally. This is used for internal fields that will be entered after the registration takes place, or for simply displaying, for example, an existing person attribute on the grid for event-administration purposes.
  • Use Current Value: In an effort to reduce the amount of data that must be entered, this setting takes the current value from the registrar's record. This is especially helpful for attributes like 'Address'.
  • Show On Grid: This will place this attribute on the grid of registrants. It can be very helpful as long as you limit the number of items you put on the grid.
  • Pre-Text / Post-Text: Like the workflow entry forms, these fields allow you to surround your entry fields with custom HTML markup. With some basic web design knowledge, you can use these fields to create richer experiences.

Conditional Registration Fields

In many cases unique information will apply to each registrant. Event registration form fields have conditions that control whether they are shown/hidden based on the registrar’s selection of a prior form field value.

Gender field

The conditional field options - in this case, the Team Color Preference will be different based on the Gender selection.

Conditional field from Gender selection

First we'll have to add the form field on the event registration template, after creating the field a filter icon-button will be shown on the forms grid.

Registrant Attribute

Clicking on the icon on the Form Field List. will display the criteria selection for that field.

Add Criteria

Click save. Now you can see that the fields with conditional rules have a highlighted filter button.

Registration Attributes

While customizing the template for your event, you can add Registration Attributes directly from the same section. This would allow for the collection of attributes about the registration that do not pertain to a specific registrant. Use the icon to open the attributes page.

Registration Attribute Editor
1 Template Name
The name of your template.
2 Registration Attributes
Attribute drop down, located on the main template section below the registration forms.
3 Add the attribute
Clicking on the plus button opens the attribute window to configure attributes for this event template.

Below you can see the Registration Attribute window open. Here You will create the attribute for the event. In the categories drop down, you can choose to show this attribute at the start or end of the registration. Leaving the categories section blank will assume the attribute be displayed at the end of the registration.

Attribute Page

Great, now in this event template, every instance will have the same attributes on the registration.

Confirmation Email

After completing the registration, you can set up a confirmation email. This email also acts as an emailed receipt.

Confirmation Email Settings

While you're free to modify this email, we've provided a template that should work in most cases. Below we've shown what this sample email will look like. Note that the highlighted section comes from the Additional Confirmation Details field of the registration instance.

Default Confirmation Email

Reminder Email

We all appreciate reminders. Especially for events we may have registered for long ago. On this screen you can edit the reminder emails. When you create the registration instance (discussed next), you will configure when this email will be sent.

Reminder Email Settings

Again, we’ve provided you with a capable template (shown below). One thing to note here is that the template relies on the registration instance's Additional Reminder Details to set when the event will occur. We've highlighted this part in the email below.

Payment Reminder Email

Allowing partial payments is great, but getting the remaining balance has always been difficult. That was until Rock came around. There's now several tools for getting the remaining balance quickly and easily. The configuration items in this section help setup the communication tools for these reminders. For the most part you can leave them as is. You can read more about these tools in the 'Payment Reminders' section below.

Reminder Email Settings

Terms / Text

Event registrations can be used for several different kinds of events. To help fit different types of events, we allow you to customize many of the terms used during the registration process. In this section you can also configure the success text that displays on the final page of the registration screen.

Terms and Text Settings

Registration Instances

Now that we understand how to make registration templates, we're ready to implement them for specific events. There are several places where you can create registration instances. Since we're already familiar with the registration template screen, let's first create a new instance here.

Instance Settings

Clicking the from the instance grid will bring up the instance editor shown below.

Registration Instance Settings
1 Registration Instance Name
This is actually an important field that will be shown during the registration process. It will be used to describe the event that you are registering for (e.g. Thank You for Registering for "_______").
2 Active
This determines if the registration instance is currently active.
3 Registration Starts
The date and time that the registration starts.
4 Registration Ends
The date and time that the registration ends.
5 Account
The financial account that the registration costs/fees should be tied to.
6 Contact Name / Phone / Email
The information that should be displayed as the contact for the registration process.
7 Maximum Attendees
Means how many total number of people can register for the event.
8 Registration Workflow
You can optionally configure a workflow to run at the end of each registration. The registration will be passed in as the entity on the workflow. A similar setting exists on the template if you would like to ensure that all instances have the same workflow.
9 Send Reminder Date
The date and time that the reminder should be sent.
10 Additional Reminder Details
This text is used in the reminder email template defined on the registration template. It's important that you include information on when and where the event will occur. For more information on the reminder email, see the template section above.
11 Additional Confirmation Details
Like the reminder details, this field is used to provide additional, instance-specific, information to the template stored on the template.

Setting the Price on the Registration Instance

As we discussed in the chapter on Registration Templates you can optionally set the cost of an event on the Registration Instance. When configured, the price options will be shown on the screen above.

Follow A Registration Instance

After saving a registration instance you can choose to follow it by selecting the icon in the upper right corner of the details block. This will add it to the list of followed instances on your dashboard.

Now that we've shown you how to make a new registration instance from this page, we should tell you that you'll rarely ever create an instance from here. More about that later in the chapter Bringing It All Together.

Registration Fees

We get it - events are tricky and often come with odd requirements for additional fees. We've tried to think of as many combinations as possible when creating the features here so we have a lot to cover.

Fee Types

Below is a chart of the various types of fees that are available. You can use any combination of these to create the fee structure you need for each registration event.

Types of Fees
Fee Types
1 Single Option Fee
You either want it or you don't.
2 Single Option Fee with Quantity
You can get as many as you want.
3 Multiple Options
Variety is the spice of life.
4 Multiple Options with Quantity
What's better than a little spice? A whole lot!

Now that we see what's possible, let's look at how to set up fees.

Setting Up Fees

You can add, edit and delete fees in the Fees section of the Event Registration screen.

Fee List

Click the button to create a new fee.

Fee Editor
1 Name
This will be used for the label that goes above the fee selection.
2 Options
Here is where you'll make the determination of whether the fee has multiple options. When selected, it will display a key/value input that allows you to enter optional text as well as the cost.
3 Enable Quantity
Pretty obvious what this does (enables the quantity picker).
4 Discount Applies
Sometimes you'll want the discount calculation to apply to fees sometimes not.
5 Is Active
Check this box to make the fee active. Inactive fees will not be displayed for new registrations, but will be displayed when viewing charges for existing registrations.
6 Maximum Available
If a max available quantity is not specified, it is an unlimited item. Adding a number to this field will show the remaining available items when registering.

Optional vs. Required Fees

Fees can be either optional or required. To designate a fee as required select the Is Required checkbox on the Fee Editor screen. Required fees are designated by a red dot on the event registration screens. If a registration is submitted with a missing required fee value, Rock will display a message asking the registrar to select a value before proceeding.

Here's a closer look at how Rock handles each of the fee types above when they are designated as required:

  • Single Option - Rock automatically checks the box and disables it to prevent changes.
  • Single Option with Quantity - Rock sets the minimum quantity to "1" and prevents it from being changed to less.
  • Multiple Options - Rock creates the same dropdown list as an optional fee, but displays a message if no value is selected.
  • Multiple Options with Quantity - Because at least one option must have a value selected, Rock displays a warning if all options have a value of "0".
Required Fees Options

Keeping the Is Required checkbox on the Fee Editor screen unchecked creates Additional Options in the registration.

Optional Fees Options
Registering with Optional Fees

Fee Reports

All of the fees for each registration are listed under the Fees tab on the Registration Instance screen. You can use the filter options to filter the information by date range, fee name, and/or one or more of the options that apply to that fee. (Note: because the options vary with each fee, the available filter options are only displayed once a particular fee name is selected.)

To further help you track and work with fees, you also have the option of exporting fees to an Excel spreadsheet. To do this, click the button on the Fees tab on the Registration Instance screen.

Discounts

People often ask, "Do you have quantity or early bird discounts?" Well, Rock has something better. Rock's discount feature gives you a ton of flexibility to create discounts customized for your organization's needs. Want to provide a discount code? You can do that. Want to offer a discount for a families registering more than three children? You can do that, too. How about a unique combination of both of these only for a limited time and you want the discount to be automatically applied? Yep, Rock's got you covered. Let's take a closer look at these options and how they work.

Discounts are listed in the Discounts section of the Event Registration screen. Here you can add, edit and delete discounts.

Discount List

Click the button to create a new discount.

Discount Editor

All of the discount options are available in the Discount Code screen. From here you can create whatever combination of criteria you want for each discount.

One Discount Per Registration Instance

Keep in mind that only one discount can be applied to each registration instance. If multiple discounts are set up to automatically apply, and if the registration qualifies for all of them, then the first discount listed in the template will be applied. When a discount is automatically applied, a code cannot be manually entered.

OK, let's take a closer look at each of the discount options.

Discount Codes

Discount codes allow you to give individuals a code to reduce the amount of their registration. This discount can be in the form of a percentage of costs/fees or a fixed amount. To create a discount code, enter a percentage or amount in the Discount Type and Discount Percentage fields of the Discount Code screen. Individuals can then apply the discount code at the time of registration, or after registering if they haven’t yet paid in full (see Post-Registration Discount Codes).

Quantity Discounts

Quantity discounts allow you to create a discount for multiple registrations in the same transaction, such as a group registration. To create this type of discount, enter the minimum and maximum number of registrants in the Discount Code screen. When Rock processes the registration, if the number of registrants entered falls within the parameters entered, the discount is applied.

Maximum Registrants

The number of Maximum Registrants reflects how many people within the registration can have the discount applied. If you have three registrants being signed up, and if Maximum Registrants is set to '1', then the discount will only apply to one of the three registrants. If you want to have a group or family pay only the price of a single person, set the Maximum Registrants to be 1 less than Minimum Registrants, and make sure the discount covers all the costs and fees of only a single person.

Early Bird Discounts

Early bird discounts apply a discount for registrations that fall within a certain date range. That date range is entered in the Effective Dates fields of the Discount Code screen. When Rock processes the registration, if the date of registration falls within the entered timeframe, the discount is applied.

Customized Discounts

You can create your own, unique discount by combining any of these discount types. Just know that when the registration is processed, all of the criteria you enter has to be met for the discount to be applied. So, that super complicated option we mentioned above? Maybe not the best practice.

Automatic Discounts

The Discount Code screen includes an option to automatically apply the discount. If this option is selected, Rock will automatically check the registrations against the discount codes available and apply the first discount that matches the criteria. The order the codes are listed in the Event Registration screen is the order in which Rock applies them.

Maximum Usage

You can limit the number of times a discount code can be used by entering a value in the Maximum Usage field. Leave this field blank if you want the discount code to be available for use indefinitely.

Viewing and Reporting Used Discounts

Once discounts for a particular registration event are used, they're recorded under the Discounts tab in the Registration Instance screen. You can filter these records by:

  • Date Range - Displays all of the discount codes used during the dates specified.
  • Discount Code - Displays the discounts matching the code selected from the dropdown menu.
  • Discount Code Search - Displays all discount codes that match the search criteria, whether it be a word, partial word or number. For example, if you search for "ly", Rock will display any codes with names that contain "ly". If you create discount codes with specific prefixes, such as numbers or abbreviations, the search function can help you quickly locate all of the codes matching a particular prefix. Note: If you select a discount code from the dropdown menu, the discount code search option will be disabled.

The amounts displayed in the Totals for Results section of the screen are based on the discount codes displayed. If you filter the discounts, the totals will be recalculated and updated based on the filter parameters.

Managing Event Registrations

Now that you're comfortable creating event registrations, let's see how to manage them through the registration lifecycle.

Promoting Your Registration

The easiest way to give your guests access to an event registration is through a calendar event. The Bringing It All Together chapter below covers the process of linking calendar events to registrations. Once linked, the event detail will display the Register button as shown below.

Event Detail Page With Registration Link

You can also link directly to an event registration using a URL. The formats for doing so are:

  • http://www.yourexternalsite.com/page/999?RegistrationInstanceId=999 (where the page id and registration instance id match the appropriate values)
  • http://www.yourexternalsite.com/Registration/<slugname> (you can find more on slugs in the Bringing It All Together chapter below)

Managing Registrations

You can manage the registrations by going to the Event Instance Detail Page:

Tools > Event Registration > Registration Detail > Registration Instance.

At the top of this page you'll see the details of the registration with an Edit button to modify its settings. You'll also notice a number of tabs toward the bottom of the page, each relating to a different component of the registration process (registrations, payments, etc.). The content on each of the tabs can be filtered using the Filter Options link.

Registrations Tab

The Registrations Tab shows all of the registrations that have been entered into the system. Remember these are registrations that could have multiple registrants.

Registration Instance Detail Page

From this tab you can view and edit an existing registration or manually add a registration yourself (great if you also allow paper registrations).

Registration Edit Screen
1 Registration Details
This shows the details of the registration including information on the Registrar. You can easily resend the confirmation email from here.
2 Registrant Details
Next you will see a panel for each registrant on the registration. You can also edit their registration details from this screen.
3 View Edit Payments
This link allows you to view and edit payments. We'll discuss this further below.
4 Audit Log
This button allows you to view information about how the registration was entered and any financial changes that were made.
5 Move Registration
Sometimes a registration needs to be moved. Perhaps the person registered for the wrong instance of the event, or maybe they just changed their mind. Don't worry, moving a registration is easy! You can however only move the event to an instance using the same registration template (moving them across different templates would be rather difficult as there would be different fields, costs, fees and discounts.) This button allows you to complete the move of the registration.
6 Add New Registrant
Notice that at the bottom of the screen you can add more registrants to the registration if needed.

Registrants Tab

The next tab shows a listing of all registrants for the event, including summary information about groups, fees and placements. This list is also filterable. Clicking a row will show you the registrant's details as well as the rest of the related registration information. If this screen seems familiar, it's because it's the same screen as the one above except that we scroll down to the selected registrant's information.

Registration Instance Registrants

Payments Tab

The payments tab allows you to view all the payments that have been made for registrations for this instance. Clicking on one of these tabs opens a financial transaction for the payment. From this transaction detail screen you can process a refund for the payment.

Registration Payments

Fees Tab

This tab displays all of the registration fees associated with the event. The information can be filtered and exported to a spreadsheet. Be sure to read the Registration Fees chapter to learn how fees work with event registration.

Registration Instance Registrants

Discounts Tab

This tab displays all of the discounts that have been used, as well as a lot of useful information about the discounts. You can view which codes were used, who used them, how many times each discount was used, and the total costs of the discounts. As with the other tabs, the information provided in this tab is filterable and can be exported to a spreadsheet.

Registration Instance Registrants

Linkages Tab

This tab will make more sense once you read the Bringing It All Together section. Basically, it shows all the related calendar events and groups that are linked to this registration.

Registration Instance Registrants

Wait List Tab

This tab displays any registrants placed on the wait list as well as allows you to move them off of the wait list. To learn more about wait lists, see the Wait Lists chapter below.

Registration Instance Waitlist

Group Placement Tabs

If you've set up Placement Configuration in your registration template, you'll also see one or more tabs related to those placements. This is where you can sort registrants into groups. See the Registration Group Placements section to learn more.

Registration Group Placement

Wait Lists

We know your events are going to be popular. So popular, in fact, that you probably won't be able to fit everyone. Don't worry, Rock's wait list features will ensure that you can manage the crowds. Let's take a look at how these features work.

Registration Entry

You can enable the wait list features on registration templates. Then, you'll configure the maximum number of registrants on registration instances. When the event is full, individuals will see the message below when they attempt to register.

Wait List Warning

At this point, the individual can decide not to register or to add themselves to the waitlist. Let's look at a slightly more complex scenario. What if there is only one spot left and the person is hoping to register two individuals? When they arrive at the page they'll see a normal registration page. But, when they select more people than there are slots available, they'll get the message below.

Wait List Warning (Partial)

In this case, let's assume that they would like to continue with registering both kids for camp. You'll notice that the registrant entry screen below looks fairly normal but has an additional notice at the top reminding them that this individual will be fully registered for the event.

Registrant Screen

As they move to register the second child they will notice that the reminder is now warning them that this individual will be on the wait list. Careful observers may have noticed that the number of entry fields has changed. (We're not asking for Leader Preference, etc.) You have the option to configure registration form fields for the wait list or to hide them.

Group Member Entry Fields

Since individuals on a wait list are not added to configured groups, entry fields that are stored as group member attributes cannot be shown.

Wait List Screen

As they move to the payment screen, note that those on the wait list are not charged for the registration. They are simply holding a spot.

Wait List Payment

It's very important that we're clear about who is on a wait list and who is a full registrant. To this end, both the confirmation screen and the email reflect the individual's registration status.

Wait List Confirmation Screen
Wait List Confirmation Email

Wait List Administration

Now that we're familiar with the process of registering for a wait list, let's look at how you can administer wait lists.

From the registration instance screen, you'll notice that registrations with individuals on a wait list are clearly noted on the list. There is also a Wait List tab to help you view and manage the wait list.

Registration List

The Wait List tab allows you to view those on the wait list with their placement order. If you would like to move an individual from the wait list to a full registrant, simply select the checkbox in front of their name and select the Move From Wait List button at the bottom of the grid.

Wait List Tab

After you select to move them you'll see the screen below confirming that they have been moved. At this point the new full registrant will be added to any groups that were configured. If you'd like to send them an email to confirm the move and request additional fields simply select the Send email to individuals checkbox.

The email that is sent will remind them if any payment is due and also ask them to complete the registration if any additional fields are needed.

Wait List Move Confirmation
Wait List Move Email

While this feature makes moving people from the wait list a simple process, you can also convert a full registrant to a wait list member or a wait list member to a full registrant from the registration details screen.

Registration Payment Reminders

Allowing partial payments is great, but getting the remaining balance has always been difficult. That was until Rock came around. Now there are several tools for getting the remaining balance quickly and easily.

Rock provides several tools to allow you to easily receive the amount owed. Let's look at all your options!

Manual Reminders

One way to remind individuals of remaining balances is to manually send them a reminder. You can do this from the Registration Instance page.

Once you click the Send Payment Reminder link you'll see the page below. This page allows you to customize the reminder text and who should receive the email.

1From Name
The "from" name and email as well as the subject should be filled in for you based on the values supplied from the registration template. You can edit these values to suit your needs.
2Message
Next you see a preview of the email the individuals will receive. The preview uses the information for the first person on the grid below to give you a precise view of what the person will receive in their inbox.
3Template Toggle
You can choose to edit the email template if you wish by clicking the Source toggle. This will display the Lava template that creates this email.
4People
Below the preview you'll see a list of those with a remaining balance. When creating the list, Rock looks at the Payment Reminder Time Span setting for the registration template. If the registration has already received a reminder or was created within this timespan, the registration is greyed out and is not selected (the checkbox is checked). You can, however, override this and select specific registrations or all registrations.
5Button
Click the Send Reminders button and you're off to the races!

Automatic Reminders

Manual reminders are nice, but automatic ones…well they're even better! If you provide a Payment Reminder Time Span on the registration template, Rock will send an automatic reminder to the registrations based on that timeframe. So for example, if you provide the value of 30 for the Payment Reminder Time Span, they will receive a reminder every 30 days until their balance is paid.

This sending is done through the Event Payment Reminders job under System Settings > Jobs Administration. This job does have one configuration parameter you should be aware of. The job Cut-off Date is the number of days past the registration close date to send reminders. After this cut-off, reminders will need to be sent manually to prevent eternal reminders.

Registration Group Placements

Sometimes registration isn't over once all the information is collected. In fact, sometimes that's just the beginning. That's certainly the case with events like sports teams and camps. After everyone’s registered, you still need to form teams and camp groups. This can be a daunting and laborious task, but that's where Rock's group placement features come to the rescue. They allow you to easily sort registrants into one or more groups with minimal effort.

For these tools to kick in, you need to first enable them on your registration template. Let’s take a look at how that’s done.

Placement Configuration

Registration templates have a panel called Placement Configuration where you can define areas into which registrants should be sorted. Ultimately this will mean placing registrants into groups, but those groups can be created and added later in the process. For now, let’s look at the Placement Configuration options available in the registration template.

Registration Template Placement Configuration
Registration Template Placement Configuration

From the Placement Configuration panel pictured above, you can see the list of the template’s placements and a summary of their setup. After your template is configured, each of the items in this list will appear as a tab within the registration instance. Click the button to add new placements to the list.

Edit Placement Configuration
Edit Placement Configuration
1 Name
Provide a name for the placement. This name will appear as a tab within the registration instance.
2 Group Type
When adding a new placement, you are required to select a Group Type. This controls what type of groups registrants can be placed into.
3 Icon CSS Class
You can optionally set an icon for the placement.
4 Allow Multiple
If you select this box, then a single registrant can be placed into more than one group in this placement type. In the example pictured above this option is selected because registrants can participate in more than one activity. You probably wouldn’t want to enable this for something like bus assignments, because each person should only be assigned to a single bus.
5 Shared Groups
Use the button to add groups to the Shared Groups list. This will be the list of groups into which you can place registrants, which we’ll explore in detail below. These groups are shared across registration instances that use this template. Only want a group for a single instance? Read on, we’ll cover that soon.

Once the placement feature is configured, you’ll see an extra tab for each placement group you’ve defined. From these tabs you can quickly place the registrants into groups. Let's see how this works.

Registration Instance Group Placement
Registration Instance Group Placement
1 Placements
In the example pictured above, there are three placement areas. This matches the Placement Configuration list defined on the template.
2 Add Group
Click this button to add a group to this registration instance. You can either create a new group directly from this page or you can add an existing group.
3 Placement Configuration
Click the icon to access additional placement configuration options. There are a lot of options here, so we’ll discuss them in detail below.
4 Registrants
A searchable list of registrants lets you easily drag and drop individuals into the group placements on the right. If applicable, you can update the configuration (from the icon) to display registrant attribute values such as “Cabin Preference”.
5 Placement Groups
Each group into which a person can be placed is listed here. Group requirements and limits are enforced when adding individuals into these groups, so you can leverage the group’s configuration to help ensure people are placed appropriately.
6 Labels
Placement groups that have been added to the registration template will appear with a “Shared” label. This is a handy reminder that the group is shared across registration instances. You can also use the Add Group button to add groups to this instance only, which assigns a label based on the instance name.
7 Capacity Count
If a group has a capacity, then this label will appear and will be updated automatically as registrants are placed. In the example pictured above, “Swimming” has a limit of two registrants (it’s a very small pool) with one space already taken by Noah Decker’s placement.

Next, let’s look at some of the placement configuration options available within the instance. These settings are used in addition to the registration template’s placement setup. Click the icon to access them.

Edit Instance Placement Configuration
Edit Instance Placement Configuration
1 Highlight Genders
If enabled, registrant names will be highlighted pink or blue according to the person’s gender.
2 Show Fees
Enabling this option is useful for cases where a person should only be placed into a group if they have paid certain fees.
3 Displayed Registrant Attributes
Choose which attributes should be displayed for each registrant on the placement screen. This makes it easy to place camp registrants into their desired locations.
4 Filters
You can restrict the list of registrants by adding filters here. In the example pictured above, filters can be added according to registrant attributes or fees. You can also add a person filter to, for example, filter by age or grade.
5 Group Configuration
You can choose to display Group and/or Group Member attributes if any are configured. You can also choose to Hide Full Groups if you don’t want to display groups that have reached capacity.

Registration Template Placement Page

This page is a lot like the group placement tabs described above, with one key difference. This page references a template, combining the registrants from different instances. This is ideal for placing large volumes of registrants quickly and easily.

Registration Template Placement Page
Registration Template Placement Page

This page can be accessed from the registration template detail page by clicking the icon as pictured below.

Access Registration Template Placement Page
Access Registration Template Placement Page

Registration Finances

Paid registrations come with the additional complexity of having to work with money. Rock provides several tools to make this as simple as possible while also ensuring that there are good protections in place for proper accountability.

Adding Payments

While most of the time payments for events will be handled by the registrar during the registration process, you can manually enter payments on their behalf from the registration details page:

Tools > Event Registration > Registration Template > Registration Instance > Registration (ok... that seems complex, but it's really not as bad as it looks on paper...)

From the Registration Details page you can manage payments using the Payments tab pictured below.

Registration Payments
Registration Payments

Once you click the link you will see the Payments Edit Panel. The screenshot below shows you all the options on this screen.

Payments Edit Panel
1 Payment Detail
Clicking on the date of the payment will take you to the financial transaction detail page for the payment. From here you can get more information about the payment and process a full or partial refund.
2 Process New Payment
Selecting this option allows you to run a new payment through Rock.
3 Add Manual Payment
This optional allows you to enter the details of a manual (off-line) payment.

Refunds

Processing full or partial refunds through Rock is simple. Simply click the Date / Time link shown in call-out #1 above to proceed to the financial transaction detail page for the payment. From here you will see the screen below. Note the refund button at the bottom of the page.

Clicking the Refund button will show the refund modal below.

Payments Edit Panel
1 Amount
This tells Rock how much the refund should be for. By default the full amount of the financial transaction is entered into the box.
2 Refund Reason
This dropdown allows you to pick from a standard set of refund reasons. You can modify this list under Admin Tools > General Settings > Defined Types > Refund Reasons
3 Summary
This field allows you to enter specific notes about the refund.
4 Process Refund Through Gateway
This checkbox determines if the refund should be automatically run through the payment gateway or just entered into Rock (unchecked).

Partial Payments

Partial payments are a popular feature for events with higher costs, like camps. The age ol' problem with them comes when it's time to complete the payments. Many times people want to pay off the balance, but they're not sure how. Other times... well... they just need a reminder. Let's look at several strategies on how to make partial payments work for you.

Reminder Emails

The default email template for event reminders will provide a summary of the amount due with a link to complete the payment. Remember that the reminder emails can be sent out more than once by changing the send date to the future after the initial reminder goes out.

Recent Registration Block

Rock also ships with a Recent Registration block on the My Account page of the external website. This block lists any recent registrations and notes if a payment is due. Clicking the link will take them to a page where they can complete the payment or apply a discount code.

Recent Registration Block

Post-Registration Discount Codes

Not only does the Recent Registration block allow individuals to make payments against an outstanding balance, they can also apply a discount code (see Discounts). This is great if they find out about the discount after registering, or if they simply forgot to apply the code when they first registered.

To apply the discount code the individual needs to access the Review Registration page from the Recent Registration block, the same way they would to make a payment as described above.

Review Registration Page
1 Discount Code
Individuals enter a discount code here to apply the discount toward their remaining balance.
2 Apply
If a valid discount code has been entered, pressing the Apply button will immediately apply the discount to the individual’s balance (pressing Finish is not required).

Individuals who have already paid in full will not be able to enter a discount code after registering. Similarly, individuals who have already used a discount code can’t apply an additional discount code.

If the discount ends up deducting more than the individual owed, the result will be a negative balance on their account. In that case you’ll need to manually issue a refund (see Refunds) to get the balance back to zero.

Calendars

There are three components that make up Rock's calendar capabilities: Calendars, Events and Event Occurrences.

Calendar Components

One might wonder why we need separate events and event occurrences. Couldn't we just put the schedule on the event and be done with it? That would certainly work, but there are cases where the same type of event, say Baptism, happens repeatedly. Having separate event and event items allows us to do things like list all the upcoming baptism dates.

Event Calendars

Every organization has the need for multiple calendars. Even a small organization will have a public and private (internal) calendar. Most will have several more. You can administrate calendars under Tools > Calendars.

Out of the box Rock ships with two pre-configured calendars:

  • Internal: Used for internal events like staff meetings retreats, etc.
  • Public: For events targeted towards your members and attendees.

Events Can Be Placed On More Than One Calendar:

Sometimes you'll have an event that should be displayed on more than one calendar. Rock supports this. An event can be on any number of calendars you'd like.

Calendar List

You can add additional calendars by selecting the add button in the upper right of the panel. When adding or editing a calendar you will see the screen below:

Calendar Details
1 Name
The name of the calendar.
2 Active
Whether the calendar is currently active.
3 Description
A quick reminder of what the calendar is for and how it should be used.
4 Icon CSS Class
The Font Awesome icon class the calendar should use.
5 Event Attributes
Each calendar can define custom attributes available to the events that are on them. This is where you define these attributes.
6 Content Channels
We'll cover content channels later in the Bringing It All Together chapter. For now just know that you can link content channels to events to allow you to easily promote them.

Calendar Security

You can set up security for each calendar you define. This allows you to delegate the management of these calendars and their events. You set security from the Calendar Details Page by pressing the button.

Events

Once you've created your calendar, you're ready to place events on them.

Tools > Calendars > Calendar

Shows a list of the current events for a calendar on the Calendar Details Page. As you get more and more events you'll want to start using the filters on this grid to help you manage the events that are displayed.

The event add/edit screen below shows you how to manage the events on the calendar.

Calendar Details
1 Name
The name of the event.
2 Active
Whether the event is currently active.
2 Approved
If you have 'Approval' permission to the calendar you'll be able to approve the event here.
4 Summary
A quick description of the event that will display on the calendar when listing multiple events.
5 Description
A more complete description of the event that will be displayed on the event detail page.
6 Audiences
This helps to categorize the events by those who would be most interested. These are the same audience choices that are used for the other web content channels.
7 Photo
A picture is worth a thousand words right? So don’t skimp - include one on your event.
8 Additional Calendars
As we mentioned above, you can place your event on as many calendars as you'd like.
9 Details URL
If you provide a web address here it will be used instead of the Rock event details page when your guests click 'More Information' from the calendar.
10 Attribute Values
Remember how we could define custom attributes for the events on custom calendars? This is where you'll add the values for these attributes. The attributes are grouped by calendar.
11 Event Occurrence Attributes
Define an attribute on an Event Item where the value is set on each of its Event Item Occurrences.

Follow An Event

After saving an event you can choose to follow it by selecting the icon in the upper right corner of the details block. This will add it to the list of followed events on your dashboard.

Event Occurrences

We have our calendar and now, events. All that's left is to add the event occurrences that determine when these events occur. Some events may only occur once, while others apply often. Either way, you'll add the occurrences from the Event Details Page.

Event Instance Edit
1 Campus
First we must select which campus this event will occur on (single campus organizations can select either all or the main campus).
2 Contact Information
Next we select who the contact will be and provide their email and phone number.
3 Location Description
Now we can describe the location where the event will be held. Instead of using a location picker, we decided to allow you to enter a more descriptive text of where the event is being held.
4 Schedule
Ok, now for the important part. When will the event occur? Hopefully by now you've had a chance to use the Rock Schedule Builder tool in other features. It's a powerful tool for defining complex re-occurring schedules. It also does simple one-time schedules too.
5 Registration Instance / Group
Most often, you'll want to create a registration for your calendar event. Instead of having to leave the screen to create the registration instance, you can do it right here. We'll talk more about how to do this in the Bringing It All Together chapter.
6 Occurrence Note
This note will be shown on the calendar detail screen on the public website. It's used to provide custom notes about the specific occurrence.

You might be thinking, "Hey! Reoccurring schedules? I thought we were supposed to create a new occurrence each time the event occurred?" Yes... and no... Some occurrences of an event may last two to three weeks (say a single occurrence of a three-week stewardship class). In this case, make a single occurrence with a reoccurring schedule.

Once you save your calendar occurrence, you'll be taken to the occurrence detail screen. From here you'll see that you can click the button to add a new content channel item, or you can click the button to link to an existing content channel item. Adding and connecting with content channel items allows you to enter and track promos for your event.

Event Instance Detail

Event Occurrence Attributes

You can create specific attributes to assign to event occurrences. For example, you could create a "Lunch Provided?" attribute to use with recurring staff meetings. Then for each meeting assign that attribute a value of "Yes" or "No". As with all attributes, the possibilities are endless and completely customizable for your organization's needs. Keep in mind when creating these attributes they will be available for every calendar event.

To create an event occurrence attribute value, click the button on the main Event Calendars screen to access the Calendar Attributes screen.

Calendar Attributes

In the Event Occurrence Attributes section, click the button to create the new attribute. Once saved, the attribute is available in the Attribute Values section of the event's Edit Event Occurrence screen.

Event Item Occurrence Attributes

Hang on, what if I know an attribute will ONLY be used for one event occurrence? Well, in this case, you can set your attributes within the Event Details, such as your staff meetings. Scroll to the bottom of the Event Details page for the Event Occurrence Attributes panel and expand it. Click the button to add a new attribute.

Event Item Attributes

Now in the Attribute Values section of the event's Edit Event Occurrence screen, you will see all the specific event attributes along with the global attributes created in the Calendar Attributes screen.

Calendar Blocks

Below is what the calendar looks like on the external website. These blocks have a ton of settings (much of the page is rendered in Lava so the possibilities are endless).

Calendar Block
Event Detail Block

iCalendar Feed

Once you have your event calendars up and running, you can use Rock's iCalendar feed feature to create dynamic calendars in Outlook, iOS, OSX iCal, Google Calendar and Android. This means you and the members of your organization can have access to event calendars right in your pocket. The iCalendar feed is accessed by URL, which you add to your email client or calendar program. The process will vary depending on the program you're using, but most programs have an option for adding a calendar from an internet address. Once you add the event calendar URL to your program, it will sync and stay updated with that calendar in Rock.

Calendar Settings and Formatting

There are a couple of things about the iCalendar feed you should know before going forward. First of all, any security added to calendars is enforced, so you need to have access to any non-public calendars you want to use with the iCalendar feed. Second, Rock takes care of providing and formatting the calendar content. You can, however, customize the calendar's description by adding the following Lava to the Lava template:


                {{ EventItem.Description }}

                {{ EventItemOccurrence.Note }}
            

(Remember, Lava templates can be found at Admin Tools > General Settings > Defined Types > Lava Templates.)

OK, let's take a look at the iCalendar URL itself.

Calendar URL

The format of the URL has a specific format:

http://rocksolidchurch.org/GetEventCalendarFeed.ashx?calendarid=1
This sample URL provides the feed for a calendar located at rocksolidchurch.org with an ID of "1" .

There are three parts to the URL: the organization's domain name (i.e., rocksolidchurch.org), the GetEventCalendarFeed function, and the calendar parameters (i.e., calendarid=1). The domain name and the parameters will change according to the organization and the desired calendar options, but the GetEventCalendarFeed.ashx portion must remain unchanged in order for the feed to work.

Let's take a closer look a the parameters available for customizing the calendar feed. You can use parameters to tell the feed to pull only events from a specific campus, specified dates, or even from a certain Lava template. The following parameters are available with the iCalendar feed:

Parameter Description Example
templateid The Lava template ID for the iCalendar description. If this is not specified, the default is used. The default is a concatenation of the EventItem Description and the EventItemOccurrence Note. templateid=1234
campusids A comma separated list of campus IDs. Default is all campuses. campusids=2,4,12,9
audienceids A comma separated list of audience IDs. Default is all audiences. audienceids=5,6
startdate The earliest date to get calendar info. Format: yyyyMMdd. Default is the current day. startdate=20180501
Enddate The latest date to get calendar info. Fomat: yyyyMMdd. Default is two months from the startdate. Enddate=20180701

So, using our same URL sample above, if you want to grab the feed for events on the public calendar from April 1, 2018 through July 7, 2018, the URL feed would be:

http://RockSolidChurch.org/GetEventCalendarFeed.ashx?calendarid=1&startDate=20180401&enddate=20180707

To filter the above URL for two audience types, the URL would be:

http://RockSolidChurch.org/GetEventCalendarFeed.ashx?calendarid=1&startDate=20180401&enddate=20180707&audienceIds=147,1698

Now, you could build the iCalendar feed URL yourself; but to make things super easy, you can also quickly grab the URL for the event calendar you want to use by going to the Event Calendar screen and clicking the Export Calendar Feed button.

Calendar Components

Bringing It All Together

Hopefully you're starting to see the symbiotic relationship between event registrations and calendar events. The fact that they share the same manual should tell you that they go together like peas and carrots (or steak and potatoes). We've also seen that groups can be linked to registrations, and that content channels also have a role with calendar events.

You might be wondering how you're going to manage all these items for a specific event. We did too, so we worked hard to make it as simple as possible. Here’s how.

While you can link registrations, events, groups and content channel items many different ways here's the easiest.

  1. Create your event group that the registration will place registrants into.
  2. Create your calendar event and occurrence. While editing your occurrence select the Add New Registration Instance button. This will allow you to create and link a registration instance right to your event. You'll notice that this screen is the same one from the registration details, except that it has a few extra fields.
    1. Registration Template: We can choose which registration template we would like to use for the event. Doing this does assume that a registration template is already available for you to use for your event. If not you'll need to do that first.
    2. Group: From this screen you'll also be able to link the group you created in step #1.
    3. URL Slug: Say what?! A slug is a common web term that refers to a part of a web address that identifies a page or component of a page using human-readable keywords. If you're not Noah Webster, that means instead of saying Registration?RegistrationInstanceId=153, you can say Registration/SummerCamp2015 instead.
  3. After saving the occurrence, you can enter any content channel items you need for your event.

Once you create these linkages, you can view and manage them from either the calendar occurrence, group or event instance detail screens.

Url Slug Required

If your event occurrence is tied to a campus, the URL Slug must be used in order to have registrants be automatically placed into the correct group.

Securing Calendars and Events

There are two security roles that help secure the management of calendars and events. Let's look at each.

Securing Calendars

While those in the RSR - Staff Workers and RSR - Staff Like Workers roles can view and add new events only those in the RSR - Calendar Administration can approve events and create new calendars.

Securing Event Registrations

Like calendars those in the RSR - Staff Workers and RSR - Staff Like Workers roles can create new instances of registrations but only those in the RSR - Event Registration Administration can create new registration templates.

From a financial perspective anyone in the staff/staff-like roles can add payments to a registration but out of the box you will need to be in the RSR - Finance Administration role to process refunds.

Event Blocks

How you decide to display events to your guests will be very unique. Rock provides several blocks to help you craft the experience you desire.

See our Designing and Building Websites Using Rock guide for more information on blocks in general.

Calendar Block

This block is the basic calendar list block for your external calendar. The screen shot below shows the block in its default form, however this block comes with a ton of settings to change the way it is displayed. Below is a list of settings that this block provides.

  • Event Calendar: The calendar (public, internal, etc.) to pull events from.
  • Default View Option: Which view option (day, week or month) to initially show.
  • Details Page: The page to navigate to, to show the event's details.
  • Campus Filter Display Mode: Options to show a campus filter (Hidden, Plain, Panel Open, Panel Closed).
  • Audience Filter Display Mode: Options to show an audience filter (Hidden, Plain, Panel Open, Panel Closed).
  • Filter Audiences: Allows you to filter which audiences you'd like to show as filter options.
  • Show Date Range Filter: Determines whether a date range filter should be displayed.
  • Show Small Calendar: Determines whether the small calendar in the upper left should be shown.
  • Show Day View: Determines whether the day view should be shown as an option.
  • Show Week View: Determines whether the week view should be shown as an option.
  • Show Month View: Determines whether the month view should be shown as an option.
  • Enable Campus Content: Determines whether the campus context should be used to filter the events (assumes that a campus context is in use on your site).
  • Lava Template: The Lava template that will be used to format the list of filtered events.
  • Start of Week Day: Determines what day is the start of a week.
  • Set Page Title: Determines if the block should set the page title with the calendar name.
  • Enable Debug: This setting helps you create your Lava template by allowing you to view the Lava objects available.

Event Item Occurrence Detail

Once you pick an event from the calendar, this is the block that displays the details for the event occurrence. This page is formatted entirely using Lava, so customize at will.

  • Registration Page: The page to navigate to for registration.
  • Set Page Title: Determines if the block should set the page title with the event item name.
  • Lava Template: The Lava template that will be used to format the list of filtered events.
  • Set Page Title: Determines if the block should set the page title with the calendar name.
  • Enable Debug: This setting helps you create your Lava template by allowing you to view the Lava objects available.

Event Item Occurrence List

This is more of a specialty block. It lists upcoming occurrences for a specific event item. This is helpful for events like specific classes (e.g. Starting Point, Stewardship Class) or events that routinely happen (e.g. Baptisms).

  • Event Item: The event item to show occurrences for.
  • Campuses: Which campuses to show occurrences for.
  • Use Campus Content: Determines whether the campus context should be used to filter the events (assumes that a campus context is in use on your site).
  • Date Range: You can filter the occurrence list by a sliding date range (e.g. upcoming two weeks).
  • Max Occurrences: The maximum number of occurrences to show.
  • Registration Page: The page to navigate to for registration.
  • Lava Template: The Lava template that will be used to format the list of filtered events.
  • Set Page Title: Determines if the block should set the page title with the calendar name.
  • Enable Debug: This setting helps you create your Lava template by allowing you to view the Lava objects available.

Calendar Item Occurrence List By Audience

This is another specialty block. It lists upcoming occurrences for a specific audience (All Church, Youth, Children, etc.). This is helpful for pages devoted to these audiences.

  • Audience: The audience to filter on.
  • Calendar: Which calendar to use.
  • Use Campus Content: Determines whether the campus context should be used to filter the events (assumes that a campus context is in use on your site).
  • Date Range: You can filter the occurrence list by a sliding date range (e.g. upcoming two weeks).
  • Max Occurrences: The maximum number of occurrences to show.
  • Registration Page: The page to navigate to for registration.
  • Lava Template: The Lava template that will be used to format the list of filtered events.
  • Set Page Title: Determines if the block should set the page title with the calendar name.
  • Enable Debug: This setting helps you create your Lava template by allowing you to view the Lava objects available.

Event Calendar Item Personalized Registration

This is a quirky, but insanely cool little block. Its main use is to facilitate internal registrations for special classes from an individual's Person Profile page. Let's dig into a sample to understand this better.

Say your organization has a special orientation class called Starting Point. Previous attendance in this class is really important to you so you've created a special badge to show if someone has attended this class. But... you also want to easily be able to register people for upcoming classes when they call or email you. You can then set the markup of your badge to link to a page with this block if they have not attended Starting Point. This block takes the person and looks up upcoming class dates based on their campus. Once you select a date you can select other members of the family and create a registration to add them to the class.

It should be noted that this block creates an online registration and then redirects to the registration block to complete the process. This allows for the collection of extra fields configured for the registration and also allows for things like confirmation and reminder emails.

  • Include Family Members: Determines if a list of family members should be displayed to include in the registration.
  • Days In Range: The number of days in the future to filter event occurrences for.
  • Max Display Events: The maximum number of occurrences to show.
  • Registration Page: The page to redirect to, to complete the registration.
  • Start Registration At Beginning: You can optionally choose to redirect to the beginning of the registration process (a good option if you expect additional custom fields to be needed) or the end (a good option if additional fields are not needed as you can quickly complete the registration).

The block requires the following inputs through the URL:

  • PersonGuid: The Guid of the person to be registered.
  • EventItemId: The Id of the event item to process the registration for.
Improve