WordPress.org

Ready to get started?Download WordPress

Plugin Directory

!This plugin hasn't been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

External Events Calendar

This plugin adds a basic "upcoming events" calendar of links to WordPress.

Can the widget also show link descriptions and images?

Short answer, yes. Choose those selections from the widget options form.

What date formats are acceptable?

This plugin uses the php strtotime() function to process the dates entered, which can handle a lot of date formats. "Next Monday", for example, will be correctly computed on most servers (but will always refer to the next Monday in the future, not the next Monday from the time someone added the link). '10/5/10' will be interpreted as October 5, not May 10. But "10 May" will work as expected. PHP does not, to the best of my knowledge, recognize non-English dates in text format very well. "1 enero 11" will probably fail.

If you are having problems having your dates be ordered properly, it is most likely because the strtotime() function is not able to recognize or parse your input. Try entering your dates in a simple format like MM/DD/YYYY and using the WordPress date format settings to display them.

Can I have more than one category of Events? Can I use the widget twice, pulling from a different listing of events in each case?

Yes, you can add an additional link category and use it to store events. If the category you create has an id of 11, for example, you can pull events from your own category using the shortcode [eventslisting link_category=11]. At the moment, the widget will only pull from the default "Events Calendar" link category. If you create your own category, you will have to manage it yourself - the "Events Calendar" submenu page under "Links" will only show events in the default category.

Can I override the default CSS?

As of version 0.3, you have the option to include or not include the default CSS styling. Take a look at the css file provided to see the class names that need to be styled. If you define those in the style.css of your main theme, you can safely disable the default CSS, while will make your page loads a wee bit quicker.

As of version 0.4, you can also copy the existing gad-events-calendar.css file to your theme directory and edit it there, OR create a new directory under /wp-content/plugins called gad-events-custom and copy the stylesheet there. This can help protect your style changes in case of updating the plugin in the future.

What options does the shortcode `[eventslisting]` take?

You can pass any of the same options to the shortcode that you can select in the widget. Here is the syntax for each of the options:

  • display_title (false|string) The title, if any, to show before the list of events. Will be wrapped in an <h2> tag if present.
  • show_past_events (true|false) Present for backwards compatability. Use show_events instead.
  • show_events ("upcomingonly"|"allevents"|"pastonly") Pretty much what it implies. Defaults to "upcomingonly".
  • show_descriptions (true|false) Whether or not to show descriptions in the list of events. Defaults to true.
  • show_images (true|false) Whether or not to show link images, if present, in the list of events. Defaults to false.
  • orderby (ASC|DESC) ASC: Order events current to future, or past to future. DESC: Order events future to current (or past). Defaults to ASC.
  • limit (int) If present, the maximum number of events to show in the listing.
  • link_category (int) A different category to pull events from, other than the default "Events Calendar" category.

So for example, if you want to include the five events farthest in the future in a post, this would be the shortcode to use:

[eventslisting display_title="Planning Ahead" orderby=DESC limit=5]

Requires: 2.9.1 or higher
Compatible up to: 3.1RC3
Last Updated: 2011-2-3
Downloads: 14,019

Ratings

4 stars
4.8 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1 100,1,1
100,1,1 100,1,1 100,1,1
100,1,1 100,1,1 67,3,2
0,1,0
0,1,0 100,1,1
100,2,2 100,1,1
100,1,1