Event List


The purpose of this plugin is to to show a list of events with date, time, content, location, etc. on your site by using a shortcode or a widget.

Current Features

  • Admin pages to view/create/manage/modify events
  • Available event data fields: event title, event startdate, event enddate, event starttime, event location, event content
  • Beginning and end dates for multi-day events
  • WordPress’s WYSIWYG editor for the event content. So you can include styled text, links, images and other media in your events.
  • A duplicate function for events to easier create similar event copies
  • Import multiple events via csv files
  • Event categories
  • Sync event categories with post categories
  • Filter events according to dates or categories
  • Include an event feed in your site


New events can be added in the WordPress admin area.

To display the events on your site simply insert the shortcode [event-list] into a page or post.
You can modify the listed events and their style with attributes. All available attributes can be found on the Event List -> About page in the WordPress admin area.

Additionally there is also a widget available to show the upcoming events in your sidebar.


If you want to follow the development status have a look at the git-repository on github.
Feel free to add your merge requests there, if you want to help to improve the plugin.


Please help translating this plugin into multiple languages.
You can submit your translations at transifex.com.
There the source strings will always be in sync with the actual development version.


  • Admin page: Event-List table
  • Admin page: New/edit event form
  • Admin page: Event-List Categories
  • Admin page: Event-List Settings (general tab)
  • Admin page: Event-List Settings (frontend tab)
  • Admin page: Event-List Settings (admin page tab)
  • Admin page: Event-List Settings (feed tab)
  • Admin page: Event-List Settings (taxonomy tab)
  • Admin page: Event-List About page (general tab) with help and about page
  • Admin page: Event-List About page (shortcode tab) with shortcode attributes list and date range formats
  • Admin page: Event-List Widget with the available options
  • Example page with [event-list] shortcode
  • Example Event-List widget on frontpage


The easiest version of installing is to go to the admin page. There you can install new plugins in the menu Plugins -> Add new. Search for “Event List” and press “Install now”.

If you want to install the plugin manually download the zip-file and extract the files into your wp-content/plugins folder.


How do I get an event list to show up in a Page or Post on my site?

Insert the shortcode [event-list] in your page or post. You can modify the output by many available shortcode attributes (see Event List -> About page for more infos).

How do I use styled text and images in the event content?

Event List uses the built-in WordPress WYSIWYG editor. It’s exactly the same process like in creating Posts or Pages.

Can I call the shortcode directly via php e.g. for my own template, theme or plugin?

Yes, you can create an instance of the “SC_Event_List” class which is located in the plugin folder under “includes/sc_event-list.php” and call the function show_html($atts). With $atts you can specify all the shortcode attributes you require.
Another possibility would be to call the wordpress function “do_shortcode()”.


November 24, 2020
Thanks to Mibuthu for publishing an update of this plugin. I use it for several years and it suits me perfectly. After much research, I have not found such a simple plugin that also perfectly corresponds to what I want to publish. Since there hadn't been an update in a long time, I was afraid that it would no longer follow wordpress updates. Thank you again to everyone who works there. Keep going for a long time. Hello from France.
November 3, 2020
I'm pulling my earlier, bad review. My issue turned out to be a conflict with an older, now obsolete plugin (Amazon Associates Link Builder). It's also nice to see that after two years, the author has returned to working on this plugin, so there is hope that existing shortcomings will be fixed soon. My main, remaining quibble with the plugin: it would be nice to be able to use the block editor!
March 5, 2019
A really great pity. Lightweight, was exactly what I wanted & used it seamlessly. Then along came WPv5 and the wheels simply fell off. Played merry hell with my floating menu bar and my footer simply disappeared. How a simple plug-in could have that sort of effect beats me, but it did. Deactivated the plugin and all was sweetness and light again. ... and to cap it all, it bears the classic symptoms of having been abandoned. I hope I'm wrong, because I'd have given it five stars if it still worked, Ah well.
January 29, 2019
After a long time using this plug in, which I found reliable and nice, I faced the surprise that with the last update ALL the previous events were lost!...I tried to have some kind of help through the forum but none of the developer did answer. I know it is a free plug in, but at the least an answer would have been polite! Now all I all I can do is find another resource and quit event-list for good...
January 11, 2019
This is a super light weight utility that does exactly what I need. Except for one thing... image import. Whenever we upload an event, we normally have an image or 2 with each one. The one item that would be most helpful, is a better how to on the modifiers for the sorting list.
Read all 65 reviews

Contributors & Developers

“Event List” is open source software. The following people have contributed to this plugin.


“Event List” has been translated into 2 locales. Thank you to the translators for their contributions.

Translate “Event List” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.


