Creating Events
Let's explore how to seamlessly create and manage different types of events using the 'Add to Calendar' field within your FLEXIcontent item:
Create a New or Edit an Existing Item
- Begin by logging in to your Joomla administration panel.
- In the backend, navigate to the Components tab in the top menu (for Joomla 3) or in the side menu (for Joomla 4).
- From the dropdown menu, select FLEXIcontent.
- Choose Items.
- You can create a new item by clicking New and select the content type you've assigned the 'Add to Calendar' field to. Alternatively, you can click on an existing compatible item's title to begin editing.
- Navigate to the Your Item type (Details) tab, in order to access your custom fields.
Creating Events
Now, let's explore how to create and manage different types of events, all of which share common event details. When you click on the Edit button in the 'Add to Calendar' field, a form will open, allowing you to configure the details of your events. If you haven't linked these fields to item properties, you can set the following essential event details:
- Event Name: Provide a name for the event.
- Event Description: Add a description for the event.
- Location: Specify the event's location, which can be an address or a link.
- Start Date & Time: Set the event's start date and time. Not applicable when using multi-dates.
- All Day: You can mark the event as "All Day." Not applicable when using multi-dates.
- End Date & Time: Determine the event's end date and time. This field is available when the event is not marked as "All Day." Not applicable when using multi-dates.
Now, let's explore the different event types you can create:
- Single Event: Suitable for one-time events.
- Recurring Event: Ideal for events that occur on a regular schedule, set Recurring Event to "Yes". Choose the recurrence type based on your event's schedule. You can select from options such as daily, weekly, monthly, yearly, or use the more advanced RRule (Recurrence Rule) option.
-
- Recurrence:
- Daily: Set the recurrence interval in days (e.g., every 2 days).
- Weekly: Specify the recurrence interval in weeks, and you can also select which days of the week the event repeats on. This works together with the recurrence interval.
- Monthly: Define the recurrence by month type. You can choose a specific day of the month (e.g., 12th of the month) or use a weekday interval (e.g., every second Tuesday of the month). Selecting the weekday interval option opens a repeatable subform where you can set the day of the week and the interval (e.g., every second Monday or fourth Thursday).
- Yearly: This option allows you to set an event at yearly intervals depending on the reccurence interval you've set.
- RRULE (Recurrence Rule): is an advanced option for specifying complex recurring patterns for events, allowing you to define the frequency, interval, and other detailed rules for recurrence. Mind that the startDate needs to be valid within the given recurrence ruleset! Click here for a generator.
- Recurrence Interval: Set the inteval of the recurring event. This is available for each type of recurring event except when using the RRULE.
- Recurrence Until: This option defines an end date for the recurrence. Be cautious when using it, as the plugin attempts to count the number of repetitions, which might cause issues, especially when dealing with complex recurring events. If unexpected results occur, try setting a later date to accommodate any discrepancies.
- Recurrence:
- Multi-Date Event: For events spanning multiple dates, set Multi Dates to "Yes". This will open a "Dates" field, which is a Joomla subform field. In each subform field, you have these options:
-
- Event Name: Enter a distinct event name for each date. To use the global event name, which could be either the linked event name or the event name defined earlier in the 'Add to Calendar' field, leave this field blank.
- Event Description: Enter a distinct event description for each date. To use the global event description, leave this field blank.
- Event Location: Enter a distinct event location for each date. To use the global event location, leave this field blank. Remeber a location can be anything, e.g.: an adress or a link.
- All Day: Mark each date as "All Day."
- Start Date & Time: Set the start date and time for each date.
- End Date & Time: Determine the end date and time for each date. This field is only taken into account if the event is not marked as "All Day."
Edit Layout Parameters (Item)
To ensure your field appears in the item view, you'll need to place it within the item layout:
- In the toolbar, click on Edit layout & global parameters.
- Select the Fields placement tab.
- Locate the 'Add to Calendar' field in the Custom (non-Core) fields list.
- Drag & drop it onto one of the available zones.
- Click Save to save your changes.
Now, the 'Add to Calendar' button will be visible on your website, allowing users to add your events to their calendars. To preview it, use one of the preview methods from the toolbar.