EventList is a Joomla extension to manage and present events for your group, company or community.
Update September 2012: I haven’t tried it and it isn’t in the Joomla extensions directory yet, but the developer has released EventList for Joomla 2.5. My experience with EventList is limited to version 1.0.1 on Joomla 1.5.
As with any extension, back up your site before installing EventList.
Download the latest stable version of EventList. You will need at least the main component. You might also want some of the optional modules, plug-ins, translations, or third-party software available. I downloaded the Latest Events module, Joomfish content elements plugin and the Spanish translation.
Install EventList at Extensions – Install/Uninstall. Click on “Choose” and select the downloaded main component. Then click on “Upload File & Install”. Repeat this for any optional software. Joomfish content elements, however, are always installed at Components – Joomfish – Content Elements – Install.
Support for repeating events in EventList 1.0.1 requires a third-party plugin. Install it at Extensions – Install/Uninstall as above. Built in support for repeating events is planned for the upcoming version 1.1 of EventList 1.1.
This section is adapted from EventList’s quick start guide at Components – Event List – Help
As a Super Administrator, open the EventList control panel at Components – EventList:
Once in the control panel, EventList’s configuration is found in Settings. In Basic Settings – Image Handling, enable thumbnailing if available. Change other parameters as desired.
Still in EventList’s control panel, go to Categories and create at least one category. For example, if you have a music site you could use Rock, Ska, Electronic, etc. For each category you can set access permission levels. All events assigned to this category will only be visible for the group you have given access to. If you aren’t sure what to do here, simply create a category named default and work with it for now.
You will probably want to create and publish at least one menu item for EventList in the Joomla menu manager. EventList offers many different menu views:
- A simple list of events
- A category listing
- A category listing with limited number of events as preview
- A listing of the current day
- A detailed venue listing
- To a specified event
- To a category with all events assigned to it
- To a venue with all events assigned to it
- To the event submission form
- To the venue submission form
- A simple list of events and registrations the user submitted
See the demo for examples of some of them. When you create the menu item, don’t forget to assign any non-default template you might want to associate with it.
If you installed any modules, configure them at Extensions – Module Manager – Site. Using as an example the Latest Events module, find it in the Module Manager and open it for editing. In Details, enable it and set its desired location in Menu Assignment. Set any other desired parameters and press “Save”.
If you installed any plugins, configure them at Extensions – Plugin Manager. Using as an example the Repeat Event Plugin, find it in the Module Manager and open it for editing. In “Details”, enable it. Set the “Anticipation windows in days” value as desired (default value is 30). See “Repeating Events”, below, for a discussion of this setting. Set any other desired parameters and press “Save”.
If you will delegate day-to-day EventList administration to someone else, that user needs access to Joomla’s backend. I recommend assigning that user to the Manager group, which grants the least privileges needed.
If you will want to assign a venue to an event you should create the venue before creating the event. Create a venue at Components – EventList – Venues – New.
Create an event at Components – EventList – Events – New. The required fields are Event title, Category, and Details – Date. Details – Start and End (optional) are the starting and ending times of the event and if given must be in 24 hour format. Set any other desired parameters and press “Save”.
When creating or editing an event, open “Repeating Events” and set as desired. The field “By the end of” is for the ending date. To the right of that field are two icons: a calendar (click to open a calendar) and a looping arrow (click to set the repetition to the maximum time allowed; more on this below). Press “Save” as you normally would.
You will be returned to the list of events. Notice that the repeating events haven’t yet been generated. To generate them, do two things. First, go to Components – EventList – Housekeeping and press “Trigger autoarchive”. Second, acting as a site visitor, click on a menu item for EventList as you created above in “Configuration”. The act of loading this page generates the repeating events.
Now, a few notes on repeating events:
When you generate a repeating event as described above, a separate event is created for each date. This implies that you should not create an event that repeats forever: it would consume infinite space in your database. To protect you, EventList won’t let you create repeating events beyond X days in the future. By default that limit is 30 days and is set in the parameter “Anticipation windows in days” described above. That looping arrow button I mentioned above will make the event repeat up to this limit.
Consider another implication of each instance being a separate event. Imagine that you generate five years of weekly meetings, and later the meeting place is changed. You would have to manually edit or delete each previously generated meeting separately. So this suggests that it’s not in your interest to generate too many repetitions at a time.
If you find EventList to be useful, please consider making a donation to the project.