0.8.6 (2021-04-24)

  • fixed saving a new event when no excerpt is provided (also fixes CSV import of events)
  • added missing translation function for the read more links
  • removed deprecated css zoom function (which was only required for a fix for IE 6+7)
  • fixed trash view in admin page
  • fixed shortcode page display when an invalid event_id was provided (e.g. from a link to a deleted event)
  • switched to WordPress coding standard
  • some other internal fixes and improvements

0.8.5 (2020-11-16)

  • add iCal support (add a link in the event-list with the new shortcode attribute)
  • changes in feed options
  • updated feed link styling
  • changed rss feed link attribute name from “add_feed_link” to “add_rss_link”. Please update your shortcode!
  • some internal changed in feed handling
  • fixed logfile path for upgrade

0.8.4 (2020-10-30)

  • added support for excerpts in events
  • added support for authors in events
  • changed path for upgrade logfile

0.8.3 (2018-05-27)

  • improved import handling and error messages when there is still an import error
  • improved help text for import date format
  • improved upgrade process once more
  • only create 1 single continuing upgrade log file
  • show all events in admin main page when no upcoming events are available

0.8.2 (2018-04-22)

  • fixed category view in front page
  • fixed “past” filter option
  • fixed category filter in admin view, if a seperate taxonomy is used
  • many improvements and fixes in upgrade process
  • add upgrade log file

0.8.1 (2018-02-04)

  • added option to change events permalink slug
  • added some additional upgrade check to improve the 0.8.0 upgrade
  • fixed time display on frontpage
  • fixed copy event function
  • fixed issues with older php versions
  • fixed issues with older WordPress versions

This version fixes a lot of issues reported with the 0.8.0 version. It is now more safe to update, but in general the information provided in the changelog of 0.8.0 is still valid.
Also check the required manual changes provided there.

0.8.0 (2018-01-27)

  • switch plugin and data structure to use custom post types with custom metadata and wordpress categories (with all the advantages and new features provided for custom post types)
  • huge rewrite of the plugin required to implement the above modification
  • small css fixes

The modifications in this versions are huge. This modifications will bring some huge improvements and is a good basis for future improvements (e.g. permalinks).
But inspite of a lot testing it doesn’t eliminate any possibility for some regressions or problems during update process to the new data structure.

Due to this there are some steps you should consider before and after this upgrade:

  • have a look at the support forum if there are issues reported with the new version, and wait with the upgrade until these are solved
  • if you have a big productive site probably do not upgrade in the first days
  • have a look at the PHP error file after upgrade, the upgrade function will write some informations regarding the upgrade process to this file
  • check your shortcodes and widget and do the required manual changes provided below
  • check your events, the event categories and the event output on the frontpage after the upgrade
  • please report problems with the upgrade or issues/regressions after the upgrade in the support forum or on github

There are some manual changes required after the upgrade:

  • renaming the shortcode attribute “show_details” to “show_content” in all shortcodes
  • renaming the shortcode attribute “details_length” to “content_length” in all shortcodes
  • renaming the shortcode attribute “collapse_details” to “collapse_content” in all shortcodes
  • update your widget (goto Admin page -> Appearance -> Widget and “Save” all event-list widgets)
  • the following classes were renamed, adapt them in your custom CSS-styles if required: .start-date -> .startdate, .end-date -> .enddate, .event-details -> .event-content

0.7.12 (2017-10-09)

  • fixed some mature issues with older wordpress versions
  • fixed event import for php version < 5.4
  • fixed usage of html tags in event time, location and details
  • fixed link to events in event-list widget

0.7.11 (2017-10-08)

  • more security improvments due to better sanitation of user inputs
  • prepare additional strings for translations
  • some code improvements

0.7.10 (2017-10-05)

  • fixed security vulnerability in admin category management
  • general improvements of sanitation of all request parameters
  • added number of events to the glance items in the dashboard
  • parse shortcode in event feeds
  • some changes and improvements in event feed
  • fixed syncing of post categories

0.7.9 (2017-06-12)

  • fixed security vulnerability reported by WordPress
  • fixed / improved time handling and sorting according to time (fixed sorting will only work in new or modified events)
  • fixed problem with locale handling in older wordpress versions
  • fixed url when going back from event details page to event list page with a drowdown filter
  • fixed HTML format issue in admin event table (with not properly nested tag warning)

0.7.8 (2017-03-17)

  • improved datepicker style in new/edit event view
  • show datepicker in correct language
  • respect first day of week wordpress setting in the datepicker
  • include event categories in the event feed
  • added support for categories in event import file
  • improvements and better error messages in event import
  • fixed html tag handling truncate function
  • splitted about page into 2 tabs
  • changes in language file handling, additional option to define which language file shall be loaded first
  • some improvements in the language files itself
  • prepare more help strings for translation
  • updated translations and added more german translations
  • moved screenshots to assets folder to reduce download size
  • changed mimimum required wordpress version to 3.8

