evList is a calendar alternative/solution. It is an event list. evList presents a well formatted list of events foregoing the bulky calendar tables, user friendly admin panels, numerous editor fields to ensure that no information is lacking, and a whole bunch more. evList supports recurring events, categories, and event reminders.
The evList Plugin uses the glFusion automated plugin installer. Simply upload the distribtuion using the glFusion plugin installer located in the Plugin Administration page.
The upgrade process is identical to the installation process, simply upload the distribution from the Plugin Administration page.
The only required fields in the event editor are the event title and the start date year and month fields. All other fields are optional.
This event is posted in html mode. The other option is plaintext and any html will be stripped from such a post. Those fields that accept html are the summary, full description, and location fields. Note that this example event has been given a start date (year and month) and no end date. That is acceptable. The only required dates here are the start date year and month. This makes the list much more flexible in terms of what kind of events may be listed. Keep in mind that if you provide a time or a day, you must provide a month, or if you provide a month, you must provide a year, etc. For example: you cannot have an end time without an end date.
evList supports recurring events and offers a number of basic formats to choose from for configuring your event. An example of a recurring event is provided for you (example #4).
Your events may be categorized. This is not required. If you wish to view uncategorized events, simply do not choose a category from the drop-down on the event list page.
Events make use of the same permissions system as GL stories and so can be easily restricted. The contact section of the event editor asks for an email address. This is not required of course, but rest assured that while you will be able to read any email displayed, that email is encrypted to protect from bots scraping your pages for email addresses.
Event reminders have made their way into version 1.1 of evList. Yay me! Unless an event is occuring within a week of now, an event reminder form will appear at the bottom of the event description. This form will take an email address and a number corresponding to days prior to an event in order for a reminder email to be sent that many days prior to the event. Reminders can be turned on/off per event, or globally.
If you wish, as admin, to be notified of submissions to the queue, add “evlist” to $_CONF['notification']. Events that reside in the submissions queue awaiting approval are disabled and cannot be viewed by regular users until approved. Events so submitted can be deleted from the list of submissions in the queue or may be sent to the editor for editing. Sending a submission to the editor will provide you, the admin, with event details that do not get listed in the submission queue.
Approving submissions can be accomplished two ways: either from the submission queue, checking the “approve” check box; or sending the event from the queue to the event editor, and then checking the “enable event” check box. Submissions that are sent to the editor from the queue are disabled by default and must have the “enable event” check box checked before saving the event or it will remain a disabled event.
Regular events may also be enabled/disabled via the “enable event” check box in the event editor. You can gain access to disabled events through the admin lists.
A speed limit is enforced for submissions made by any user without evList admin rights. The speed limits are defined in the plugin's config.php file. A speed limit is defined for event submissions and another limit is defined for event reminder requests.
Notice that this event does not have an address listed. This is OK. Remember that there are only 3 required fields in the editor: the title field and the start date year and month fields.
The day event check box in the event editor, if checked, causes the save event process to ignore any end time or split times that might have been supplied. An all day event goes all day after all. evList will display a small note on the event page that this event is an all day event.
A split event is and event that is split into one or more pieces, hence the name. evList supports your basic split where and event runs twice in one day. In this case the event will have 2 start and end dates. For example, an event may run in the morning and in the evening, but not in the afternoon. Rather than creating 2 events, simply supply start times and end times for the event on each side of the split
Regular events, all day events, as well as split events can all be recurring events–to be discussed in example #4.
No matter the date and time information that you've entered, if an event is set to recur, then it will–then it will. If you check the recurring event box further fields will be presented to collect such information as how often the event will recur and when it will stop recurring if it indeed does stop recurring. An end date is not required for any event, even a recurring event.
A number of basic formats are available to use for your event. Daily, monthly and yearly events are pretty basic. You can also choose to have an event recur on particular days per week, or on a particular day (e.g., 2nd sunday) per month. You may alternatively supply a list of dates upon which the event should recur.
An ending date is not required for recurring events, or for any events actually. If supplied, the event will only be displayed up to the end date, otherwise the event will continue to be displayed. A default display range for recurring events is hard-coded into the software to limit the number of events that are displayed. For example, if you have a daily recurring event that will recur for a year, only one month worth of recurrences will be displayed ahead of now. This default range is different depending upon the format chosen.
Depending upon the format chosen, recurring events might land on weekends and if that is not desired then you have the choice skip the event or to force it to the next business day. This applies to the daily (next business day not available for daily option), monthly and yearly by date formats.
evList supports the [event:] autotag. Arguments are..
Example: [event: 127456302 click here]
All evList configuration options are controlled in the glFusion Configuration System. Select Configuration from the Command & Control screen, then select evList.
| General Settings | |
|---|---|
| Allow anonymous users to view events? | Set this to TRUE to allow non-logged in users to view events. Set to FALSE to require that users login to see events. |
| Allow anonymous submissions? | Set to TRUE to allow non-logged-in users to submit events. All events from non-logged-in users will go into the submission queue. Set to FALSE to disable non-logged-in users submitting events. |
| Allow logged in user submissions? | Set to TRUE to allow normal, logged-in users to submit events. All events from logged-in users will go into the submission queue. Set to FALSE to disable event submission for logged-in users. |
| Allow HTML when posting? | Set to TRUE to allow HTML use in the event description and the event summaries. ALL HTML will be filtered through the glFusion HTML filtering engine. Set to FALSE to disable the use of HTML. |
| Enable Categories | Set to TRUE to enable category support. |
| Reminder Speedlimit | How often, in seconds, you can select to be reminded of an event. |
| Posting Speedlimit | How often, in seconds, you can post a new event. |
| GUI SETTINGS | |
| Enable the menu item | Set this to TRUE to enable a link for evList to be placed in the User Menu. See User menu link option for more options. |
| User menu link option | Select if the User Menu link is; Add Event or List Events |
| Week begins on… | Select which day the week should begin, Sundary or Monday. |
| Date Format | Select the date format to display dates in evList. |
| Time Format | Select the time format to display times in evList. |
| An event ceases to be upcoming… | Select when an event falls off the 'Upcoming' list: - as soon as the start date has passed, i.e.; the next day - as soon as the start time has passed |
| Number of events to display per page | Number of events to display per page. |
| Centerblock Settings | |
| Enable Centerblock? | Set to TRUE to enable the evList centerblock. |
| Centerblock Position | Select the position of the centerblock. |
| Topic | Which topic should the centerblock be displayed |
| Select an event range to display | Select which event range to include in the centerblock. |
| Number of events to display | Number of events to display in the centerblock. |
| Number of characters to display in event summary | Number of characters (width) of the centerblock. |
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
v1.2.4
v1.2.3
v1.2.2
v1.2.1
* Fixed issue where searching for & (or other special chars) would fail.
v1.2.0
form.