VS Event List

Descripción

Acerca de

With this lightweight plugin you can create an event list.

To display your event list you can use a block, a shortcode or a widget.

You can customize your event list via the settings page or by adding attributes to the block, the shortcode or the widget.

Cómo usar

After installation go to menu item “Events”. You can add your events here.

Add the VS Event List block or the shortcode to a page to display your event list.

  • [vsel] to display upcoming events (today included)
  • [vsel-future-events] to display future events (today not included)
  • [vsel-current-events] to display current events
  • [vsel-past-events] to display past events (before today)
  • [vsel-all-events] to display all events

You can also go to Appearance > Widgets and use the VS Event List widget.

Settings page

You can customize your event list via the settings page. This page is located at Settings > VS Event List.

Settings can be overridden when using the relevant attributes below.

This can be useful when having multiple event lists on your website.

Attributes

You can also customize your event list by adding attributes to the block, the shortcode or the widget. Attributes will override the settings page.

  • Add custom CSS class to event list: class="your-class-here"
  • Change the number of events per page: posts_per_page="5"
  • Skip one or multiple events: offset="1"
  • Change date format: date_format="j F Y"
  • Mostrar eventos de una determinada categoría: event_cat="your-category-slug"
  • Mostrar eventos de múltiples categorías: event_cat="your-category-slug-1, your-category-slug-2"
  • Reverse the order of events in the upcoming, future and current events list: order="DESC"
  • Reverse the order of events in the past and all events list: order="ASC"
  • Change the “no events are found” text: no_events_text="your text here"
  • Disable event title link: title_link="false"
  • Disable featured image link: featured_image_link="false"
  • Disable featured image caption: featured_image_caption="false"
  • Disable featured image: featured_image="false"
  • Disable read more link: read_more="false"
  • Disable pagination: pagination="false"
  • Display all event info: event_info="all"
  • Display a summary: event_info="summary"

Example: [vsel posts_per_page="5" event_cat="your-category-slug" event_info="summary"]

When using the block or the widget, don’t add the main shortcode tag or the brackets.

Example: posts_per_page="5" event_cat="your-category-slug" event_info="summary"

When using the “offset” attribute, pagination will be disabled.

Featured image

Featured images will be used as the primary image for every event.

By default the “post thumbnail” is used as the 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. If the post thumbnail doesn’t look as expected (low resolution or poor cropping), you can choose a different size via the settings page.

You can also change the width of the featured image.

The featured image on the single event page is handled by your theme.

Default support

Plugin creates a custom post type “event”.

This automatically supports the single event page, the event category page, the (event) post type 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 VS Event List compatible with page builder plugins. Events on default WP pages 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 that have the same date. Custom order can be handy when automatic ordering by time is disabled.

Plugin supports the menu page. Support is added to make VS Event List compatible with page builder plugins.

Advanced Custom Fields

You can add extra fields to the event details by using the Advanced Custom Fields plugin. The most commonly used fields are supported.

Create a field group for the post type “event” and add fields to this group. This new field group will then be added to the editor.

RSS and iCal feed

You can share your upcoming events via an RSS feed.

The default RSS widget will display events from future to upcoming. To reverse this order I recommend using an RSS feed plugin capable of changing the RSS feed order.

You can share your upcoming and past events with an external calendar via an iCal feed.

You can activate both feeds on the settings page.

Have a question?

Please take a look at the FAQ section.

Traducción

Translations are not included, but the plugin supports WordPress language packs.

¡Más traducciones son muy bienvenidas!

The translation folder inside this plugin is redundant, but kept for reference.

Credits

Sin el Codex de WordPress y la ayuda de la comunidad de WordPress no habría podido desarrollar este plugin, así que: ¡gracias!

¡Que lo disfruten!

Capturas

  • Event list (GeneratePress theme)
  • Event list (GeneratePress theme)
  • Event list widget (GeneratePress theme)
  • Single event (GeneratePress theme)
  • Events page (dashboard)
  • Single event (dashboard)
  • Widget (dashboard)
  • Settings page (dashboard)
  • Settings page (dashboard)
  • Settings page (dashboard)
  • Settings page (dashboard)
  • Settings page (dashboard)
  • Settings page (dashboard)
  • Settings page (dashboard)
  • Settings page (dashboard)

Blocks

This plugin provides 1 block.

  • VS Event List

Preguntas frecuentes

About the FAQ

Las preguntas frecuentes se actualizan periódicamente para incluir la compatibilidad con las nuevas funciones añadidas o modificadas del plugin.

¿Cómo configuro el idioma del plugin?

The plugin will use the website language, set in Settings > General.

If translations are not available in the selected language, English will be used.

How do I set the date and time format?

By default, the plugin uses the date and time format from Settings > General.

El datepicker y el campo de entrada de fecha sólo admiten 2 formatos de fecha numéricos: “día-mes-año” (30-01-2016) y “año-mes-día” (2016-01-30).

If your date format is not supported, it will be converted into 1 of the 2 formats above.

You can change the date and time format for the frontend of your website via the settings page. You can also change the 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 your date format is not supported, it will be converted into 1 of the 2 formats above.

Which timezone does the plugin use?

Events are saved in the database and displayed throughout your website without a timezone offset.

¿Puedo cambiar los colores del icono de la fecha?

If you are handy with CSS, you can use the Additional CSS page of the Customizer for your custom styling.

Examples:

