Very Simple Event List

Omschrijving

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-future-events] to display future events (without today)
  • Add shortcode [vsel-current-events] to display current events
  • Add shortcode [vsel-past-events] to display past events
  • Add shortcode [vsel-all-events] to display all events

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

Settingspage

You can personalize your event list via the settingspage. This page can be found via Settings > VSEL.

Several settings can be overridden when using the relevant (shortcode) attributes below.

This can be useful when having multiple event lists on your website.

Shortcode attributes

You can also personalize your event list by adding attributes to the 4 shortcodes mentioned above.

  • Change the number of events per page: posts_per_page="5"
  • Pass over one or multiple events: offset="1"
  • Change date format: date_format="j F Y"
  • Display events from a certain category: event_cat="your-category-slug"
  • Display events from multiple categories: event_cat="your-category-slug-1, your-category-slug-2"
  • Change order of the upcoming and current events list: order="desc"
  • Change order of the past and all events list: order="asc"
  • Change text if there are no events: no_events_text="your text here"
  • Change CSS class of the event list: class="your-class-here"
  • Disable event title link: title_link="false"
  • Disable featured image: featured_image="false"
  • Disable pagination: pagination="false"

About the offset attribute: pagination is being disabled when using offset.

Examples:

  • One attribute: [vsel posts_per_page="5"]
  • One attribute: [vsel-past-events event_cat="your-category-slug"]
  • Multiple attributes: [vsel posts_per_page="5" event_cat="your-category-slug" class="your-class-here"]

Widget attributes

The widget supports the same attributes. Don’t add the main shortcode tag or the brackets.

Examples:

  • One attribute: posts_per_page="5"
  • Multiple attributes: posts_per_page="5" event_cat="your-category-slug" class="your-class-here"

Featured image

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

By default the “post-thumbnail” size of your theme is being used as source for the featured image. This size may vary by theme.

And the maximum width of the featured image is by default 40% of the event info section.

You can change the featured image size and maximum width via Settings > VSEL. Use both settings together, in order to get the size you want.

The featured image on native archive pages and the single event page is handled by your theme.

Advanced Custom Fields

You can add extra fields to the event details section by using the Advanced Custom Fields plugin. The most commonly used fields are supported.

Create a field group for post type “event” and add fields to this group. This field group will be added to the single event page in dashboard.

The extra fields are displayed in the frontend of your website underneath the location field.

Native support

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

Support for the single event page is needed, but support for the other 3 pages is added to make VSEL compatible with page builder plugins. These 3 pages are not generated by VSEL. Events are not ordered by event date.

More info about the single event page is listed underneath.

Plugin activates the post attributes box in the editor. In the post attributes box you can set a custom order for events with the same date. Custom order is not needed when event has start time and end time.

Plugin makes it possible to add events and event categories to your menu via the menu page. This support is added to make VSEL compatible with page builder plugins.

Eenmalig evenement

In most cases PHP file “single” is being used for the single event 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 you cannot succeed with custom CSS alone, create a duplicate of file “single” and rename it “single-event”, add this file to your (child) theme folder and customize it to your needs.

iCal feed

You can share your most recent events with an external calendar via an iCal feed.

You can activate the iCal feed via via Settings > VSEL.

Verwijderen

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.

Vertaling

Not included but plugin supports WordPress language packs.

More translations are very welcome!

Rechten

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

Enjoy!

Schermafdrukken

  • Very Simple Event List all events (GeneratePress theme).
  • Very Simple Event List all events (GeneratePress theme).
  • Very Simple Event List single event (GeneratePress theme).
  • Very Simple Event List widget (GeneratePress 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).
  • Very Simple Event List settingspage (dashboard).
  • Very Simple Event List settingspage (dashboard).
  • Very Simple Event List settingspage (dashboard).

Installatie

Please check Description section for installation info.

FAQ

About the FAQ

The FAQ are updated regularly to include support for newly added or changed plugin features.

How to set date format and time format?

By default plugin uses date format and time format from Settings > General.

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.

You can change date format and time format for the frontend of your website via Settings > VSEL. You can also change date format by using an attribute.

