Event Calendar, Upcoming Events, WordPress Plugin

This WordPress Plugin adds an Event section to the WordPress admin. You can use WordPress shortcodes to display an Ajax powered calendar or a simple unordered list of upcoming events.

November 10, 2014

Ajax Event Calendar and Upcoming Events List WordPress Plugin

Check out the calendar and upcoming event list demo

Event List Calendar WordPress Plugin Demo

See the demo of my Ajax powered calendar WordPress plugin with upcoming events list.


You can download the latest version of Event List Calendar from the WordPress.org website. Simply unzip it and upload it to your WordPress plugin directory and activate the plugin to get started.

Install from WordPress Admin

You can also install it by logging into your WordPress admin, navigate to Plugins -> Add New, search for "Event List Calendar" and click the "Install Now" button on the first result.

Requires WordPress 3.9 or greater. Tested up to WordPress 4.0

How to use

This plugin adds an Event post type to the WordPress admin where you can add events. You can specify title, description, event date and event time. You can also have multiple day events and events that repeat yearly, monthly or weekly.

Calendar Shortcode

Using the shortcode [calendar] will display a large monthly calendar with your events. It's an ajax powered calendar allowing you to go to the next and previous months without page refreshes. It degrades gracefully if JavaScript is disabled.

In Event List Calendar v0.3, I added support for attributes to the [calendar] shortcode. You can display a specific month by setting a year and a month, e.g.
[calendar year="2015" month="09"]

Mini Calendar Shortcode

Using the shortcode [mini-calendar] will display a small monthly calendar with your events. It's also ajax powered, and it is suited for use in sidebars and widgets.

Upcoming Events Shortcode

The shortcode [upcoming-events] will display a simple unordered list of the next five upcoming events. The upcoming events shortcode supports the attribute "num_events" if you want to show more or less than 5 upcoming events, use something like
[upcoming-events num_events="3"].

I added the categories attribute in Event List Calendar v0.3 which allows you add a list of upcoming events that match one or more event categories, e.g.
[upcoming-events categories="birthdays,holidays"]


Add a New Event to the Calendar

The Default View of the Event Calendar

The New Mini Calendar for Widgets and Sidebars

Admin view of events

WordPress Admin Settings Page

The calendar with the dark theme enabled

WordPress Admin Plugin Events About Page

Troubleshooting: 404 errors

This problem has cropped up for a few people: if you are getting 404 errors when trying to view an event. I'm not sure why this is happening to a small number of people, but it's an easy fix!

Simply log into WordPress with an administrator account, go to Settings -> Permalinks and click the "Save" button at the bottom of the page.


v1.7 released on 11-10-2014

  • Improved support for translation
  • English, French, Dutch, German and Spanish are partially supported. Contact me to add your language
  • Mini calendar shows today properly now


  • Added a 'There are no upcoming events.' message for the upcoming events list in the case that there are not any


  • Bug fix for upcoming events list where events get printed twice


  • Bug fix for Ajax calls when not logged in
  • Minor bug fix that caused a non-existent theme stylesheet to try to be loaded


  • Rolling back update after finding a major bug


  • Updated the About page for the new Mini Calendar shortcode


  • New [mini-calendar] shortcode. Perfect for placing in a text widget in your sidebar
  • Added a couple of classes to make customization easier

v1.5 released on 10-01-2014

  • Added theme section to settings to allow you to choose between a light or a dark calendar
  • Added columns to WordPress admin so more event information is displayed without having to actually view the event

v1.4.2 released on 09-30-2014

  • Recoded the upcoming events shortcode so repeating events show up there

v1.4.1 released on 09-29-2014

  • Bug fix for weekly repeating events

v1.4 released on 09-29-2014

  • Added a settings page to allow you to set custom date formats for the upcoming event lists and single event pages
  • Added a 'There are no upcoming events.' message for the upcoming events list in the case that there are not any
  • Improved support for translation should anyone be interested in doing so
  • Bug fix for repeating events

v1.3.1 released on 09-23-2014

  • Minor bug fix that resolves an issue with other plugins that use wp_query

v1.3 released on 09-21-2014

  • Event date, time and repetition information now gets displayed on single event pages, so there is no longer a need to modify your theme.

v1.2 released on 09-18-2014

  • Added support for an end date for repeating events
  • Simplified the event repeat and event days section in the admin
  • Improved CSS for calendar on small devices
  • Improved support for translation
  • Fixed a couple of minor bugs in the repeating events in upcoming lists

v1.1.1 released on 09-13-2014

  • Fixed minor bug and updated readme.txt

v1.1 released on 09-13-2014

  • Added support for events that repeat yearly, monthly or weekly

v1.0 released on 09-09-2014

  • Added support for multiple day events
  • Added License to readme.txt file

v0.3.3 released on 09-01-2014

  • Fixed a bug that caused some errors to appear in WordPress 4.0
  • Changed menu icon

v0.3.2 released on 09-01-2014

  • Added a JavaScript file for the front-end that highlights the "Today" calendar cell based on the visitor's computer time rather than the timezone set in WordPress

