Title: Event Post
Author: Bastien Ho
Published: <strong>2013 年 3 月 31 日</strong>
Last modified: 2026 年 7 月 6 日

---

搜尋外掛

![](https://ps.w.org/event-post/assets/banner-772x250.png?rev=3614292)

![](https://ps.w.org/event-post/assets/icon.svg?rev=2678301)

# Event Post

 由 [Bastien Ho](https://profiles.wordpress.org/bastho/) 開發

[下載](https://downloads.wordpress.org/plugin/event-post.6.0.1.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/event-post/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/event-post/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/event-post/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/event-post/#developers)

 [技術支援](https://wordpress.org/support/plugin/event-post/)

## 外掛說明

Adds some meta-data to posts to convert them into full calendar events.
 Each event
can be exported into ical(.ics), outlook(vcs), or Google Calendar. Geolocation works
thanks to openstreetmap.

It can also fetch the weather, but doesn’t bring the sun 🙂

Follow [@wpeventpost](https://twitter.com/wpeventpost) on Twitter for latest news.

Examples on [event-post.com](https://event-post.com/?mtm_campaign=wp-plugin&mtm_kwd=event-post&mtm_medium=wp.org)

### Post metas

**Date attributes**

 * Begin Date
 * End Date
 * Color
 * Event Status
 * Event Attendance Mode

**Location attributes**

 * Address
 * GPS coordinates
 * Event Virtual Location

**WooCommerce compliant**

You can enable event features on Woocommerce products. The event will be displayed
on the product page. Moreover, the product price will be displayed in event list,
calendar, map and timeline.

This, way, you can sell tickets for your events, effortlessly and without any additional
plugin.

**Weather attribute** (for a given location and date if possible)

 * Weather
    - Temperature
    - Weather

### Usage

[Plugins/themes developpers documentation](https://event-post.com/docs/event-post/?mtm_campaign=wp-plugin&mtm_kwd=event-post&mtm_medium=wp.org)

### Blocks & Shortcodes

The plugin comes with several blocks/shortcodes which allows to:

 * `[events_list]`: display a list of events
 * `[events_map]`: display a map of events
 * `[events_cal]`: display a calendar of events
 * `[event_details]`: display a detail of the current event
 * `[event_term]`: display the date range of a given term based on all events it
   contains

### [events_list]

#### Query parameters

 * **nb=5** _(number of post, -1 is all, default: 5)_
 * **future=1** _(boolean, retrieve, or not, events in the future, default = 1)_
 * **past=0** _(boolean, retrieve, or not, events in the past, default = 0)_
 * **cat=”** _(string, select posts only from the selected category, default=null,
   for all categories)_
 * **tag=”** _(string, select posts only from the selected tag, default=null, for
   all tags)_
 * **tax_name=”** _(string, custom taxonomy name)_
 * **tax_term=”** _(string, the term for above taxonomy)_
 * **geo=0** _(boolean, retreives or not, only events which have geolocation informations,
   default=0)_
 * **order=”ASC”** _(string (can be “ASC” or “DESC”)_
 * **orderby=”meta_value”** _(string (if set to “meta\_value” events are sorted 
   by event date, possible values are native posts fields : “post\_title”,”post\
   _date” etc…)_

#### Display parameters

 * **thumbnail=”** _(Bool, default:false, used to display posts thumbnails)_
 * **thumbnail_size=”** _(String, default:”thmbnail”, can be set to any existing
   size : “medium”,”large”,”full” etc…)_
 * **excerpt=”** _(Bool, default:false, used to display posts excerpts)_
 * **style=”** _(String, add some inline CSS to the list wrapper)_
 * **type=”div”** _(string, possible values are : div, ul, ol default=div)_
 * **title=”** _(string, hidden if no events is found)_
 * **before_title='<h3>’** _(string (default <h3>)_
 * **after_title='</h3>’** _(string (default </h3>)_
 * **container_schema=”** _(string html schema to display list)_
 * **item_schema=”** _(string html schema to display item)_

example:

    ```
    <!-- wp:eventpost/list {"nb":10,"future":true,"past":true,"thumbnail":false,"excerpt":false,"pages":true} /-->

    [events_list future=1 past=1 cat="actuality" nb=10]
    ```

container_schema default value:

> <%type% class=”event_loop %id% %class%” id=”%listid%” style=”%style%” %attributes%
> >
>  %list% </%type%>

item_schema default value:

> <%child% class=”event_item %class%” data-color=”%color%”>
>  <a href=”%event_link%”
> > %event_thumbnail% <h5>%event_title%</h5> </a> %event_date% %event_cat% %event_location%%
> event_excerpt% </%child%>

### [events_map]

 * **nb=5** _(number of post, -1 is all, default: 5)_
 * **future=1** _(boolean, retreive, or not, events in the future, default = 1)_
 * **past=0** _(boolean, retreive, or not, events in the past, default = 0)_
 * **cat=”** _(string, select posts only from the selected category, default=null,
   for all categories)_
 * **tag=”** _(string, select posts only from the selected tag, default=null, for
   all tags)_
 * **tax_name=”** _(string, custom taxonomy name)_
 * **tax_term=”** _(string, the term for above taxonomy)_
 * **tile=”** _(string (default@osm.org, OpenCycleMap, mapquest, osmfr, 2u, satelite,
   toner), sets the map background, default=default@osm.org)_
 * **title=”** _(string (default)_
 * **zoom=”** _(number or empty (default, means fit to points)_
 * **before_title='<h3>’;** _(string (default <h3>)_
 * **after_title='</h3>’** *(string (default </h3>)**
 * **thumbnail=”** * (Bool, default:false, used to display posts thumbnails)*
 * **excerpt=”** _(Bool, default:false, used to display posts excerpts)_
 * **list=”** _(String (“false”, “above”, “below”, “right”, “left”) default: “false”,
   Display a list of posts)_

example:

    ```
    <!-- wp:eventpost/map {"nb":-1,"future":true,"past":true,"tile":"toner","list":"below","map_position":false,"disable_mousewheelzoom":true} /-->

    [events_map future=1 past=1 cat="actuality" nb="-1"]
    ```

### [events_cal]

 * **cat=”** _(string, select posts only from the selected category, default=null,
   for all categories)_
 * **date=”** _(string, date for a month. Absolutly : 2013-9 or relatively : -1 
   month, default is empty, current month_
 * **datepicker=1** _(boolean, displays or not a date picker)_
 * **mondayfirst=0** _(boolean, weeks start on monday, default is 0 (sunday)_
 * **display_title=0** _(boolean, displays or not events title under the day number)_
 * **tax_name=”** _(string, custom taxonomy name)_
 * **tax_term=”** _(string, the term for above taxonomy)_

example:

    ```
    <!-- wp:eventpost/calendar {"date":"-2 months","color":true,"display_title":true,"mondayfirst":"1","choose":false} /-->

    [events_cal cat="actuality" date="-2 months" mondayfirst=1 display_title=1]
    ```

### [event_details]

 * **attribute** _string (date, start, end, address, location). The default value
   is NULL and displays the full event bar_
 * [event_details attribute=”address”]

### Hooks

#### Filters

 * eventpost_add_custom_box_position
 * event_post_class_calendar_link
 * eventpost_columns_head
 * eventpost_contentbar
 * eventpost_default_list_shema
 * eventpost_get
 * eventpost_get_items
 * eventpost_get_post_types
 * eventpost_get_single
 * eventpost_getsettings
 * eventpost_item_scheme_entities
 * eventpost_item_scheme_values
 * eventpost_list_shema
 * eventpost_listevents
 * eventpost_maps
 * eventpost_multisite_get
 * eventpost_multisite_blogids
 * eventpost_params
 * eventpost_printdate
 * eventpost_printlocation
 * eventpost_bulk_edit_fields
 * eventpost_quick_edit_fields
 * eventpost_retreive
 * event-post-rich-result
 * eventpost_shortcode_slug

#### Actions

 * evenpost_init
 * eventpost_add_custom_box
 * eventpost_custom_box_date
 * eventpost_custom_box_loc
 * after_eventpost_generator
 * eventpost_getsettings
 * eventpost_settings_form
 * eventpost_after_settings_form

## 螢幕擷圖

[⌊Map in single page⌉⌊Map in single page⌉[

Map in single page

[⌊Editor interface for the List Block⌉⌊Editor interface for the List Block⌉[

Editor interface for the List Block

[⌊Editor interface for event data⌉⌊Editor interface for event data⌉[

Editor interface for event data

[⌊Editor interface for location data⌉⌊Editor interface for location data⌉[

Editor interface for location data

## 適用於區塊編輯器

這個外掛提供 5 個可供 Gutenberg/區塊編輯器使用的區塊。

 *   Events Map Map of events
 *   Events List List of events
 *   Events Timeline
 *   Events Details Details of an event
 *   Events Calendar Calendar of events

## 安裝方式

 1. Upload `event-post` to the `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress admin
 3. You can edit defaults settings in Settings > Event post

## 常見問題集

### How can I report security bugs?

You can report security bugs through the Patchstack Vulnerability Disclosure Program.
The Patchstack team help validate, triage and handle any security vulnerabilities.
[Report a security vulnerability.](https://patchstack.com/database/wordpress/plugin/event-post/vdp)

### Is the plugin free ?

Yes, and it uses only open-sources : openstreetmap, openlayer, jquery

### How do I enable weather feature ?

Weather feature uses openweathermap.org api.

You have to create an account and generate an API key at http://openweathermap.org/
price

I have no interest in openweathermap.org, I personally use the free plan.

### Is there any limitation for the weather feature ?

Openweathermap.org provides a free plan limited to 60 requests per minute.

You can also subscribe to paid plan, I don’t care.

## 使用者評論

![](https://secure.gravatar.com/avatar/26f5850175967cf272610b21a4fd62edc128dd1695434cd7aeea54f3e01ba32a?
s=60&d=retro&r=g)

### 󠀁[A good idea, needs polishing](https://wordpress.org/support/topic/a-good-idea-needs-polishing/)󠁿

 [mbrailer](https://profiles.wordpress.org/mbrailer/) 2024 年 7 月 9 日

For many websites with simple event needs, this plugin could be a better approach
because it doesn’t require the user to learn an entirely new interface — instead,
you just create a post in the usual way and add date and location. However, the 
plugin will need more polish to make it a true replacement for dedicated event plugins.
The method for adding venue addresses is awkward, and it would help to have a way
to store frequently-used addresses.

![](https://secure.gravatar.com/avatar/32bdf32ba864d5580c79341b4a3b4edc888a3a88ba0f7a40b7fae24047586785?
s=60&d=retro&r=g)

### 󠀁[Event Post](https://wordpress.org/support/topic/event-post/)󠁿

 [elster7](https://profiles.wordpress.org/elster7/) 2024 年 3 月 13 日

Event Post – TOP!! Excellent plugin that fits into Wordpress. Many thanks to the
developers – it is used with enthusiasm on websites.

![](https://secure.gravatar.com/avatar/cc7a65d3a68881aa815bbf9864314d39d891ee7599aa3f36f2cd05f02c71193a?
s=60&d=retro&r=g)

### 󠀁[Great, simple plugin](https://wordpress.org/support/topic/great-simple-plugin-117/)󠁿

 [petrj](https://profiles.wordpress.org/petrj/) 2023 年 6 月 12 日

I was looking for a simple solution to post and archive events that were previously
only on Facebook. Thanks to this plugin, it was easy to do. Thanks for your work
so far

![](https://secure.gravatar.com/avatar/49a28ae4c74dbf654afe41a502be4d651327c890031cc50f3ea56962605b489d?
s=60&d=retro&r=g)

### 󠀁[Works perfectly and very simple](https://wordpress.org/support/topic/works-perfectly-and-very-simple-2/)󠁿

 [ohliza](https://profiles.wordpress.org/ohliza/) 2022 年 3 月 24 日 2 則留言

Thanks for a simple, light, easy plugin. I didn’t want a full event calendar for
this project, and this is ideal. I would suggest simpler documentation for non-devs(
like a dedicated admin page with settings, docs etc), and ability to control layout/
css in shortcode a bit more, how to add weather, but overall an awesome and light
plugin for folks who know some coding. Thanks.

![](https://secure.gravatar.com/avatar/c5a5c374a7b759036099a4c19dd1d336f6cf0c87af13d932f1d2b7b1c09edb30?
s=60&d=retro&r=g)

### 󠀁[Simple and efficient!](https://wordpress.org/support/topic/simple-and-efficient-329/)󠁿

 [momo-fr](https://profiles.wordpress.org/momo-fr/) 2021 年 7 月 7 日

A very practical plugin if you want to easily create events from your blog. Effective.

![](https://secure.gravatar.com/avatar/b2ad5e2040be3540e50aebdd6bab9ae1ffa2bf5718ea66841e82e0b048e34ad2?
s=60&d=retro&r=g)

### 󠀁[Un plugin qui ne va plus droit au but !](https://wordpress.org/support/topic/un-plugin-qui-va-droit-au-but/)󠁿

 [ygirod](https://profiles.wordpress.org/ygirod/) 2021 年 3 月 26 日

Voilà une extension bien pensée ! Simple, fonctionnelle et conviviale. Fait ce qu’elle
doit faire, avec simplicité et, au besoin, une certaine sophistication quand même!
Bravo et merci !Ne fonctionne pas avec le thème Impreza (widget Calendrier et shortcode).

 [ 閱讀全部 35 則使用者評論 ](https://wordpress.org/support/plugin/event-post/reviews/)

## 參與者及開發者

以下人員參與了開源軟體〈Event Post〉的開發相關工作。

參與者

 *   [ Bastien Ho ](https://profiles.wordpress.org/bastho/)
 *   [ leroysabrina ](https://profiles.wordpress.org/leroysabrina/)
 *   [ unecologeek ](https://profiles.wordpress.org/unecologeek/)
 *   [ NOUS Open Usefull & Simple ](https://profiles.wordpress.org/agencenous/)

〈Event Post〉外掛目前已有 10 個本地化語言版本。 感謝[全部譯者](https://translate.wordpress.org/projects/wp-plugins/event-post/contributors)
為這個外掛做出的貢獻。

[將〈Event Post〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/event-post)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/event-post/)、
查看 [SVN 存放庫](https://plugins.svn.wordpress.org/event-post/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/event-post/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/event-post/)。

## 變更記錄

### 6.0.1

 * Show all events in timeline
 * Default to 3 items in timeline pages

### 6.0.0

 * Add align support on blocks
 * Improves Timeline:
    - New vertical layout
    - New “order” option
    - Add gesture support
    - Add time markers
    - Use CSS vars
 * Improves Map:
    - Split options in editor
    - Ensure data are loaded before rendering map block
 * Security: Add direct file access protections
 * Add comments for translators
 * Update apiVersion to 3 in block declarations

### 5.12.0

 * More reliable interaction options in map block editor
 * Add new geocode method for factorization purpose
 * Fix margins in map block editor
 * Update deps

### 5.11.1

 * Update dependencies

### 5.11.0

 * More flexible filters in ICS links: allows to deal with custom taxonomies
 * ICS: Improve DESCRIPTION formatting for better calendar compatibility
 * Security: Escape some outputs

### 5.10.4

 * Fix geocoding with Nominatim: use HTTPS, add User-agent and referer for API calls
 * Add explicit Nominatim attribution in geocoding tool
 * Fix XSS vulnerability when the HTML tag in event_type was forced, reported by
   Muhammad Yudha – DJ

### 5.10.3

 * Fix broken HTML for `container_schema`

### 5.10.2

 * Security: Fix XSS vulnerability in `events_list` shortcode for `item_schema` 
   and `container_schema` attributes, reported by Peter Thaleikis
 * Update dependencies

### 5.10.1

 * Ensure script is loaded in shortcode context
 * Fix “undefined” price in map

### 5.10.0

 * Add support for organization / remote offer in rich event data
 * Manage multiple maps on single page
 * Security: Escape attributes in custom boxes
 * Fix too much escaped HTML in `eventpost/details` block
 * Fix missing script for single map link
 * Disambiguate `event_category` class
 * Remove deprecated `FILTER_SANITIZE_STRING`
 * Moves Weather to EventPost namespace
 * Re-order hooks, fix warnings

### 5.9.11

 * fix save_bulkdatas(): Add nonce verification for security, reported by Francesco
   Carlucci
 * fix `ltrim()` Passing null to parameter 1, reported by ov3rfly

### 5.9.10

 * Security: Authenticated (Contributor+) Stored Cross-Site Scripting, reported 
   by Peter Thaleikis

### 5.9.9

 * Security: Sanitize GPS coordinates, fixes Cross Site Scripting, reported by preo

### 5.9.8

 * Security: Fix Cross Site Scripting, reported by Peter Thaleikis

### 5.9.7

 * Security: Fix vulnerability to XSS in `[events_cal]` shortcode, reported by Peter
   Thaleikis
 * Ensure that date is well formated in `[events_cal]` shortcode

### 5.9.6

 * Security: Fix vulnerability to local file inclusion

### 5.9.5

 * Fixed a bug that display html as string in event calendar blocks
 * Fixed javascript warning in event map block

### 5.9.4

Security:

 * Fix authenticated (Contributor+) Stored Cross-Site Scripting via shortcode
 * Uses bulk_edit_posts hook, fixes lack of verification in bulk edit
 * Escape some outputs
 * Fix missing jQuery dependency in timeline-block

Misc:

 * Deindex inexisting “Event-post front” and “Event-post admin” blocks
 * Add main global EventPost object for JS variables
 * Allows to skip deprecation error
 * Adds instructions for translators
 * Limit number of tags in plugin README

Now requires WordPress 6.3

### 5.9.3

 * Fix quick edit fields

### 5.9.2

 * Fix call of Wp_Query in EventPost\Children
 * Fix display of hours in timepicker for AM/PM format
 * Fix saving of timeline schemas settings
 * Use wp_json_encode instead of json_encode
 * Use rawurlencode instead of urlencode
 * Adds instructions for translators

### 5.9.1

 * Fix doing_it_wrong calls in legacy widgets
 * Escape HTML & outputs

### 5.9.0

Security:

 * Fixes XSS vuln in event metadata (https://patchstack.com/database/report-preview/
   8edeb59a-59e6-42aa-8ed4-5f79cdedf820)

Features:

 * Adds “Completed” event status

Misc:

 * Refactor source of blocks with wordpress-scripts
 * Improves WordPress’s PHPCS compliance
 * Fix deprecated gmt_offset
 * Mark legacy widgets as deprecated
 * Fix warnings in PHP8+

### 5.8.6

 * Fix December month on native datepicker

### 5.8.5

 * Dissociate event description from post excerpt
 * Remove double line breaks and &nbsp in description

## 中繼資料

 *  版本 **6.0.1**
 *  最後更新 **2 週前**
 *  啟用安裝數 **1,000+**
 *  WordPress 版本需求 ** 6.3 或更新版本 **
 *  已測試相容的 WordPress 版本 **7.0.2**
 *  語言
 * [Catalan](https://ca.wordpress.org/plugins/event-post/)、[Croatian](https://hr.wordpress.org/plugins/event-post/)、
   [Czech](https://cs.wordpress.org/plugins/event-post/)、[Dutch](https://nl.wordpress.org/plugins/event-post/)、
   [English (US)](https://wordpress.org/plugins/event-post/)、[French (France)](https://fr.wordpress.org/plugins/event-post/)、
   [Japanese](https://ja.wordpress.org/plugins/event-post/)、[Norwegian (Bokmål)](https://nb.wordpress.org/plugins/event-post/)、
   [Portuguese (Brazil)](https://br.wordpress.org/plugins/event-post/)、[Portuguese (Portugal)](https://pt.wordpress.org/plugins/event-post/)、
   及 [Spanish (Spain)](https://es.wordpress.org/plugins/event-post/).
 *  [將這個外掛本地化為你的母語版本](https://translate.wordpress.org/projects/wp-plugins/event-post)
 * 標籤:
 * [booking](https://tw.wordpress.org/plugins/tags/booking/)[calendar](https://tw.wordpress.org/plugins/tags/calendar/)
   [events](https://tw.wordpress.org/plugins/tags/events/)[geolocation](https://tw.wordpress.org/plugins/tags/geolocation/)
   [map](https://tw.wordpress.org/plugins/tags/map/)
 *  [進階檢視](https://tw.wordpress.org/plugins/event-post/advanced/)

## 評分

 4.3 星，滿分為 5 星

 *  [  22 個 5 星使用者評論     ](https://wordpress.org/support/plugin/event-post/reviews/?filter=5)
 *  [  7 個 4 星使用者評論     ](https://wordpress.org/support/plugin/event-post/reviews/?filter=4)
 *  [  2 個 3 星使用者評論     ](https://wordpress.org/support/plugin/event-post/reviews/?filter=3)
 *  [  4 個 2 星使用者評論     ](https://wordpress.org/support/plugin/event-post/reviews/?filter=2)
 *  [  0 個 1 星使用者評論     ](https://wordpress.org/support/plugin/event-post/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/event-post/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/event-post/reviews/)

## 參與者

 *   [ Bastien Ho ](https://profiles.wordpress.org/bastho/)
 *   [ leroysabrina ](https://profiles.wordpress.org/leroysabrina/)
 *   [ unecologeek ](https://profiles.wordpress.org/unecologeek/)
 *   [ NOUS Open Usefull & Simple ](https://profiles.wordpress.org/agencenous/)

## 技術支援

最近 2 個月解決的問題:

     總計 2 個問題，已解決 2 個

 [檢視技術支援論壇](https://wordpress.org/support/plugin/event-post/)

## 贊助

想要支援這個外掛的發展嗎？

 [ 贊助這個外掛 ](https://apps.avecnous.eu/en/product/eventpost/?mtm_campaign=wp-plugin&mtm_kwd=event-post&mtm_medium=wp-repo&mtm_source=donate)