The date icon only supports 2 date formats: “day-month-year” (30 Jan 2016) and “year-month-day” (2016 Jan 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 website language, set in Settings > General.

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

What’s the difference between upcoming and future events?

Only difference between the both is that upcoming events are including today and future events are starting tomorrow or later.

What do you mean with current events?

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

Can I change the colors of the date icon?

This is not possible via Settings > VSEL. You should use custom CSS for that.

Change background and text color of whole icon: .vsel-start-icon, .vsel-end-icon {background:#eee; color:#f26535;}

Change background and text color of top part: .vsel-day-top, .vsel-month-top {background:#f26535; color:#eee;}

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

No, this is not possible. But you can override the single event page via your (child) theme. For more info check the “Single event” section.

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.

You can also redirect the event title to this link.

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 list a few events in a widget area.

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.

Why no pagination when using the offset attribute?

Offset breaks pagination, so that’s why pagination is being disabled when using offset.

Why does the offset attribute have no effect?

Offset is being ignored when attribute “posts_per_page” has value “-1” (show all events).

Why is the page with all events not displayed properly?

This applies to pages where you have added the shortcode.

When using the block editor, go to the page in your dashboard and check the shortcode in “Edit as HTML” mode.

When using the classic editor, go to the page in your dashboard and check the shortcode in “Text” mode.

It might be accidentally wrapped in HTML tags, such as: <script>[vsel]</script>

Please remove the HTML tags and resave the page.

Can the URL of the page with all events end with “event”?

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

You should change this so called “slug” into something else. This can be done by changing the permalink of your events page.

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

This is mostly caused by the permalink settings. Please resave the permalinks 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 permalinks via Settings > Permalinks.

Can I add multiple shortcodes on the same page?

This is possible but to avoid a conflict I recommend to disable the pagination. This can be done via Settings > VSEL or by using an attribute.

Why an error notification instead of a date or time?

An error notification is displayed in the frontend of your website when date or time is not set correctly.

This occurs when start date or start time begins after end date or end time.

To resolve this please reset date or time.

Why no event details or event categories box in the editor?

When using the block editor, click the options icon and select “Preferences”.

When using the classic editor, click the “Screen Options” tab.

Probably the checkbox to display the relevant box in the editor is not checked.

Why no featured image box in the editor?

When using the block editor, click the options icon and select “Preferences”.

When using the classic editor, click the “Screen Options” tab.

Probably the checkbox to display the relevant box in the editor is not checked.

But sometimes your theme does not support featured images. Or your theme does only support it for the native posts and pages.

In that case you must manually add this support for events. This can be done via file “functions” of your (child) theme.

Why no Advanced Custom Fields field group in the editor?

When using the block editor, click the options icon and select “Preferences”.

When using the classic editor, click the “Screen Options” tab.

Probably the checkbox to display the relevant box in the editor is not checked.

How does plugin hook into theme template files?

Plugin only hooks into the native the_content() and the_excerpt() function. It has no control over anything outside this section.

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.

Does this plugin have its own events block?

No, plugin doesn’t have its own block in the editor and there are no plans to add this anytime soon.

No Semantic versioning?

Version number doesn’t give you info about the type of update (major, minor, patch). You should check changelog for that.

How can I make a donation?

You like my plugin and you’re willing to make a donation? Thanks, I really appreciate that! There’s a PayPal donate link at my website.

Other question or comment?

Please open a topic in plugin forum.

Beoordelingen

6 februari 2021
... and perfect for my needs: Just show events with date, time, description, image and more - if you want. Easy to style. Put it in a HTML-Block not to show "code"-Tags.
7 januari 2021
Thanks for the plugin. I just disabled it because it really falls short on a couple of reasons. First, why use Gutenberg as the editor for this post type? Gutenberg is the most hated editor ever (don't believe me, just check their reviews). If it wasn't forced on us, 9/10 would disable it. If you are going to use Gutenberg, why not use Gutenberg custom fields so the custom fields is seamlessly integrated into the editor? Right now there's just this ugly looking metabox in the bottom of Gutenberg on Events. Second reason is kind of the same topic. As a UX and PHP developer myself, i don't understand why the time field is a textfield where you expect a from-to input, formatted in a specific way. This is such bad practice, and honestly the reason i ditched the plugin because it didn't seem professionally developed in my opinion (sorry i am very sceptic in my plugin choice). I really suggest you use the browser-native time field, and separate from/to fields in 2 separate fields. It will also make custom querying against the DB alot easier. I hope you take this review as constructive critisism and not as an attack. Best luck in the future.
2 december 2020
If you don't need all the blows and whistles that the big event plugins have, this is the best. Hands down. I tried a few, and this is simply amazing to work with.
2 september 2020
VSEL works perfectly with my website built with Thrive Theme builder and Architect. (Note I posted on the support forum that I thought it was not working with Thrive but it turned out to be a fault with my monitor! ) I was after a list view with image thumbnail, VSEL is exactly what I needed. It is simple to install with excellent and easy to follow instructions. I love that it integrates perfectly, using my sites themeing instead of imposing a boring or overly complicated horrible page of its own styling. I did not want crazy over the top features, I just wanted a simple event list which still looked good. I highly recommend VSEL. Support is fantastic also... If you need a question answered.
16 mei 2020
I use this plugin extensively for creating lists of events in a variety of formats (I use CSS to control the formats). I did not need an all-singing-all-dancing event/booking plugins and this one has been be ideal for my needs. Support is awesome. I raised a support query asking about if it was possible to have different date formats in different lists and within a few days Guido has implemented that! Kudos!
Lees alle 57 beoordelingen

Bijdragers & ontwikkelaars

“Very Simple Event List” is open source software. De volgende personen hebben bijgedragen aan deze plugin.

Bijdragers

“Very Simple Event List” is vertaald in 20 talen. Dank voor de vertalers voor hun bijdragen.

Vertaal “Very Simple Event List” naar jouw taal.

Interesse in ontwikkeling?

Bekijk de code, haal de SVN repository op, of abonneer je op het ontwikkellog via RSS.

Changelog

Version 13.8

  • Fix: labels of single event page

Version 13.7

  • Fix: removed timezone setting for iCal feed because not working properly
  • Added setting to set number of events in iCal feed
  • Minor changes in code
  • Textual changes

Version 13.6

  • Better structure of CSS classes
  • Event details section floating left: “vsel-meta vsel-meta-left”
  • Event details section floating right: “vsel-meta vsel-meta-right”
  • Event details section full width: “vsel-meta vsel-meta-full”
  • Event info section floating left: “vsel-image-info vsel-image-info-left”
  • Event info section floating right: “vsel-image-info vsel-image-info-right”
  • Featured image floating left: “vsel-image vsel-image-left”
  • Featured image floating right: “vsel-image vsel-image-right”
  • Most classes are already being used by plugin
  • So this will not break much customizations that are being made

Version 13.5

  • Fix: iCal feed

Version 13.4

  • Fix: mistake in DateTime

Version 13.3

  • Fix: removed localization from date/time select field
  • Minor changes in code

Version 13.2

  • New: you can set start time and end time now
  • Old time field is disabled by default but can be enabled again via settingspage
  • It’s not possible to use both time formats at the same time
  • Added file vsel-feed
  • New: iCal support: you can activate iCal feed via the settingspage
  • For iCal it’s important to use new time format
  • Removed featured image from native archive pages
  • The featured image on these pages is often handled by your theme
  • Textual changes

Version 13.1

  • Fix: more info link label

Version 13.0

  • Settingspage: added settings for the single event page
  • Added file vsel-variables and removed files vsel-page-variables and vsel-widget-variables
  • Relocated variables from the removed files to new file
  • Event details are now wrapped in div instead of p tags
  • Changed CSS class of event details section, event info section and featured image
  • Class “vsel-meta” becomes “vsel-meta-left”
  • Class “vsel-image-info” becomes “vsel-image-info-right”
  • Class “vsel-image” becomes “vsel-image-right”
  • Old classes are still present but will be removed in the near future
  • Classes “vsel-meta-right”, “vsel-image-info-left” and “vsel-image-left” don’t change
  • I have changed these classes to make clear how these elements float (left or right)
  • So in case of Custom CSS please update this as soons as possible
  • Updated stylesheet

Version 12.9

  • Settingspage: bold text if setting requires an additional action

For all versions please check file changelog.