Free WordPress Very Simple Event List pluginFree

3 812 websitesFree WordPress Very Simple Event List plugin by Guido

About

This is a lightweight plugin to create a customized event list.

Add the shortcode on a page or use the widget to display your events.

You can personalize your event list via the settingspage or by adding attributes to the shortcode or the widget.

How to use

After installation go to menu item “Events” and start adding your events.

Create a page and:

  • Add shortcode [vsel] to display upcoming events (including today)
  • Add shortcode [vsel-past-events] to display past events
  • Add shortcode [vsel-current-events] to display current events
  • Add shortcode [vsel-all-events] to display all events

Or go to Appearance > Widgets and use the widget to display your events.

Settingspage

Via Settings > VSEL you can:

  • Keep events and settings when uninstalling plugin
  • Change date format
  • Disable support for theme template files
  • Left or right align meta section and featured image
  • Show a summary instead of all content
  • Link title to the single event page
  • Link featured image to the single event page
  • Set size that is being used for the featured image
  • Change or hide event labels

Shortcode attributes

You can set the number of events per page. This will overwrite the number set in Settings > Reading.

  • Example: [vsel posts_per_page=5]

You can display events from certain categories. You should enter the category slug. The slug is not always the same as the name of the category.

  • Example: [vsel event_cat="first-category, second-category"]

The default order of the upcoming and current events list is ascending. The default order of the past and all events list is descending.

  • Change order from ascending to descending: [vsel order=desc]
  • Change order from descending to ascending: [vsel order=asc]

You can change the text that is being displayed when there are no events.

  • Example: [vsel no_events_text="your text here"]

You can also add multiple attributes. Separate multiple attributes by using a single whitespace.

  • Example: [vsel posts_per_page=5 event_cat="first-category, second-category"]

Widget attributes

The widget supports the same attributes. You don’t have to add the shortcode itself or the brackets.

Example 1:

  • If shortcode attribute is: [vsel posts_per_page=5]
  • Widget attribute will be: posts_per_page=5

Example 2:

  • If shortcode attribute is: [vsel event_cat="first-category, second-category"]
  • Widget attribute will be: event_cat="first-category, second-category"

Featured image

WordPress creates duplicate images in different sizes upon upload. These sizes can be set via Settings > Media.

Via the settingspage you can change the default image size that is being used for the featured image.

By default the “post-thumbnail” size of your theme is being used. Change size to avoid a tiny or blurry featured image.

The width of the featured image is max. 40% of the event content area. Otherwise it might seem out of proportion.

The featured image in a single event is handled by your theme.

Theme template files

Plugin has basic support for theme template files that are being used to display a single event, the event category page, the post type (event) archive page and the search results page.

It does one thing: it hooks into the native the_content() and the_excerpt() function.

In some cases there’s a conflict with your theme or page builder plugin.

That’s why you can disable support for theme template files via Settings > VSEL.

Single event

In most cases PHP file “single” is being used to display a single event. This file is located in your theme folder.

Because a theme file is being used, it might not be displayed properly.

If you want to customize it and using custom CSS is not enough, you can add a PHP file called “single-event” in your theme folder and customize it to your needs.

Event category page

In most cases PHP file “archive” is being used to display a category (archive) page. This file is located in your theme folder.

Because a theme file is being used, it might not be displayed properly.

If you want to customize it and using custom CSS is not enough, you can add a PHP file called “taxonomy-event_cat” in your theme folder and customize it to your needs.

You can also add a shortcode on a page to display events from certain categories. For more info check the “Shortcode attributes” section.

Post type (event) archive page

You can list all your events like this: mydomain.com/event

Because this is a native WordPress feature, the events are not listed on event date.

I recommend using the relevant shortcode, if you want to list all events.

Search results page

You can list events on your search results page, using a custom search query.

In most cases PHP file “search” is being used to display search results. This file is located in your theme folder.

Because a theme file is being used, it might not be displayed properly.

If you want to customize it and using custom CSS is not enough, you should hook into this file or modify this file.

Uninstall

If you uninstall plugin via dashboard all events and settings will be removed from database.

All posts of the (custom) post type “event” will be removed.

You can avoid this via Settings > VSEL.

Question?

Please take a look at the FAQ section.

Translation

Not included but plugin supports WordPress language packs.

More translations are very welcome!

Credits

Without the WordPress codex and help from the WordPress community I was not able to develop this plugin, so: thank you!

Enjoy!

Author: Guido

Tags: Event, event list, event manager, events, simple

Source from: WordPress.org