How to Create a Registration Form for JCal Pro Events

How to Create a Custom Registration Form for a JCal Pro Events

This week one of our JCal Pro customers asked how to create a custom registration form for their JCal Pro events. They asked this because the default registration form only asks for your name and email address.

You can enhance this default form using JCal Pro's custom form builder. In this blog post, I'll show you how to use it to create a custom registration form for your JCal Pro events.

This is a five-step process:

  1. Set up the front-end event registration feature.
  2. Create required event registration fields.
  3. Create a required event registration form.
  4. Assign the form to required event category.
  5. Enable participants registration for required events.

By default, event registration feature is turned off in JCal Pro. Your first step is to enable event registration capability in JCal Pro global settings.

Next, you need to create fields that you would like to be displayed in your custom event registration form.

Once you enabled JCal Pro event registration feature and created required fields, it is a good time to create your custom event registration form to contain and display these new fields.  

Your JCal Pro events categories are all set up to work with the default event registration form. You must explicitly assign your new event registration form to the required event category(ies). 

Finally, once your JCal Pro custom event registration form is ready, you need to enable event registration feature in the required event(s).

Let's take a look at this process in more detail.


Step #1. Enable frontend event registration

  • In your JCal Pro control panel go to Options:

01 options

  • You will see the JCal Pro Configuration page.

02 allow registrations

  1. Click the Environment tab
  2. Set the Allow Registrations to Yes
  3. Click Save & Close.

Next step is to tweak JCal Pro Access Control List.

  • Click the Registrations menu item:

04 registrations menu

  • Click the Permissions tab:

05 permissions tab

  1. Click the Guest tab.
  2. Select the Allowed setting for the Create action.
  3. Click Save & Close.

06 guest allowed


Step #2. Create the required fields

  • In your Joomla control panel, go to Components > JCal Pro > Fields:

go to components jcalpro fields

  • You will be taken to the JCal Pro: Fields fields creation screen. In the top left corner, click New:

click new

You will see the JCal Pro: New Field screen. Create your required field:

  1. Title: Enter your field title.
  2. Field Name: Leave this field empty. JCal Pro will populate it once you save the new field.
  3. Field Description (optional): Enter your new field description, if you wish.
  4. Default Value (optional): Leave empty.
  5. Field Type: Select your required field type.
  6. Form Type: Select the Registration Form option.

create your field

Next, you need to allow your JCal Pro event participants to fill in this new field. You will do this by setting the necessary permission. 

  1. Click the Permissions tab.
  2. Click the Guest tab.
  3. Select Allowed for the Create Data action.

click permissions guest allowed

  • Click Published under the Details:

click published

  • Click Save & Close.

Good job! By now, you turned on event registrations in your JCal Pro and created a new field. 

Next step - to create the custom form which, additionally to the default Name and Email fields, will use the newly created field(s).


Step #3. Create the required form

  • On the left menu, click Forms:

click forms

  • You will be taken to the JCal Pro: Forms administrative screen. In the top left corner of the screen, click New:

click new

  1. You will see the Form tab. Enter the form title into the Title field. 
  2. In the Form Type parameter select the Registration Form option.
  3. Click the Form Fields tab:

enter form title select registration form

  • You will see the Form Fields tab open with your new field. Click inside the field's checkbox:

click inside the field checkbox

  • In the Details column, parameter Published, select the Published option:

click published

  • Click Save & Close.

You will see the Item saved message on the light green background and your custom event registration form listed:

custom form saved and listed

Good job! You set your JCal Pro to allow event registrations. You also created your own custom event registration form with its fields.

At the moment, your events categories are all set to work with the default event registration form. You need to explicitly assign your new event registration form to the required event category(ies). 


Step #4. Assign the form to the required event category

  • On the left menu, click Categories:

click categories

  • You will see the JCal Pro: Categories screen. Click on the title of the events category to which you wish to assign your custom event registration form.

You will be taken to the JCal Pro: Edit Category administrative page. 

  1. Click on the JCal Pro Options tab.
  2. Locate the Event Registration Form parameter and set it to your new custom form.
  3. Click Save & Close. 

assign your custom form to this events category

Excellent! Your own JCal Pro custom event registration form is ready and assigned to the required events category.

But by default, events registration is turned off in each of your JCal Pro individual events' settings. You need to turn on registration for each of your required event(s).


Step #5. Enable registrations for the events

  • On the left side menu, click Events:

click events

  • On the JCal Pro: Events screen, click on the required event title:

click on the required event title

  • You will see the JCal Pro: Edit Event administrative screen. Click the Registration tab:

click the registration tab

  • On the Registration tab, click Yes:

click yes

  • Click Save & Close.

Congratulation! You finished creating your own custom event registration form for your required JCal Pro event(s).

When you check one of those events with enabled registration, you will see the form at work:

custom form at work


What's Next?

Save $1000's when you sign up to the Everything Club today! You' ll get access to all our extensions, templates, and Joomla training.


About the author

Born from a Ukrainian mother and Russian father, Alex lives in the United Kingdom. Alex is a self-taught Microsoft Certified Professional. He enjoys learning Joomla and helping web site administrators make the most of it.