Very Simple Event List

Description

About

This is a very simple plugin to display a list of events.

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

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:

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

Or go to Appearance > Widgets and add the widget to your sidebar.

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 amount of events per page. This will overwrite amount 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. Use a single whitespace to separate multiple attributes.

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

Widget attributes

The widget supports the same attributes. Enter them without shortcode itself and without 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 use a shortcode on a page to display events from certain categories. For more info check the “Shortcode attributes” section.

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.

It removes all posts with (custom) post type “event”.

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!

Screenshots

  • Very Simple Event List all events (Twenty Seventeen theme).
  • Very Simple Event List single event (Twenty Seventeen theme).
  • Very Simple Event List widget (Twenty Seventeen theme).
  • Very Simple Event List all events (dashboard).
  • Very Simple Event List single event (dashboard).
  • Very Simple Event List widget (dashboard).
  • Very Simple Event List settingspage (dashboard).
  • Very Simple Event List settingspage (dashboard).
  • Very Simple Event List settingspage (dashboard).

Installation

Please check Description section for installation info.

FAQ

About the FAQ

The FAQ applies to the most recent plugin version, as they are regularly updated to include support for newly added or changed plugin features.

How can I change date format?

By default plugin uses date format set in Settings > General.

But you can overwrite this for the frontend of your website via Settings > VSEL.

The datepicker and date input field only support 2 numeric date formats: “day-month-year” (30-01-2016) and “year-month-day” (2016-01-30).

If date format does not match, it will be changed into 1 of the 2 above.

How do I set plugin language?

Plugin will use the site language, set in Settings > General.

If plugin isn’t translated into this language, language fallback will be English.

What do you mean with current events?

Current events are events I can visit today. So this can be an one-day or multi-day event.

Are events also listed on time?

No, this is not possible because input field for time is a regular text input.

Can I hide event labels on the single event page?

No, this is not possible via the settingspage. You can only hide labels there with custom CSS.

What does “Link to more info” mean?

While adding an event you can add a link (an URL) to a post, page or website.

This can be useful in case additional info is available elsewhere.

And you can label this link. Default label is “More info”.

What does “Link to all events” mean?

While adding a widget you can add a link (an URL) to a page with all events.

This can be useful because in most cases you only display a few events in a widget.

And you can label this link. Default label is “All events”.

Why no pagination in widget?

Pagination is not working properly in a widget.

But you can set a link to a page with all events.

Can I overwrite plugin template via my (child) theme?

No, this is not possible.

Why is the page with all events not displayed properly?

Go to the page in your dashboard and check the shortcode in “Text” mode.

If you have added the shortcode in “Visual” mode, it might be wrapped in HTML tags, such as: <script>[vsel]</script>

You should remove the HTML tags and resave the page.

Can I use a page with a slug that ends with “event”?

No, this will cause a conflict with the post type (event) archive page.

You should change this slug into something else. The slug is not always the same as the name of the page.

Why a 404 (nothing found) when I click the title link?

This is mostly caused by the permalink settings. Please resave the permalink via Settings > Permalinks.

Why a 404 (nothing found) when I click the event category link?

This is mostly caused by the permalink settings. Please resave the permalink via Settings > Permalinks.

Can I use multiple shortcodes on the same page?

I don’t recommend this because this might cause issues with the pagination.

Why an error notification instead of a date?

An error notification is displayed in case start date begins after end date. To solve this please reset date.

Why no start date in dashboard?

All events posted with version 4.0 and older have one date only. To solve this please reset date.

Why no meta, image or categories while adding an event?

If these boxes are not present, they might be unchecked in the Screen Options tab.

Can I add or hide columns on the events page in dashboard?

Yes, but you should install an additional plugin for this.

You could install for example: Admin Columns

Does VSEL support Gutenberg?

Yes, plugin has basic support for Gutenberg. This means you can add events using the Gutenberg editor.

