Very Simple Event List

Beschreibung

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

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

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"
  • 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"
  • Hide featured image: featured_image="false"
  • Hide pagination: pagination="false"

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. You don’t have to 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"

Event dates

Settingspage contains a setting that makes it possible to add events with one date, instead of start date and end date.

This has no effect on existing events and you can always turn back to previous format again.

But when resaving an existing event with different dates, start date will be overridden by end date.

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.

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

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 the single event page is handled by your theme.

Advanced Custom Fields

You can add extra fields to the meta 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 mainly added to support the Elementor page builder plugin. Don’t use those 3 pages to list events, because events will not be ordered by event date.

More info about the single event page is listed underneath.

Plugin activates the post attributes box in the editor.

Plugin makes it possible to add events and event categories to your menu via the menu page.

Both features above are added to support the Elementor page builder plugin.

Einzelne Veranstaltung

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 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.

Deinstallation

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.

Fragen?

Please take a look at the FAQ section.

Übersetzung

Not included but plugin supports WordPress language packs.

More translations are very welcome!

Danksagungen

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

Viel Spaß!

Screenshots

  • Very Simple Event List all events (Twenty Nineteen theme).
  • Very Simple Event List single event (Twenty Nineteen theme).
  • Very Simple Event List widget (Twenty Nineteen 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 change 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 from Settings > General does not match, it will be changed into 1 of the 2 above.

Wie stelle ich die Sprache des Plugins ein?

Plugin will use the website 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 you 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?

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

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.

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.

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

No, this is not possible.

Why is the page with all events not displayed properly?

This applies to pages where you have added the shortcode.

When using the new 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 wrapped in HTML tags, such as: <script>[vsel]</script>

You should 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?

An error notification is displayed in case of a missing date or when start date begins after end date. To solve this please reset date.

Why no start date in dashboard?

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

Why no meta, image or categories box in the editor?

When using the new editor, click the tools and options button and select „Options“.

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 Advanced Custom Fields field group in the editor?

When using the new editor, click the tools and options button and select „Options“.

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, it does not have its own events block and I’m not planning to add this feature.

Does plugin support iCal?

No, because to support the iCal structure there should be input fields for start time and end time.

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.

Andere Fragen oder Kommentare?

Please open a topic in plugin forum.

Rezensionen

2. Januar 2020
This plugin replaced a very old one we used. It is simple without a bunch of bells and whistles that we don't need. Very clean.
28. November 2019
It's a good plugin. My only hard time was to find where were the VSEL shortcodes. It would be great if the shortcodes receive an area into VSEL Settings where we can find them easily. Realmente é um plugin simples que a única dificuldade que senti foi em encontrar os Shortcodes que não estão listados no Settings do plugins (Poderia ter uma área escrito "Shortcodes").
22. November 2019
Was looking for a simple way to add and display events, this plugin does just that. With some CSS I made the list look how I wanted. I'm using Elementor Pro which I used to style the single event page with ease.
9. Oktober 2019
Simple and great plugin. I wish in future updates that the end date automatically starts in the same start date, like that if I have an event for the next 2 years I don't have to go all over again all the months
17. September 2019
I needed something to display a simple list of events, my use case didn't require/justify a full-on calendar plugin. I really just want past events to disappear automagically. This works great. Thanks @Guido!
Lies alle 48 Rezensionen

Mitwirkende & Entwickler

„Very Simple Event List“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt:

Mitwirkende

„Very Simple Event List“ wurde in 20 Sprachen übersetzt. Danke an die Übersetzerinnen und Übersetzer für ihre Mitwirkung.

Übersetze „Very Simple Event List“ in deine Sprache.

Interessiert an der Entwicklung?

Durchstöbere den Code, sieh dir das SVN Repository an oder abonniere das Entwicklungsprotokoll per RSS.

Änderungsprotokoll

Version 11.3

  • New: setting that makes it possible to add events with one date, instead of start date and end date
  • This has no effect on existing events and you can always turn back to previous format again
  • But when resaving an existing event with different dates, start date will be overridden by end date
  • New: attribute to hide featured image per event list
  • New: attribute to hide pagination per event list
  • Both attributes above can be handy when having multiple different event lists
  • And both attributes will override the settingspage

Version 11.2

  • Fix: events are now listed in the frontend of your website depending on local time
  • In previous versions the UTC time was being used
  • Because of fix above plugin now requires at least PHP 7.1
  • New: settings to hide event categories, time or location column in dashboard
  • Minor changes in code
  • Thanks autotutorial for explaining all new native date/time elements to me

Version 11.1

  • Fix: forgot to include new feature in all template files

Version 11.0

  • Fix: added UTC timezone to strtotime()
  • In some cases wrong timezone was being used when saving date
  • This causes the wrong date being returned after saving
  • A wrong timezone is mostly caused by another plugin that changes the default timezone from UTC to another one
  • New: setting to change the maximum width of the featured image
  • Minor changes in code
  • Thanks Martin for supporting me to fix the timezone issue

Version 10.9

  • Fix: added UTC timezone to wp_date()
  • In some cases wrong date was being returned (depending on timezone)

For all versions please check file changelog.