开发者 | Guido07111975 |
---|---|
更新时间 | 2024年11月3日 22:00 |
PHP版本: | 5.3 及以上 |
WordPress版本: | 6.7 |
版权: | GPLv3 |
版权网址: | 版权信息 |
[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 eventsclass="your-class-name"
posts_per_page="5"
posts_per_page="-1"
offset="1"
date_format="j F Y"
event_cat="your-category-slug"
event_cat="first-category-slug, second-category-slug"
order="DESC"
order="ASC"
no_events_text="your text"
title_link="false"
featured_image_link="false"
featured_image_caption="false"
featured_image="false"
read_more="false"
pagination="false"
event_info="all"
event_info="summary"
[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"
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
The 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 (ACF)
You can add extra content to the event details or the event info 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. With these fields you can add the extra content to each event.
Via the settings page you can decide where to display the extra content.
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.
翻译
Translations are not included, but the plugin supports WordPress language packs.
More translations are very welcome!
The translation folder inside this plugin is redundant, but kept for reference.
荣誉榜
Without help and support from the WordPress community I was not able to develop this plugin, so thank you!
The plugin will use the website language, set in Settings > General. If translations are not available in the selected language, English will be used.
By default, the plugin uses the date 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 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.
Events are saved in the database and displayed throughout your website without a timezone offset.
You can use page Additional CSS of the Customizer for your custom styling.
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;}
You can only override the single event page via your (child) theme. 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.
The plugin hooks into the the_content()
and the_excerpt()
functions. These are used by most themes.
Pagination is not working properly in a widget. But you can add a link to the page that displays more events.
Offset breaks pagination. That's why pagination is disabled when using the offset attribute.
The plugin uses minimal styling and therefore also depends on the styling of your theme. The single event page uses the same template as a post. This template may vary by theme.
The following 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.
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. You should change this slug into something else. This can be done by changing the permalink of this page (or post).
This is mostly caused by the permalink settings. Please resave the permalink via Settings > Permalinks.
This is mostly caused by the permalink settings. Please resave the permalink via Settings > Permalinks.
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.
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.
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.
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.
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. But this may not work in case there's other caching as well.
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.
You like my plugin and want to make a donation? There's a PayPal donate link at my website. Thank you!
Please open a topic in the WordPress.org support forum for this plugin.