Very Simple Event List

Descrizione

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.

Come si usa

Dopo l’installazione vai al menu “Eventi” e comincia ad inserire i tuoi eventi.

Crea una pagina e:

  • 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
  • Usa lo shortcode [vsel-past-events] per visualizzare gli eventi passati
  • Add shortcode [vsel-all-events] to display all events

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

Pagina delle impostazioni.

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 shortcodes mentioned above. Attributes will override the settingspage.

  • 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 upcoming, future and current events list: order="DESC"
  • Change order of past and all events list: order="ASC"
  • Change text if there are no events: no_events_text="your text here"
  • Add custom CSS class to event list: class="your-class-here"
  • Disable event title link: title_link="false"
  • Disable featured image link: featured_image_link="false"
  • Disable featured image: featured_image="false"
  • Disable pagination: pagination="false"
  • Show summary: summary="true"

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

Examples:

  • One attribute: [vsel posts_per_page="5"]
  • Multiple attributes: [vsel posts_per_page="5" event_cat="your-category-slug" summary="true"]

Attributi del widget

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" summary="true"

Immagine in evidenza

The featured image will be used as primary image for every event.

By default the “Post thumbnail” is being used as source for the featured image. The size of the Post thumbnail may vary by theme.

WordPress creates duplicate images in different sizes upon upload. These sizes can be set via Settings > Media. In case the Post thumbnail doesn’t look nice you can choose a different size via Settings > VSEL.

Besides this you can also change the maximum width of the featured image.

L’immagine in evidenza nella pagina del singolo evento è gestita dal tuo tema.

Default support

Plugin supports the single event page, the event category page, the post type (event) archive page and the search results page. It hooks into the theme template file that is being used by these pages.

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

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 supports the menu page. Support is added to make VSEL compatible with page builder plugins.

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.

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.

Disinstalla

Se disinstalli il plugin dalla bacheca di WP tutti gli eventi e le impostazioni saranno rimosse dal database.

All posts of the (custom) post type “event” will be removed.

Si può evitare in Impostazioni>VSEL.

Question?

Dai una occhiata alla sezione delle FAQ.

Traduzioni

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!

Buon divertimento!

Screenshot

  • 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).
  • Singolo evento Very Simple Event List (bacheca).
  • Very Simple Event List widget (bacheca).
  • Opzioni di pagina di Very Simple Event List (dashboard)
  • Opzioni di pagina di Very Simple Event List (dashboard)
  • Opzioni di pagina di Very Simple Event List (dashboard)
  • Opzioni di pagina di Very Simple Event List (dashboard)
  • Opzioni di pagina di Very Simple Event List (dashboard)
  • Opzioni di pagina di Very Simple Event List (dashboard)

Installazione

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.

Dove posso selezionare la lingua del plugin?

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?

Upcoming events are including today and future events are starting tomorrow or later.

Cosa intendi per eventi in corso?

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?

You should use custom CSS for that.

Examples:

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 files via my (child) theme?

You can only override the single event page via your (child) theme.

In most cases PHP file “single” is being used for the single event page. This file is located in your theme folder.

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.

How does plugin hook into theme template files?

Plugin hooks into the the_content() and the_excerpt() function. These functions are being used by most themes.

In some cases there’s a conflict with your theme or page builder plugin. That’s why you can disable the use of theme template files via Settings > VSEL.

Cosa vuol dire “Link per maggiori informazioni”?

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.

Cosa vuol dire “Link a tutti gli eventi”?

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.

Ma puoi inserire un link alla pagina con tutti gli eventi.

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 I have “Event” as page title or “event” as slug?

Having “Event” as page (or post) title is no problem, but having “event” as slug (end of URL) will cause a conflict with the post type (event) archive page.

You should change this slug into something else. This can be done by changing the permalink of this page (or post).

Perchè arrivo a una pagina 404 (pagina non trovata) quando clicco sul link del titolo?

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.

Posso utilizzare più shortcode nella stessa pagina?

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 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 only for posts and pages. In that case you must manually add this support for events.

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.

Does this plugin have its own 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.

Come posso fare una donazione?

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.

Altre domande o commenti?

Apri un topic nel forum dei plugin.

Recensioni

4 Marzo 2022
Thank you Guido for this for this excellent plugin. It does exactly what it should with no fuss. The shortcodes covers everything I need in terms of flexibility, and I was able to have it exactly how I wanted in no time at all. I read on your website you are not actively developing this plugin anymore, but I hope you continue to support it as you hope to do.
11 Febbraio 2022
Great to work with - possibility to integrate it seamlessly into the design. No conflicts what-so-ever. Easy to manage. For people who just want to announce an event, zoom-meeting or action-day.
31 Gennaio 2022
The plugin is simple as the maker says, simple but efficient. It does everything I need. The support is excellent.
6 Febbraio 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 Gennaio 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.
Leggi tutte le recensioni di 61

Contributi e sviluppo

“Very Simple Event List” è un software open source. Le persone che hanno contribuito allo sviluppo di questo plugin sono indicate di seguito.

Collaboratori

“Very Simple Event List” è stato tradotto in 21 lingue. Grazie ai traduttori per i loro contributi.

Traduci “Very Simple Event List” nella tua lingua.

Ti interessa lo sviluppo?

Esplora il Codice segui il Repository SVN iscriviti al Log delle Modifiche. Puoi farlo tramite RSS con un lettore di feed.

Changelog (registro delle modifiche)

Version 15.2

  • Fix: custom CSS class
  • Added rel attribute to several links

Version 15.1

  • New: redirect event title link and featured image link separately
  • Updated settingspage

Version 15.0

  • Fix: hiding of more info link
  • New: attribute to disable featured image link per event list
  • This attribute will override the settingspage
  • Minor changes in code

Version 14.9

  • New: redirect featured image link to the more info link
  • Featured image now has the same linking behavior as event title
  • This only applies to events on pages where you have added the shortcode and to the widget
  • Minor changes in code

Version 14.8

  • New: event status is added to single event body class

Version 14.7

  • Fix: date and time error label in editor
  • New: event categories are added to single event body class

Version 14.6

  • Fix: custom CSS class

Version 14.5

  • Better validating, sanitizing and escaping

Version 14.4

  • Fix: supported field types of the ACF plugin

Version 14.3

  • Better validating, sanitizing and escaping

For all versions please check file changelog.