0.7.7 (2017-01-13)

  • replaced custom admin menu icon with wordpress integrated icon for a consistent styling
  • added support to truncate text via css to exactly 1 line (length=’auto’)
  • added a link to the event at the ellipsis of a truncated details text
  • improved code for deleting of events
  • fixed some issues with the bulk action menu and button in admin event table
  • improved security for external links
  • updated translations

0.7.6 (2015-12-13)

  • added shortcode attribute “collapse_details”
  • correct handling of “more”-tag in event details
  • show “url_to_page” shortcode attribute in the documentation
  • fixed wrong date format in events import sample
  • some help texts improvements
  • updated translation de_DE (78%) and fi_FI (35%)
  • added italian translation it_IT (69%)
  • added portuguese translation pt_BR (58%)
  • added dutch translation nl_NL (46%)
  • added spanish translation es_ES (39%)
  • added spanish translation es_AR (18%)
  • added frensh translation fr_FR (0%)
  • Thanks to all translators at transifex!

0.7.5 (2015-07-19)

  • added support for transifex localization platform
  • added sorting option (see initial_order shortcode option)
  • added relative date format for weeks
  • added import option to set date format in import file
  • several fixes and improvements in truncate function
  • some import improvements
  • set standard import date format to mysql dateformat
  • some speed improvements
  • updated some dates and daterange helptexts and added german translations
  • added finnish translation (thanks to jvesaladesign)

0.7.4 (2015-05-16)

  • fixed allowed daterange for datepicker with custom date formats
  • added option to disable event-list.css
  • added option to set considered daterange for multiday event

0.7.3 (2015-05-15)

  • added csv import functionality
  • added relative and special date selection options for date filter
  • changed required permission to view/edit category admin page
  • added some missing translation functions
  • added some more german translations
  • only allow valid dates (>= 1.1.1970)
  • only load some data on pages where they are required

0.7.2 (2015-03-21)

  • fixed an issue with multiday events when deleting a category
  • fixed displaying the category slug instead of the category name in event listing
  • fixed sub-category handling of deleted categories
  • fixed sub-category handling when a category slug is changed
  • fixed parent selection list in category edit mode
  • some helptext fixes

