Timetable Component Documentation

MX Timetable manages recurring weekly events and displays them in an interactive timetable. Administrators can organize events into timetables, configure how each timetable looks, and create Joomla menu items for the timetable, an individual event, or an event form.

Install or update

1. In Joomla administrator, open System → Install → Extensions.
2. Upload the component installation package (com_mxtimetable.zip) and complete the installer.
3. When updating, install the new package over the existing component. Back up the site before updates as a general Joomla maintenance precaution.
4. Open Components → Timetable to manage timetables and events.

Set up a timetable

1. Go to Components → Timetable → Timetables and create a timetable. Give it a name and publish it.
2. Configure any timetable-specific display options described below, or leave them set to Use component setting to inherit the global defaults.
3. Go to Components → Timetable → Timetable Events and create an event.
4. Enter a title, choose the timetable, select a weekday, and set its start and end times. Use 24-hour time (for example, 08:30). The end time must be later than the start time.
5. Add any optional event information, publish the event, and save.
6. Repeat for the other events in the weekly schedule.

Events with no timetable assigned appear only in an all-timetables view. A menu item for one timetable shows events assigned to that timetable.

Event fields

• Title: Event name. Events with the same title are grouped together by the timetable's title filter; published events with the same title are also shown as related events on each other's item pages.
• Timetable: The timetable this event belongs to.
• Day and time: Weekday and 24-hour start/end times. Events recur weekly; this component does not assign calendar dates.
• Event color: Choose Auto (day-based), one of the preset colors, or Custom color. Custom color also lets you choose the event text color.
• Location: Optional location name.
• Latitude and longitude: Optional decimal coordinates. Enter both valid coordinates to place a marker on the item's OpenStreetMap embed when the map is enabled.
• Location photo: Optional image for the location.
• Instructor and instructor photo: Optional instructor name and image. The photo visibility setting is independent of whether the instructor name is shown.
• Price: Optional non-negative amount. The currency symbol is configured in display settings.
• Description: Optional rich-text details shown when an event's details are opened.
• Published: Only published events appear on the public timetable and in related events.

Create frontend pages

In Menus, create a menu item and select the MX Timetable component type:

• Weekly Timetable displays events for all timetables or for one selected timetable.
• Single Item displays one event. Select the event in the menu item's required settings.
• ItemForm provides a frontend form for adding or editing an event. Set its item ID as directed by the menu-item setting; use 0 for an add form.

The frontend form includes the same event details as the administrator form. Joomla component permissions control who may create, edit, publish, or delete events. Grant only the permissions appropriate for your site, and test the menu item while logged in as the intended user.

Event titles on the timetable can link to their item pages when Link event titles to item pages is enabled. Item pages also provide Previous/Next navigation when neighboring published events exist in the weekly schedule. Users with sufficient permissions may see edit, check-in, or delete controls on item pages.

Display settings

Global defaults are in Components → Timetable → Options. Timetable records and menu items can override applicable settings; choose Use component setting (or leave a value blank) to inherit. For timetable options that say Use timetable or component setting, the component default is used if the timetable itself has no value.

Weekly timetable

• Show timetable title: Show or hide the heading.
• Show timetable category: Show or hide the selected timetable's name.
• Details trigger: Open event details by clicking, or show a tooltip on mouse hover where hover is available.
• Show event time, location, location photo, instructor, instructor photo, description, and price: Independently control which details are shown.
• Maximum description characters: Limit description length in event details. 0 means show the full description.
• Price currency symbol: Text displayed after event prices (global default is €).
• Frontend label overrides: Replace labels such as Title, Day, Time, Location, Instructor, Price, and Description. Leave a label blank to use the language's default text.

When events overlap, they share the available day-column width. Events that do not overlap can expand across adjacent free space, up to the full day column. On narrow screens, the weekly timetable becomes a vertically stacked list of days and events. A title dropdown filters events by title.

Event item page

• Show timetable category: Show or hide the timetable name in the event details.
• Show time, location, location photo, instructor, instructor photo, description, and price: Control the corresponding event fields on the item page.
• Show related events: Display other published events with the same title, ordered by weekday and start time. Their titles link to their own item pages.
• Show OpenStreetMap on item pages: Display a map when the event has valid latitude and longitude coordinates.
• Maximum description characters, price currency symbol, and frontend label overrides: Configure the item page as described above.

Permissions and access

The component uses Joomla ACL actions for component administration, management, creation, deletion, editing, state changes, and editing one's own events. Configure these under Users → Manage → Groups (or the site's permission settings). Frontend create/edit forms require the relevant permissions; public visitors should not be given write access unless that is intentional.