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

Via Settings > VSEL you can:

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

Shortcode attributes

You can add 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 events list: class="your-class-here"

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"

Featured image

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

You can change the size that is being used as source for the featured image via Settings > VSEL.

By default the „post-thumbnail“ size of your theme is being used. You can change this size in case of a tiny or blurry featured image.

The width of the featured image is max. 40% of the event info 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 only: 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.

Einzelne Veranstaltung

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

You can list events from a certain category. Example: your-domain/event_cat/your-category-slug

In most cases PHP file „archive“ is being used for this. This file is located in your theme folder.

Because a theme file is being used, it might not be displayed properly. And events are not listed on event date.

I recommend using the relevant shortcode with attribute, if you want to list events from a certain category.

Post type (event) archive page

You can list all your events. Example: your-domain/event

In most cases PHP file „archive“ is being used for this. This file is located in your theme folder.

Because a theme file is being used, it might not be displayed properly. And 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 by using a custom search query. Example: your-domain/?s=your-search-term&post_type=event

In most cases PHP file „search“ is being used for this. This file is located in your theme folder.

Because a theme file is being used, it might not be displayed properly. And events are not listed on event date.

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!

Kredits

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

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.

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 list 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 override plugin template via my (child) theme?

No, this is not possible.

Why is the page with all events not displayed properly?

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

When using the new editor, go to the page in your dashboard and check the shortcode in „Edit as HTML“ 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 my events page 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?

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

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?

This only applies when using the classic editor.

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

Why a Post Attributes box in the editor?

The Post Attributes box is present to support the Elementor page builder plugin.

But you can disable the Post Attributes box via Settings > VSEL.

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

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

Nice and Simple

Hard to find an events plugin that's simple and easy to use. This one does the job! It allows me to do something the "premium" plugins wouldn't allow——the ability to have different time displays for individual events (i.e., some events with no event time displayed). Thank you!

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.
Lies alle 39 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 9.9

  • after some discussion I have decided to remove the max character length of most inputs again

Version 9.8

  • SEO: changed title of event in list from H4 into H3
  • this applies to events on pages where you have added the shortcode and to events listed with the VSEL widget
  • minor changes in code

Version 9.7

  • added settings to disable support for post type (event) archive page, post attributes and menu page
  • the 3 features above were recently added to support the Elementor page builder plugin
  • minor changes in code
  • added, removed and changed escaping and sanitizing of many items

Version 9.6

  • increased max character length of inputs

Version 9.5

  • added CSS class to the events list: vsel-container
  • added attribute to change this CSS class per event list
  • this can be useful if you want to apply different styling when having multiple event lists
  • stylesheet: removed the unnecessary #vsel prefix from most variables
  • increased max character length of URL inputs
  • removed unnecessary escaping

For all versions please check file changelog.