內容簡介
關於
這是一個輕量級的外掛程式，可創建自定義事件列表。
在頁面上添加短代碼或使用小工具來顯示您的事件。
您可以透過設置頁面或將屬性添加到短代碼或小工具以個性化您的事件列表。
使用方式
安裝完畢後，轉到功能表項目“事件”並開始添加您的事件。
創建一個頁面：
添加短代碼[vsel]以顯示即將到來的事件（包括今天）
添加短代碼[vsel-future-events]以顯示未來的事件（不包括今天）
添加短代碼[vsel-current-events]以顯示當前事件
添加短代碼[vsel-past-events]以顯示過去的事件
添加短代碼[vsel-all-events]以顯示所有事件
或轉到外觀 > 小工具並使用小工具來顯示您的事件。
設置頁面
您可以通過設置頁面個性化您的事件列表。此頁面位於設置 > VS事件列表。
使用相關的（短）代碼屬性時，可以覆蓋多個設置。當在您的網站上具有多個事件列表時，這可能很有用。
短代碼屬性
您還可以通過將屬性添加到上述短代碼，個性化您的事件列表。屬性將覆蓋設置頁面。
向事件列表添加自定義CSS類：class="your-class-here"
更改每頁事件數量：posts_per_page="5"
傳遞一個或多個事件：offset="1"
更改日期格式：date_format="j F Y"
從特定類別顯示事件：event_cat="your-category-slug"
從多個類別顯示事件：event_cat="your-category-slug-1, your-category-slug-2"
更改即將到來的、未來的和當前事件列表的順序：order="DESC"
更改過去和所有事件列表的順序：order="ASC"
更改沒有事件的文本：no_events_text="your text here"
禁用事件標題鏈接：title_link="false"
禁用特色圖片鏈接：featured_image_link="false"
禁用特色圖片：featured_image="false"
禁用分頁：pagination="false"
顯示所有事件信息：event_info="all"
顯示摘要：event_info="summary"
關於偏移量屬性：使用偏移量時將禁用分頁。
範例：
一個屬性：[vsel posts_per_page="5"]
多個屬性：[vsel posts_per_page="5" event_cat="your-category-slug" event_info="summary"]
小工具屬性
小工具支持相同的屬性。請勿添加主短代碼標籤或括號。
範例：
一個屬性：posts_per_page="5"
多個屬性：posts_per_page="5" event_cat="your-category-slug" event_info="summary"
精選圖片
特色圖片將用作每個事件的主要圖像。
默認情況下，使用“文章縮略圖”作為特色圖片的源。文章縮略圖的大小可能因主題而異。
WordPress在上傳時會創建不同大小的重複圖像。可以通過設置 > 媒體來設置這些大小。如果“文章縮略圖”看起來不好，則可以通過在短代碼中使用其他大小來選擇不同的大小。
外掛標籤
開發者團隊
📦 歷史版本下載
原文外掛簡介
About
With this lightweight plugin you can create an event list.
Main features of the plugin:
Free and lightweight
Support for Block Editor and Classic Editor
Display your event list with block, shortcode or widget
Display upcoming and past events
Share events via RSS or iCal feed
Organise events with categories
Customize your event list via the settings page or with attributes
Add extra content to events with the Advanced Custom Fields (ACF) plugin
Documentation at WP plugin page
Active support from developer at WP forum
How to use
After installation go to menu item “Events” and create some events.
Go to the editor and add the VS Event List block or the shortcode [vsel] to a page. This will display your event list.
Or go to Appearance > Widgets and use the VS Event List widget.
When using the shortcode add the list attribute to display the events you want.
[vsel list="upcoming"] to display upcoming events (today included)
[vsel list="future"] to display future events (today not included)
[vsel list="current"] to display current events
[vsel list="past"] to display past events (before today)
[vsel list="all"] to display all events
Without this attribute the default event list is displayed (upcoming events).
Customize your event list via the settings page or with attributes.
Settings page
The settings page is located at Settings > VS Event List.
Attributes
Settings can be overridden by adding attributes to the block, shortcode, or widget.
This can be useful when having multiple event lists on your website.
Add custom CSS class to event list: class="your-class-name"
Change the number of events per page: posts_per_page="5"
Display all events (without pagination): posts_per_page="-1"
Skip 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="first-category-slug, second-category-slug"
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"
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"
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 the plugin 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 the plugin 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.
Translation
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.
Credits
Without help and support from the WordPress community I was not able to develop this plugin, so thank you!
