Very Simple Event List

Περιγραφή

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)
  • Χρησιμοποιήστε το shortcode [vsel-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
  • Hide fields of the Advanced Custom Fields plugin

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.

Advanced Custom Fields

You can add extra fields to the meta section by using the Advanced Custom Fields plugin.

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

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

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.

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

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.

Απεγκατάσταση

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.

Μετάφραση

Not included but plugin supports WordPress language packs.

More translations are very welcome!

Συντελεστές

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

Enjoy!

Στιγμιότυπα

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

Εγκατάσταση

Please check Description section for installation info.

Συχνές Ερωτήσεις

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.

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?

Τρέχουσες εκδηλώσεις είναι οι εκδηλώσεις που μπορώ να επισκεφτώ σήμερα. Αυτό μπορεί να είναι μία εκδήλωση σημερινή ή πολλαπλών ημερών.

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?

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

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.

Why a Post Attributes box in the editor?

I have added this feature to support the Elementor page builder plugin.

But you can disable this support via Settings > VSEL.

Why support for the Post Type Archive page?

I have added this feature to support the Elementor page builder plugin.

But you can disable this support via Settings > VSEL.

Why support for the menu page?

I have added this feature to support the Elementor page builder plugin.

But you can disable this support 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.

Other question or comment?

Please open a topic in plugin forum.

Κριτικές

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.
Ανάγνωση όλων των 39 κριτικών

Συνεισφέροντες & Προγραμματιστές

“Very Simple Event List” είναι λογισμικό ανοιχτού κώδικα. Οι παρακάτω έχουν συνεισφέρει στη δημιουργία του.

Συντελεστές

“Very Simple Event List” έχει μεταφραστεί σε 20 γλώσσες. Thank you to the translators for their contributions.

Μεταφράστε το “Very Simple Event List” στην γλώσσα σας.

Interested in development?

Περιηγηθείτε στον κώδικα , ανατρέξτε στο αποθετήριο SVN ή εγγραφείτε στο αρχείο καταγραφής αλλαγών μέσω RSS .

Σύνοψη αλλαγών

Version 10.0

  • added support for the Advanced Custom Fields plugin
  • you can now add extra fields to the meta section
  • new setting to hide these fields in page or widget event list

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

For all versions please check file changelog.