Why no Semantic versioning?

At time of initial plugin release I wasn’t aware of the Semantic versioning (sequence of three digits).

How can I make a donation?

You like my plugin and you’re willing to make a donation? Nice! There’s a PayPal donate link at my website.

Other question or comment?

Please open a topic in plugin forum.

Reviews

Amazing Plugin!!!!!

Absolutely love this plugin. I’ve tried various event management plugins on WordPress in the past, most of them either lack support or are over complicated to use. The VSEL plugin is a little gem, it’s lightweight, easy to use and extremely customisable. The developer is quick to respond to any issues raised in the support forum, he goes beyond and above to solve any problems that may occur. Highly recommend this plugin to anyone searching for an event listing solution.

Perfect, simple plugin for event listings

This plugin works perfect for simple event listings. It has some options to change how the event lists are viewed, and by using Event Categories you can be very flexible. The developer is nice and helpful in adding a few more pieces that make this even easier to use like standard css classes on each row that allows for easy manipulation.

Highly recommend!

Parfaite extension !!!

Extension très simple à installer, configurer et utiliser !
Répond parfaitement au besoin de lister simplement des évènements passés, présents et futurs (surtout).
La disposition en deux colonnes rend la lisibilité maximum.
S’intègre sans réglage dans le style du site, parfaitement “responsive”.
Les options disponibles ne sont même pas nécessaires dans un premier temps, sauf peut-être celle de filtrer la/les catégorie-s voulues. Mais c’est si facile…
Bravo pour la réalisation

Great, simple, working

I love this little plugin. It’s easy to use, has some simple customization options and is enough for most of my smaller projects where only a list of upcoming events is needed. I can use it as shortcode or as a widget, the plugin author is very quick and helpful answering support questions and the best thing: It simply works.

Thanks
Daniel

Good simple functionality

This does what it promises – provides a simple event list.

One suggestion to the author: By default, in the New/Edit admin for each event, put the meta box in the main column. In other words, for the add_meta_box() function, change -side- to -normal-.

Read all 34 reviews

Contributors & Developers

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

Contributors

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

Translate “Very Simple Event List” into your language.

Interested in development?

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

Changelog

Version 9.0

  • new function: vsel_event_status()
  • changed function name vsel_event_class() into vsel_event_cats()
  • event status and event categories are added to the CSS class of each event in list
  • this only applies to events on pages where you have added the shortcode and to the widget
  • event status can be: vsel-upcoming, vsel-current, vsel-past
  • this can be useful if you want to apply styling for certain events or certain event categories
  • added extra check for date fields (error message in case of missing start or end date)
  • have set show_in_nav_menus to true, events are now available for selection in navigation menus
  • the only reason for adding feature above, is to support the Elementor page builder plugin

Version 8.9

  • fix: forgot to add updated file vsel-templates

Version 8.8

  • added support for page attributes and the post type (event) archive page
  • the only reason for adding both features above, is to support the Elementor page builder plugin
  • you can now select a custom template for a single event, if available
  • you can now list all your events via yourdomain/event
  • new setting to disable support for the post type (event) archive page template
  • added hook to flush rewrite rules on plugin activation
  • file vsel-style: removed margin from the #vsel wrapper
  • did this to avoid a conflict with Twenty Nineteen theme
  • added new icon in dashboard
  • thanks again Torsten and Hanna

Version 8.7

  • fix: wrong escaping and sanitization for some fields in file vsel-options

Version 8.6

  • fix: the new setting to change date format wasn’t working properly

Version 8.5

  • new setting to change date format for the frontend of your website (thanks Torsten)
  • new settings to disable support for theme template files (thanks Hanna)
  • you can disable theme template files in case of a conflict with your theme or page builder plugin
  • new setting to disable pagination
  • some textual changes
  • removed unnecessary notifications from changelog (such as “updated readme file” and “updated FAQ”)

For all versions please check file changelog.