Cambiar el color del fondo y del texto de todo el icono: .vsel-start-icon, .vsel-end-icon {background:#eee; color:#f26535;}

Cambiar el fondo y el color del texto de la parte superior: .vsel-day-top, .vsel-month-top {background:#f26535; color:#eee;}

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

Sólo puede anular la página de evento único a través de su tema (subordinado).

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

Create a duplicate of the file “single” and rename it “single-event”. Then add this file to your (child) theme folder and customize it to your needs.

How does plugin hook into theme template files?

The plugin hooks into the the_content() and the_excerpt() functions. These are used by most themes.

Some themes and page builder plugins will not support these functions. In that case support can be disabled via the settings page.

Why is there no pagination in the widget?

La paginación no funciona correctamente en un widget.

But you can add a link to the page that displays more events.

Why is there no pagination when using the offset attribute?

Offset breaks pagination, so that’s why pagination is disabled when using offset.

¿Por qué no tiene efecto el atributo offset?

Under some circumstances, such as when attribute “posts_per_page” is set to “-1”, the offset attribute will be ignored.

Why is the page with all events not displaying properly?

This only applies to pages with a manually added shortcode.

When using the block editor, edit the page and check the shortcode in “Edit as HTML” mode.

When using the classic editor, edit the page and check the shortcode after switching to the “Text” tab instead of “Visual”.

The shortcode might be accidentally wrapped in HTML tags, such as code tags. Remove these tags and resave the page.

Can I have “Event” as page title?

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

Deberías cambiar este slug por otro. Esto se puede hacer cambiando el permalink de esta página (o entrada).

Why a 404 (nothing found) when I click the title link?

This is mostly caused by the permalink settings. Please resave the permalink 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 permalink via Settings > Permalinks.

Can I have multiple blocks or shortcodes on the same page?

This is possible, but to avoid a conflict you should disable pagination. This can be done via the settings page or by using an attribute.

Why no event details or event categories box in the editor?

Cuando utilice el editor de bloques, haga clic en el icono de opciones y seleccione “Preferencias”.

Si utiliza el editor clásico, haga clic en la pestaña “Opciones de pantalla”.

Probablemente la casilla para mostrar la casilla correspondiente en el editor no está marcada.

Why no featured image box in the editor?

Cuando utilice el editor de bloques, haga clic en el icono de opciones y seleccione “Preferencias”.

Si utiliza el editor clásico, haga clic en la pestaña “Opciones de pantalla”.

Probablemente la casilla para mostrar la casilla correspondiente en el editor no está marcada.

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.

¿Por qué no hay un grupo de ACF en el editor?

Cuando utilice el editor de bloques, haga clic en el icono de opciones y seleccione “Preferencias”.

Si utiliza el editor clásico, haga clic en la pestaña “Opciones de pantalla”.

Probablemente la casilla para mostrar la casilla correspondiente en el editor no está marcada.

Why does my RSS or iCal feed not refresh?

When visiting your feed via the subscription URL and feed is outdated, empty your browser cache.

If you’re using the default RSS widget you can force a refresh via Settings > Reading, by changing the number of items in the feed.

Why is there no semantic versioning?

The version number won’t give you info about the type of update (major, minor, patch). You should check the changelog to see whether or not the update is a major or minor one.

How can I make a donation?

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

Other questions or comments?

Please open a topic in the WordPress.org support forum for this plugin.

Reseñas

7 de junio de 2024
I needed something to list events for a radio station. That’s it. No fancy calendar or bookings. It needed to be simple enough that I could install it, set it up, do the initial data entry, give them some screenshots with basic instructions, and let them do the rest. They’re happy, I’m happy, everybody wins.
25 de marzo de 2024
Like many users, I’ve tried a number of event type plugins and found most of them bloated, clunky and unintuitive. This one takes a simple approach by setting up events as a new post type. Shortcodes work well and support a number of different attributes for flexibility. Easy to style and is integrated with site builders and the customizer out-of-the-box. I’ll be adding this to my list of go-to plugins from now on. Excellent work!
1 de diciembre de 2023
Thank you. I tried a few of these types of plugins before settling on your one. Suits my needs perfectly. Thanks.
22 de septiembre de 2023
I’ve been using VSEL for more than a year and it’s just the great. So customisable, so lightweight. Beats the pants off the competition in terms of simplicity. So many bloated calendar/event plugins do all sorts of things that I simply don’t need. Moreover, the support from Guido is quick and friendly. Can’t ask for more! I can’t recommend this enough if you need something simple like telling people about upcoming events on your website.
31 de julio de 2023
This plugin worked well right out of the box. It was very straightforward to create the same look as the demo. When I wanted to add a field, the plugin author was very responsive with a helpful suggestion.
4 de julio de 2023
If you’re looking for a solid slim plugin to display your events with shortcodes, easy to customise with css and good support. Give it a try.
Leer todas las 76 reseñas

Colaboradores y desarrolladores

“VS Event List” es un software de código abierto. Las siguientes personas han colaborado con este plugin.

Colaboradores

“VS Event List” ha sido traducido a 21 idiomas. Gracias a los traductores por sus colaboraciones.

Traduce “VS Event List” a tu idioma.

¿Interesado en el desarrollo?

Revise el código , eche un vistazo al repositorio SVN , o suscríbase al log de desarrollo por RSS .

Registro de cambios

Version 17.6

  • Textual changes

Version 17.5

  • Updated block code
  • Minor changes in code

Version 17.4

  • Updated block code
  • Minor changes in code

Version 17.3

  • Updated block code

Version 17.2

  • Updated block code
  • Minor changes in code

Version 17.1

  • Fix: iCal feed

Version 17.0

  • Replaced date() with gmdate()
  • Updated block code
  • Minor changes in code

Version 16.9

  • Minor changes in code

Version 16.8

  • Fix: deprecated element in block code
  • Updated block code
  • Minor changes in code

Version 16.7

  • New: VS Event List block
  • Block editor users can now replace their shortcode block with the VS Event List block
  • Many thanks to Craig from Roundup WP
  • Minor changes in code

Para todas las versiones, consulte el registro de cambios del archivo.