0.7.1 (2015-02-01)

  • added options for month filterbar item
  • only show years, months and cats with events in filterbar (acc. to available events and date/cat filter
  • fixed event-list feed
  • changed textdomain for translations to event-list
  • some small code and html fixes
  • some code improvements

0.7.0 (2014-12-22)

  • initial multilanguage support
  • German translation (not complete yet)
  • Unicode support in truncate function
  • Changed position of admin menu
  • Changed icon in admin menu

0.6.9 (2014-11-09)

  • added months option in filterbar items
  • added a class for each category slug in each event li element
  • fixed error due to wrong function name when using daterange in date filter

0.6.8 (2014-10-14)

  • added filterbar item “daterange” (to view all, upcoming and past)
  • added options to change feed name and feed description
  • added “Duplicate” and “Add new” button in edit event view
  • corrected embedding of feed (should solve some problems and increase speed)
  • corrected view of event details for single day events
  • changed standard value for feed link in html head to true

0.6.7 (2014-06-18)

  • added month and day support in date_filter
  • added available date and date range formats description in admin about page
  • added support for wpautop in event details
  • added “Past” entry in admin event table filter

0.6.6 (2014-06-16)

  • added date_filter shortcode option
  • added option to change text for filterbar reset item
  • added option “years_order” for years filterbar element
  • preparations to include more date filters / filterbar elements in future versions
  • small css style modification
  • updated some help texts

0.6.5 (2014-04-26)

  • added shortcode attribute “initial_event_id”
  • added an option to only show umpcoming events in the feed
  • fixed a problem in truncate function

0.6.4 (2014-02-10)

  • fixed css file inclusion for shortcodes with parameters
  • fixed css file inclusion for shortcodes outside post content (e.g. theme template)

0.6.3 (2014-02-09)

  • added options to allow html tags in event time and location
  • fixed date check for PHP version 5.2
  • fixed edit view after adding a new event
  • strip slashes in event time field
  • fixed url to event-list css file
  • only load event-list css if required

0.6.2 (2014-02-01)

  • complete rewrite of date handling in new/edit event form and date validation
  • added option to change date format in event new/edit form
  • fixed a css issue in the filterbar hlist when list-style-image is used in the theme
  • some css fixes in admin settings page
  • some html output code style fixes

0.6.1 (2014-01-03)

  • fixed redirect issue in admin event table
  • fixed a bug in filterbar javascript
  • fixed a problem with wrong format of deatails in admin event table
  • changed button text for event update from “Publish” to “Update”
  • show required manual widget update message on the frontpage only to users with required privileges

0.6.0 (2013-12-31)

  • added adjustment options for the filterbar (shortcode attribute “filterbar_items”)
  • added “All” and “Past” options to years filter in filterbar
  • added category filter option in filterbar
  • change “cat_filter” behavior with additional features
  • added option to display categorys/years filter in a dropdown
  • added reset option to filterbar
  • added category filter selection in admin event table
  • added shortcode attribute “initial_date”
  • renamed shortcode attribute “show_nav” into “show_filterbar”
  • renamed url parameter “ytd” to “years”
  • removed underline before event-list id in url
  • some css fixes
  • some help text updates

In this version some of the shortcode attributes and the behavior of some existing attributes have changed and are not compatible with the old version! Please check all your shortcodes after the update.
Additionally the url parameter has changed. So if you are using existing links to an eventlist with parameters you have to update them.
Also existing widgets must be updated after plugin upgrade. Please visit the widget admin page and press save for all evenlist wigets.

0.5.2 (2013-11-09)

  • added number of events in Right Now dashboard widget
  • fixed some css issues

0.5.1 (2013-10-27)

  • added site name in eventlist feed name (similar to standard feed captions)
  • fixed not working feed link in header
  • fixed problem with new widget options after upgrade
  • fixed not working permalink for the eventlist feed

0.5.0 (2013-10-26)

  • added event feed with a lot of options
  • added widget option for cat filter

0.4.5 (2013-08-05)

  • added capability to sync the event categories with the post categories (manually or automatically)
  • fixed problem with empty category list
  • fixed link to category page in new event page
  • fixed indention in in category parent combo box

0.4.4 (2013-07-20)

  • added support for sub-categories
  • moved category administration to seperate page
  • improved category sorting

0.4.3 (2013-07-05)

  • added possibility to edit existing categories
  • added tooptip texts for the widget option
  • changed css classes to differ between event-list-view and single-event-view
  • added missing permission check for new events and about page
  • do not change publish date and user when an event is modified
  • fixed a small issue in info messages
  • code improvements and cleanup in admin pages

0.4.2 (2013-06-09)

  • fixed links urls to events in eventlist-widget
  • added option to show date only once per day

0.4.1 (2013-05-31)

  • fixed deleting of categories
  • fixed url to calendar icon in new/edit event form
  • fixed date format localization in new/edit event form
  • added some widget options
  • only show links in widget if all required info are available
  • small security improvements

0.4.0 (2013-05-04)

  • added category support
  • added settings page
  • small changes in add/edit event admin page
  • added settings page
  • added option “no_event_text”
  • execute shortcodes in event details field on front page
  • change of plugin folder structure and file names
  • small fixes in widget code

0.3.4 (2013-03-16)

  • fixed deleting of events
  • removed link to not available settings page in about page
  • changed parameter values from numbers to a more significant wording
  • added the options ‘event_list_only’ and ‘single_event_only’ for the shortcode attributes ‘show_nav’, ‘show_location’, ‘show_details’ and ‘link_to_event’
  • added shortcode attribute details_length to truncate details

0.3.3 (2013-03-01)

  • fixed event creation/modification problem with php versions < 5.3
  • improved truncate of details in admin event table

0.3.2 (2013-02-24)

  • removed empty settings page (will be added again when settings are available)
  • fixed view of details in admin event table
  • fixed adding or modifying events with alternative date formats
  • only set time format in output if a known time format was entered

0.3.1 (2013-01-03)

  • added widget option “show_location”
  • fixed wrong url for single event page link
  • fixed issue with different shortcodes on one page or post
  • changed required prevelegs for admin about page
  • updated help messages on admin about page
  • small style changes on frontpage

0.3.0 (2012-12-31)

  • added a widget to show upcoming events in a sidebar
  • added some shortcode attributes to modify the output
  • internal code changes
  • fixed some html issues
  • updated help texts on admin about page

0.2.2 (2012-11-18)

  • localization of date and time on the frontpage
  • changed and localized date and time view in the admin event list table
  • localization of date in the new event form

0.2.1 (2012-10-26)

  • changed field order and align in new/edit event form
  • added datepicker for start and end date in new/edit event form
  • improved multiday event selection in new/edit event form
  • small changes in event table on admin page

0.2.0 (2012-09-29)

  • adapted menu names to wordpress standard (similar to posts and pages)
  • adapted event list table admin page to wordpress standard layout
  • used wordpress included table view for admin event table
  • added sort functionality in admin event table
  • added bulk action delete in admin event table
  • added status messages for added, modified and deleted events on admin page

0.1.1 (2012-09-24)

  • fixed an issue with additional quotes after adding or editing an event
  • fixed saving of wrong date when adding a new event
  • fixed sorting of events when more events are at the same day
  • added validation of data before saving to database

0.1.0 (2012-09-08)

  • Initial release