VS Event List

常见问题

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

If date format does not match, it will be changed into 1 of the 2 above.

How do I set plugin language?

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.

What do you mean with current events?

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

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.

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

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.

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

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?

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?

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.

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.

Other question or comment?

Please open a topic in plugin forum.