Display Multiple Sets of Events with the JCal Pro Flex Module

The JCal Pro Flex module allows you to cleanly and compactly display multiple calendars and lists of your JCal Pro upcoming events.

This image below shows three examples of the JCal Pro Flex module:

final result

The JCal Pro Flex module has the option to display multiple event calendars and event lists using only one module. 

In this tutorial, you will learn how to use the Flex module to display two mini-calendars and one list of your JCal Pro events. Just like on the above image.


Step #1. Preparation

  • Create JCal Pro category "Team".
  • Create JCal Pro category "Developers".

categories

Create the following event in the "Team" category:

  • Title: Team Meeting.
  • Event date: set it to the next Tuesday,  starting at 5 PM and finishing at 6 PM.
  • Repeat Method: Repeat Weekly, Tuesday.
  • Repeat Occurrences: End after 20 occurrences. 

team meeting event

  • Create the "Developers Meeting" in the "Developers" category following the same steps. Only this time, set it to repeat daily, starting at 8 PM and finishing at 9 PM.

With your JCal Pro events created, you are now ready to create your JCal Pro Flex module to display them.


Step #2. Create Team Calendar Panel

  • Go to Extensions > Modules > New
  • Click JCal Pro Flex.

click jcal pro flex

  1. Enter Upcoming Meetings in the Title field.
  2. Select Horizontal from the Layout field.
  3. Click Hide for the Show Title field.
  4. Select Js_wright > above-content for the Position.
  5. Click the Panels tab.

main details

  1. Select Mini-calendar.
  2. Click the plus icon.

switch the panel to mini calendar

  1. You will see the Panel 1 - Mini-calendar panel. Enter Team Calendar in the Panel Title field.
  2. Click Save.

enter team calendar click save

  • You will see some new fields appeared. Select the Team category from the Category Filter field.

select team category

  • You will see the Team category appeared inside the Category Filter box. Click Save at the top.

team category appeared

  • Now check your site front-end. You will see this first panel displayed.

check front end

Well done! You just created one of the three panels with your JCal Pro upcoming events. Two more to go.


Step #3. Create Events List Panel

The next panel will display upcoming events from both the Team and the Developers event categories.

  • Repeat the same steps to create the second panel with events.
    • Set it as Events list.
    • Enter Meetings List for the Title and click Save.
    • Select Starts in Future for the Date Range.
    • Enter 3 in the List Limit field.
    • Set the Show Description to No.
    • Set the Show Categories to No.
    • Click Save.

second panel

  • Now check your site front-end.

check front end

You can see your JCal Pro Flex module now displays the two panels. One - as a mini-calendar of your team meetings and another one - as a flat list of all the upcoming meetings. 


Step #4. Create Developers Panel

In this step, you'll create the last panel. It will display a mini-calendar of your developers' meetings. 

  • Select Mini-calendar and click on the plus icon.
  • Enter Developers Calendar in the Panel Title field.
  • Click Save.
  • Scroll down to Panel 3 - Mini-calendar.
  • Select Developers inside the Category Filter.
  • Click Save.
  • Now check your site front-end. You should see all three panels displayed.

check front end

Well done! You just learned how to compactly display two mini-calendars and one list of events in one module position using JCal Pro Flex module. 

In the last step, you will learn how to customize its feel and look to match the overall style of your Joomlashack Wright template.


Step #5. Create a JCal Pro Flex Module Style

To perform this step, you will need to download, install and enable the Add Custom CSS Joomla plugin. If you never worked with this plugin, please visit our tutorial "Add Custom CSS to Your Joomla Site".

  • Once you installed and enabled it, create an empty custom.css file in the root of your Joomla installation.
  • Add in the custom.css file the following code:
.jcalpro_flex_pane {
border: 1px solid #f5f5f5; 
max-width: 26%; 
padding: 5px; margin: 5px;
background-color: #f5f5f5; 
border-radius: 4px;
}

.jcalpro_calendar_nav_next { 
background-color: #4CAF50;
color: white; 
border-radius: 50%; 
padding: 3px;
}

.jcalpro_calendar_nav_prev {
background-color: #4CAF50;
color: white; 
border-radius: 50%; 
padding: 3px;
}

.jcalpro_events_event {
list-style-type: none; 
background: #cce5ff;
margin-bottom: 2px; 
border-radius: 4px; 
padding: 5px;
}

.jcalpro_flex_pane h4 {
text-align: center; 
color: #777; 
font-size: 15px; 
margin-bottom: 5px;
}
  • Go to Extensions > Plugins.
  • Find the Add Custom CSS plugin and open it for editing.
  • Type custom.css in the Custom CSS File Path 1 field.
  • Click Save & Close.

type custom.css in the first field

If you check your site front-end now, you will notice that your Flex module looks much more stylish and appealing. It's style now also matches the feel and look of the site overall.