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)
  • Usa lo shortcode [vsel-past-events] per visualizzare gli eventi passati
  • 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.

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 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 the event title link: title_link="false"
  • Disable featured image: featured_image="false"
  • Disable 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"]

Attributi del widget

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 that has different dates, start date will be overridden by end date.

Immagine in evidenza

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.

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

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 these 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 mainly added to support the Elementor page builder plugin.

In the post attributes box you can set a custom order for events with the same date.

Evento singolo

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 (child) theme folder and customize it to your needs.

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 (Twenty Nineteen theme).
  • 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).
  • 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)

Installazione

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.

Come posso cambiare il formato della data?

By default plugin uses date format set in Settings > General.

But you can change this for the frontend of your website via Settings > VSEL or by using an attribute.

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.

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.

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.

Are events also listed on time?

No, this is not possible because input field for time is a regular text input.

In the post attributes box you can set a custom order for events with the same date.

Can I hide certain event meta on the single event page?

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

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.

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>

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.

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.

Perchè ho una notifica di errore al posto della data?

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.

Perchè non c’è una data d’inizio nella dashboard?

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

Perché la mancanza di una casella meta, immagine o categoria nell’editor?

When using the block 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 block 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).

Come posso fare una donazione?

You like my plugin and you’re willing to make a donation? Nice! There’s a PayPal donate link at my website.

Altre domande o commenti?

Apri un topic nel forum dei plugin.

Recensioni

2 Settembre 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 Maggio 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!
13 Febbraio 2020
I was looking for a simple uncluttered event manager that would automatically move upcoming to past, provide simple listing capabilities, and be totally intuitive for non-techies to use. This is all of that! Perfect.
18 Gennaio 2020
No problem with installation, no problem with customize.
Leggi tutte le recensioni di 54

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 20 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 12.0

  • New: setting to show a date icon instead of a label

Version 11.9

  • New: you can set a custom order for events with the same date
  • This can be useful when having multiple events on the same day

Version 11.8

  • New: attribute to set date format per event list

Version 11.7

  • New: setting to disable the single event page
  • This can be useful when not using this page
  • And to avoid this page to be listed in results of search engines
  • Fix: ACF mailto link

Version 11.6

  • Fix: pagination

For all versions please check file changelog.