v0.3.1 released on 08-31-2014

  • Fixed a bug that was using the server time to display the current month instead of the timezone set by WordPress

v0.3 released on 08-31-2014

  • Added support for event categories
  • Added a categories attribute to the [upcoming-events] shortcode. You can now filter upcoming events by one or more categories using the category slug. [upcoming-events categories="birthdays,holidays"]
  • Added a month and year attribute to the [calendar] shortcode to allow you to start the calendar at specific month. For example, [calendar year="2015" month="09"]

v0.2.1 released on 08-30-2014

  • Fixed an odd bug that caused certain upcoming events to show up even when the date had passed by a few days

v0.2 released on 08-30-2014

  • Added support for the calendar to start on either Monday or Sunday
  • Minor HTML bug fixes
  • The "Today" calendar cell that gets highlighted uses the timezone set in the WordPress settings.

v0.1 released on 08-28-2014

  • Tested in IE8, Chrome, Safari and Firefox


This work is licensed under a GNU General Public License (GPL) version 3.


I know it's long overdue that I allow comments on my resources. You can now submit them!
Note: I approve comments before before they appear on the site, so please don't spam.

Rico Sørensen September 28th, 2014

I think I'm going to use your plugin at a School, but I need a Today view for Events.
And a method for Importing "alot" of Birthdays. CSV import.
I'm an developer so I have the ability to "code" it myself. My question is do you plan to code Todaysevent and cvs import ?

Ryan Fait September 28th, 2014

I like the ideas, especially the CSV import. I'm still working on adding settings in my spare time right now. I'm rather busy at the moment, so it might be a while before I can get to it and more stuff.

Thanks for the feedback!

Robert October 16th, 2014

Hi, this is a great simple-Calendar plugin. How can I change language? There's only english months/days, I can't find the way to localize it.

Johnie Jae October 18th, 2014

Hello, I'm using this plugin on our website and for some reason the links to the event posts are saying page not found. How can I fix this?

Ryan October 18th, 2014

Log into the WordPress admin, go to Settings -> Permalinks and click save.

That should fix it.

Nicolas October 19th, 2014

I have started to translate it to french, it should be done in the following days.
I had problem with today.js because it is included before wp_localize_script, but this script seems to be useless as this is done in ajax.js.

Stuart Hollings November 6th, 2014

Hi Ryan
Thanks for this great plugin, I have one issue, I get an error 404 when I try the link from the calendar to the event page. Any help would be greatly appreciated.


Oli Lang November 9th, 2014

Hi Ryan
thanks for the great working plugin. I love the easy administration and embedding into the site. Is there any possibility to translate the calendar into german?

Regards Oli

Fannar November 10th, 2014

Hey Ryan

Great plugin!

Translation doesn't seem to work unless I add this code to the event-list-cal.php:

function elc_load_plugin_textdomain() {
load_plugin_textdomain( 'event-list-calendar', false, 'event-list-calendar/languages' );
add_action( 'init', 'elc_load_plugin_textdomain' );

Also a feature requests: Allow start time to be shown on [upcoming-events] and [mini-calendar].


Alex November 13th, 2014


I've just downloaded your plugin and it was fine. Only one thing: I need spanish pack.

Thank you.

Alex November 13th, 2014

Hi Ryan,

One more thing regarding calendar plugin: it could be a good idea to include in the Upcoming Events Shortcode beside to the title, the time of the event, as well as the description.

Thank you for this plugin.

Tray November 21st, 2014


Perfect little calendar - just what I needed.

Question - the calendar is displaying Monday - Sunday. Is it possible to start the week with Sunday on the calendar?


Dennis November 24th, 2014


I would like to add Dutch as a language. It says to contact you guys in order to receive instructions. Please help :)


Nick Kentie November 25th, 2014


I would like if i can customize the colors? and add Dutch?


Remis November 25th, 2014


This is very good plugin and this is exactly that I need. However few thing are unclear to me.

1.) How to display full info about event, then event title link was clicked (right now it just returns to the page where this link was clicked with URL like domain/folder/event/some-event/, nor page.php nor single.php templates catches the event post)?
2.) How to get rid of word "event" in URL, so that it would look like this: domain/folder/some-event/?
3.) How to add image thumbnails to events and display them in events list with the rest of event info?

Any help would be greatly appreciated.

Marilynn November 27th, 2014

How do I enable wordwrap for the event title in the main calendar view? I see in your screenshots that wordwrap does exist, but it's not doing it for me. http://songdove.fa-ct.com/wordpress-mu/songdovemusings/calendar-3/ Is there a way to limit the size of the full calendar to force wordwrap perhaps?

sandra November 28th, 2014

Is it possible to put images in the calendar with certain events?

Felipe December 1st, 2014

Great plugin!!!

Just one question, how can i get the spanish pack??


Luc De Haes December 4th, 2014


Click on the next or previous month results in returning to the home page. I am using WordPress Twenty Fourteen.
Would be great if someone can tell how to solve this bug.


Leave a comment

Web Design Resources and Articles