VS Event List

Descripción

Acerca de

Este es un plugin ligero para crear una lista de eventos personalizada.

Añade el shortcode en una página o utiliza el widget para mostrar tus eventos.

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

Cómo usar

After installation go to menu item “Events” and start adding your events.

Create a page and add shortcode:

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

O ir a Apariencia > Widgets y utilizar el widget para mostrar sus eventos.

Settings page

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

Several settings can be overridden when using the relevant (shortcode) attributes below.

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

Atributos del código corto

You can also personalize your event list by adding attributes to the shortcodes mentioned above. 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"
  • Pase sobre uno o varios eventos: 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 order of upcoming, future and current events list: order="DESC"
  • Reverse order of past and all events list: order="ASC"
  • Change 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 summary: event_info="summary"

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" event_info="summary"]

Widget attributes

El widget soporta los mismos atributos. No añadas la etiqueta principal del shortcode ni los corchetes.

Examples:

  • One attribute: posts_per_page="5"
  • Multiple attributes: posts_per_page="5" event_cat="your-category-slug" event_info="summary"

Featured image

La imagen destacada se utilizará como imagen principal para cada evento.

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 the settings page.

Además de esto, también puedes cambiar el ancho máximo de la imagen destacada.

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

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 VS Event List compatible with page builder plugins. Events on default WP pages are not ordered by event date.

El plugin activa la caja de atributos de la entrada en el editor. En la caja de atributos de la entrada puede establecer un orden personalizado para los eventos con la misma fecha. El orden personalizado no es necesario cuando el evento tiene hora de inicio y hora de finalización.

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 post type “event” and add fields to this group. This field group will be added to the editor.

RSS and iCal feed

You can share your upcoming events via a RSS feed.

The default RSS widget will display events from future to upcoming. To reverse this order I recommend using a RSS feed plugin.

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

To activate both feeds go to the settings page.

Desinstalar

Si desinstala el plugin a través del Escritorio, todos los eventos y configuraciones serán eliminados de la base de datos.

Se eliminarán todas las entradas del tipo de entrada (personalizado) “evento”.

You can avoid this via the settings page.

Question?

Please take a look at the FAQ section.

Traducción

No está incluido, pero el plugin es compatible con los paquetes de idiomas de WordPress.

¡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

  • Shortcode event list (GeneratePress theme)
  • Shortcode event list (GeneratePress theme)
  • Widget event list (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)

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?

El plugin utilizará el idioma del sitio web, establecido en Ajustes > General.

Si el plugin no está traducido a este idioma, el idioma de reserva será el inglés.

How do I set date format and time format?

By default plugin uses date format 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).

Si el formato de la fecha no coincide, se cambiará a 1 de los 2 anteriores.

You can change date format and time format for the frontend of your website via the settings page. 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).

Si el formato de la fecha no coincide, se cambiará a 1 de los 2 anteriores.

Which timezone does plugin use?

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

¿Puedo cambiar los colores del icono de la fecha?

Para ello debe utilizar CSS personalizado.

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

En la mayoría de los casos se utiliza el archivo PHP “single” para la página de un solo evento. Este archivo se encuentra en la carpeta de su tema.

Cree un duplicado del archivo “single” y renómbrelo como “single-event”, añada este archivo a la carpeta de su tema (subordinado) y personalícelo según sus necesidades.

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 the settings page.

¿Por qué no hay widget de paginación?

La paginación no funciona correctamente en un widget.

But you can set a link to a page with all events.

¿Por qué no hay paginación cuando se utiliza el atributo offset?

El offset rompe la paginación, por eso se desactiva la paginación cuando se utiliza el offset.

¿Por qué no tiene efecto el atributo offset?

Offset is being ignored when attribute “posts_per_page” has value “-1” (display all events).

¿Por qué no se muestra correctamente la página con todos los eventos?

This only applies to pages with a shortcode based event list.

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

When using the classic editor, open the page in the editor and check the shortcode in “Text” mode.

Podría estar envuelto accidentalmente en etiquetas HTML, como: <script>[vsel]</script>

Please remove the HTML tags and resave the page.

Can I have “Event” as page title?

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.

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.

¿Puedo añadir varios códigos cortos en la misma página?

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.

¿Este plugin tiene su propio bloque?

No, el plugin no tiene su propio bloque en el editor y no hay planes de añadirlo pronto.

Why does my RSS or iCal feed not refresh?

When visiting your feed via the subscription URL and feed isn’t refreshed, empty your browser cache.

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

No Semantic versioning?

El número de versión no da información sobre el tipo de actualización (mayor, menor, parche). Deberías comprobar el registro de cambios para ello.

How can I make a donation?

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.

¿Otra pregunta o comentario?

Por favor, abra un tema en el foro de plugins.

Reseñas

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.
29 de junio de 2023
I've tried many calendar/events plugins. This one is powerful! Easy to use and customize. A major plus is the RSS feed which allows me to automate to other platforms. Excellent plugin and highly recommended.
3 de abril de 2023
Does what it says, without any bloat. Events are easily added in the custom post type and displayed via the shortcode. Enough options to customize the display style. Dank hiervoor!
Leer todas las 73 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 16.5

  • Fix: mistake in main plugin file
  • Previous version causes fatal error in some cases

Version 16.4

  • Changed CSS class of the event info container
  • Class “vsel-image-info” becomes “vsel-info-block”
  • Added 2 CSS classes for alignment: “vsel-left” and “vsel-right”
  • Removed old alignment classes (these classes end with left and right)
  • Because of these changes you may have to clear your browser cache
  • Updated stylesheet
  • Minor changes in code
  • Textual changes

Version 16.3

  • New: featured image caption
  • Added attribute to disable featured image caption per event list
  • Fix: alt text for ACF image field
  • Minor changes in code

Version 16.2

  • Textual changes

Version 16.1

  • New: display read more link after event info
  • Added attribute to disable read more link per event list
  • Fix: alt text for featured image and ACF image field
  • Textual changes
  • Minor changes in code

Version 16.0

  • Updated RSS and iCal feed

Version 15.9

  • New: RSS feed
  • For users with iCal feed: subscription URL is changed
  • Check settings page for more info
  • Updated settings page
  • Changed several fields from checkbox into select (Date, Event info and Pagination)
  • This means you may have to set these settings again

Version 15.8

  • New: setting for numeric pagination
  • Minor changes in code

Version 15.7

  • New: display date icon next to other event details
  • In previous versions you could only display date icon next to title
  • Textual changes

Version 15.6

  • New: setting to change tag that is being used for the title

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