The Events Calendar


Create and manage your calendar of events with ease. Get professional-level quality and features backed by a team you can trust. The Events Calendar will help take your site to the next level.

The Events Calendar is built and supported by Modern Tribe’s WordPress artisans. Looking for additional functionality including recurring events, ticket sales, publicly submitted events, new views, Facebook event integration and more?

Check out Events Calendar PRO and other add-ons

New Import Tool!
We’ve made bulk event imports easier to manage than ever. This add-on service for The Events Calendar allows you to import events from your favorite sources, including Facebook, Meetup, Google Calendar, iCalendar, CSV, and ICS.
Check out Event Aggregator now.


The Events Calendar is crafted the WordPress way.

The Events Calendar has been audited by many of the industry’s WordPress experts including core developer Mark Jaquith for security & plugin review team member Pippin Williamson for best practices and plugin compatibility.

We’ve poured hundreds of hours into QA by a dedicated support team, monthly usability tests to guarantee that it’s easy to use, and numerous user interviews to make sure you get what you want. We care about quality and crafting products that thrive in the wild.

The team at Modern Tribe stands by our work and offers light support every Wednesday to the community via the support forums. Feel free to ask a question if you’re having a problem with implementation or if you find bugs. Looking for help NOW or need a deeper level of support? Add the premium add-on plugin and you get access to premium support forums with 24-48 hour response times on weekdays.

Enjoy using The Events Calendar, know how to get under the hood and want to make money helping people? We’re growing our community team and would love to hear from you. If you’re interested, check this out!


The Events Calendar is built to work out of the box. Just turn it on, configure the settings to match your needs and you’ll be making events in less than 5 minutes.

By developers, for developers…it’s ready to be the foundation for your wildest hack sessions. Complete with a skeleton stylesheet to theme fast and efficiently, loads of tools including partial template overrides, a host of template tags, hooks and filters, careful documentation, as well as a library of code snippets on GitHub. The Events Calendar is built FOR people who build websites.

Whether your vision is big or small, we have you in mind.

We’ve scaled The Events Calendar to work on a network with over 25 million unique visitors per month and hundreds of thousands of events. We have it running for Fortune 100 companies. Major universities, government institutions and some seriously epic startups push their events with our platform. Thousands of churches, eateries, small businesses, musicians, venues, and non-profits are publishing and promoting their events with The Events Calendar. You’re in good company.


Whether you’re operating a hyperlocal hub listing thousands of events, a university with many thousands of users, or you’re a sole business owner listing your classes, The Events Calendar has your back.

Just getting started? Definitely watch and read through the New User Primer before going much further.

  • Rapidly create events
  • Saved venues & organizers
  • Calendar month view with tooltips
  • List view
  • Day view
  • イベント検索
  • Google マップ
  • Widget: Upcoming events list
  • Events Taxonomies (Categories & Tags)
  • Google Calendar and iCal exporting
  • Completely ajaxified for super smooth browsing
  • Completely responsive from mobile to tablet to desktop
  • Tested on the major theme frameworks such as Avada, Genesis, Woo Themes, Thesis and many more.
  • Increase your SEO with Microformats
  • Internationalized & Translated
  • Multiple stylesheets (Skeleton, Default, Tribe Event Styles) to improve integration
  • Extensive Template Tags for Customization
  • Hook & Filters up the wazoo
  • Caching Support
  • Debug Mode for Developers

Looking for something else? We’ve got add-ons available to take your calendar to the next level.

PRO Features

Add recurring events, a whole recurring events, a whole range of new views ( week / map / photo / venue / organizer) & widgets (calendar / featured venue / week / event countdown), shortcodes, custom event attributes, default content, location search, much more with Events Calendar PRO


Collect free RSVPs with Event Tickets or add paid ticketing features with Event Tickets Plus, including the ability to sell tickets, collect sales, and manage attendees all from within your WordPress dashboard! Works with your favorite eCommerce plugin (WooCommerce, Shopp, Easy Digital Downloads, or WP E-Commerce).


Fill your calendar with events from your favorite sources, including Facebook, Meetup, Google Calendar, iCalendar, CSV, and ICS. Event Aggregator provides a convenient dashboard to manage scheduled imports, manual imports, filters, one-way sync, import history, and more.

User-Submitted Events

Running a community calendar? Community Events lets users add events directly to your calendar without needing access to your admin.

Advanced User Search & Filters

Have so many amazing events that your users get overwhelmed? Filter Bar adds a configurable set of filters to your event pages so users can view and search for the exact events that interest them.

Integrate With Eventbrite

Connect your calendar with your account! Eventbrite Tickets allows you to import/export between The Events Calendar and Eventbrite, and incorporate ticket sales.

Join us on Facebook to be part of our active community, check us out on Twitter, and sign up for our newsletter for release announcements and discounts.


If you’ve identified a bug and want to submit a patch, we’d welcome it at our GitHub page for The Events Calendar. Simply cue up your proposed patch as a pull request, and we’ll review as part of our monthly release cycle and merge into the codebase if appropriate from there. (If a pull request is rejected, we’ll do our best to tell you why). Users whose pull requests are accepted will receive credit in the plugin’s changelog. For more information, check out the readme at our GitHub page. Happy coding!


All of our online documentation can be found on our documentation site.

Some links you may find particularly useful are:

If you have any questions about this plugin, you can post a thread in our forum. Please search existing threads before opening a new one.

The Modern Tribe premium support forums are available for you to read. You won’t, however, be able to post a message in any forums beyond Pre-Sale Questions unless you have purchased a premium license.


But wait: there’s more! We’ve got a whole stable of plugins available to help you be awesome at what you do. Check out a full list of the products below, and over on our website.

Our Free Plugins:

Our Premium Plugins and Services:


The Events Calendar is translated by volunteers at There you can find a list of available languages, download translation files, or help update the translations. Thank you to everyone who helps to maintain our translations!


Welcome to The Events Calendar, a full-featured events management system for WordPress. Thank you so much for using the labor of our love. We are Modern Tribe and we are here to help you be awesome.

If you aren’t familiar with The Events Calendar, check out our new user primer. It’ll introduce you to the basics of what the plugin has to offer and will have you creating events in no time. From there, the resources below — extensive template tag documentation, FAQs, video walkthroughs and more — will give you a leg up as you dig deeper.

Additional resources available include:

We hit the The Events Calendar forum here on about once a week, assisting users with basic troubleshooting and identifying bugs that have been reported. (If you are looking for more active support, might we suggest buying a PRO license? Our team hits the Premium Forums daily.)

Some things to consider before posting on the forum:

  • Look through existing threads before posting a new one and check that there isn’t already a discussion going on your issue.
  • Your issue will be solved more quickly if you run a few checks before making a support request. Deactivate your plugins one by one – if the issue is fixed by deactivating a plugin you know you’ve got a plugin conflict. To test your Theme, revert to the default Twenty Twelve Theme to see if you are still experiencing the problem. If not, your Theme is the issue. Please provide this information when making your supper request.
  • Sometimes, just resetting your permalinks can fix the issue. Visit Events -> Settings -> Permalinks, save your permalinks with a different option and then save with your preferred choice again. This can solve events-related problems and can is worth a shot before creating a new thread.

Still not happy? Shoot us an email to or tweet to @TheEventsCal and tell us why. We’ll do what we can to make it right.


The plugin is made with love by Modern Tribe Inc.

Current Contributors

Past Contributors


  • Month View with Hover
  • Month View
  • List View
  • Day View
  • Single Event
  • イベントエディター
  • Events Admin Listing
  • 一般設定
  • 表示設定
  • Events List Widget
  • Mobile Month View
  • CSV インポーター


Install & Activate

Installing the plugin is easy. Just follow these steps:

  1. From the dashboard of your site, navigate to Plugins –> Add New.
  2. Select the Upload option and hit “Choose File.”
  3. When the popup appears select the file from your desktop. (The ‘x.x’ will change depending on the current version number).
  4. Follow the on-screen instructions and wait as the upload completes.
  5. When it’s finished, activate the plugin via the prompt. A message will show confirming activation was successful. A link to access the calendar directly on the frontend will be presented here as well.

That’s it! Just configure your settings as you see fit, and you’re on your way to creating events in style. Need help getting things started? Check out our new user primer for help with settings and features.


  • PHP 5.2.4 or greater (recommended: PHP 5.4 or greater)
  • WordPress 3.9 以上
  • jQuery 1.11.x


Are there any troubleshooting steps you’d suggest I try that might resolve my issue before I post a new thread?

First, make sure that you’re running the latest version of The Events Calendar (4.0 as of this release). If you’re running Events Calendar PRO it needs to match the version number of The Events Calendar. And if you’ve got any other add-ons, make sure those are current / running the latest code as well.

The most common issues we see are either plugin or theme conflicts. You can test if a plugin or theme is conflicting by manually deactivating other plugins until just The Events Calendar is running on your site. If the issue persists from there, revert to the default Twenty Fourteen theme. If the issue is resolved after deactivating a specific plugin or your theme, you’ll know that is the source of the conflict.

Note that we aren’t going to say “tough luck” if you identify a plugin/theme conflict. While we can’t guarantee 100% integration with any plugin or theme out there, we will do our best (and reach out the plugin/theme author as needed) to figure out a solution that benefits everyone.

I’m still stuck. Where do I go to file a bug or ask a question?

Users of the free The Events Calendar should post their questions in the plugin’s forum, which we hit about once a week (usually on Wednesdays). Please make sure to read our sticky post providing an overview of the support we provide free users BEFORE posting. If you find you’re not getting support in as timely a fashion as you wish, you might want to consider purchasing a PRO license.

If you’re already a PRO user, you’re entitled access to our more actively-monitored Events Calendar PRO forum on our website. We can provide a deeper level of support here and hit these forums on a daily basis during the work week. Generally, except in times of increased support loads, we reply to all comments within 24-48 hours during the business week.

Events Calendar PRO looks awesome! I’m sold! How can I get my hands on it?

Events Calendar PRO can be purchased directly on our website. There are five (5) license types available, and all licenses include 1 year of access to support + updates.

I’m interested in PRO or another add-on, but there are a few questions I’ve got before making the purchase. Can you help me get those addressed?

Absolutely. If you’re not finding your questions answered on the product pages, hit up our pre-sales forum on our site. You can save yourself some time by reviewing the threads first to verify if your question has already been asked. If it hasn’t, post a new thread as a guest. We’ll get you a reply as quickly as we can, so you can make an informed decision regarding purchase.

What add-ons are available for The Events Calendar, and where can I read more about them?

Currently, the following add-ons are available for The Events Calendar:

  • Events Calendar PRO, for adding premium calendar features like recurring events, advanced views, cool widgets, shortcodes, additional fields, and more!
  • Event Aggregator, a service that effortlessly fills your calendar with events from Facebook, Meetup, Google Calendar, iCalendar, CSV, and ICS.
  • Event Tickets (free), which allows you to collect RSVPs to events. It can run alongside The Events Calendar or as a standalone plugin that adds RSVP functionality to WordPress posts and pages.
  • Event Tickets Plus, which allows you to sell tickets for your events using your favorite e-commerce platform.
  • Community Events, for allowing frontend event submission from your readers.
  • Community Tickets, which allows event organizers to sell tickets to the events they submit via Community Events.
  • Filter Bar, for adding advanced frontend filtering capabilities to your events calendar.
  • Eventbrite Tickets, for selling tickets to your event directly through Eventbrite.
I have a feature idea. What’s the best way to tell you about it?

We’ve got a UserVoice page where we’re actively watching for feature ideas from the community. Vote up existing feature requests or add your own, and help us shape the future of the products business in a way that best meets the community’s needs.

I’ve still got questions. Where can I find answers?

Check out our extensive knowledgebase for articles on using, tweaking, and troubleshooting our plugins.



It is a very complete plugin, more than I expected! Congratulations! I will allways recommend.

Excellent Plugin

This is my go-to calendar plugin. I’ve used both the pro and the basic version on a number of sites. It’s flexible, has a number of great display options, is customizable with css, and the support on the pro is wonderful. Answers to questions on the basic version have generally been readily available, too. All-around great!

Lacks basic features

I can never complain too much when something is free, but this plugin requires a separate download plugin just to use it as a shortcode. There is also no ability to add recurring events. The pro version even for just personal use is way too expensive for a calendar plugin.



[4.4.5] 2017-03-23

  • Fix – Local changes to events should be preserved in accordance with the Event Import Authority setting (thanks to @bryan for reporting this one) [72876]
  • Fix – Correct the value for days of the week abbreviation (thanks @mmmmartin03 for the report) [75379]
  • Tweak – Enable the month view cache by default on new installations [74867]
  • Tweak – External links to Google maps changed from http to https (nice find by @bjf2000 – reported via the .org support page) [74930]
  • Tweak – Links to changed from http to https (ultimately this is also credited to @bjf2000’s find. Thanks!) [72273]

[4.4.4] 2017-03-08

  • Fix – Avoid unnecessarily removing a callback from an action while inside the same action (improves PolyLang compatibility – props @Chouby) [73122]
  • Fix – Resolving issue where sites that overrode the wp-admin path would fail to successfully perform a Facebook OAuth with Event Aggregator [74687]
  • Tweak – Improve template loading for easier customization by developers and better support of the template hierarchy (props @QWp6t) [72842]

[4.4.3] 2017-02-22

  • Fix – Resolved issue where iCal exports on month view were exporting more events than intended (thanks to @s2ldesign for reporting in our forums) [72133]
  • Fix – Resolved meta width issue for maps when Pro is active (gracias a @ANTONIO JOSE por el reporte del error) [69844, 72272]
  • Fix – Resolved issue where featured images were not being imported via Event Aggregator Facebook imports (cheers to @Cody for the inital bug report) [72764]
  • Fix – Resolved issue where translated ‘all’ slugs were not respected (thank you @Marianne for your report in the forums) [71996]
  • Tweak – Translation improvements and fixes (@Katja – thanks! ) [70068]
  • Tweak – Allow “-1” when specifying the “Month view events per day” setting [70497]

[4.4.2] 2017-02-09

  • Fix – Ensure the global and source-specific Google Map settings for imports are respected [67228]
  • Fix – Prevent PHP 5.2 Strict mode from throwing notices due to usage of is_a [72812]
  • Fix – Ensure the events list widget’s show/hide if there are upcoming events setting is respected [72965]
  • Tweak – Add filters for template tag functions related to dates: tribe_get_start_time, tribe_get_end_time, tribe_get_start_date and tribe_get_end_date [67759]

[] 2017-01-26

  • Fix – Resolved fatal caused when rendering themes that override tribe styles

[4.4.1] 2017-01-26

  • Fix – Resolve the Fatals related to undefined methods and Memory exhaustion [71958, 71912]
  • Fix – iCal export for Single events working again [71916]
  • Tweak – Changes the Search label to prevent duplicate words (props @oheinrich) [72149]
  • Tweak – Add theme version to tribe-event.css (props @berler) [71973]
  • Fix – Resolve JavaScript error when jQuery was been de-registered [71369]
  • Fix – Prevent Fatals when Importing Images on Event Aggregator [70576]
  • Fix – Prevent Third Party notes to be escaped, anchor link working again [71872]
  • Fix – Google Maps now are using HTTPS instead of HTTP (props @cliffordp)
  • Fix – Prevent Fatals on Event Aggegrator Cron, due to Activity logging failure [71904]
  • Fix – Elminate some cases of problem with Facebook manual import on Event Aggregator [69137]
  • Fix – WPML integration smaller incompatibilities [70520, 70522]

[] 2017-01-09

  • Fix – Adds safety check to ensure a smooth activation process when earlier versions of Tribe Common are active

[4.4] 2017-01-09

  • Feature – Add dynamic helper text to single event editor to display the events date and time [66484]
  • Feature – Add support for featured events [65898]
  • Feature – Add support for placing the main events archive on the site homepage [38757]
  • Feature – Add support for the theme customizer [67489]
  • Feature – Make it possible to adjust map pins via the theme customizer [65889]
  • Feature – Support for Event Aggregator in a multisite network context added [61427]
  • Fix – Add a link to The Events Calendar Help page in the Network Administration screen of multisite installations [68665]
  • Fix – Multisite license editing and displaying consistency [68662]
  • Tweak – Adjusted styles and added actions for featured events in the List Widget [65923]
  • Tweak – Organizers and Venues are now with a better and cleaner interface [68430]
  • Tweak – Eliminate duplicate meta data for organizer posts [25084]
  • Tweak – Improved the start/end date user interface [66486, 66487, 66550]
  • Tweak – iCal export now includes all events – up to a reasonable limit – rather than just those in the current view [65037]
  • Tweak – Adjustments made to the default week view colour scheme [69756]
  • Tweak – Add AJAX and improve consistency of the venue and organizer UI [38129]

[4.3.5] 2016-12-20

  • Tweak – Updated the template override instructions in a number of templates [68229]
  • Tweak – Improve behaviour of tribe_get_events_title() in respect of single events [46313]
  • Tweak – Event Aggregator will only load on the Administration, prevent bigger loads for Front-End users [70812]
  • Tweak – Allow better filtering for Organizers and Venue Meta fields (Props: @Chouby from Polylang) [70894]
  • Fix – Prevent JavaScript Notices related to Bumpdown [69886]
  • Fix – Assets URL on Windows Servers are fully operational again [68377]
  • Fix – JavaScript and CSS files will respect HTTPS on all pages [69561]
  • Fix – Fixed comment count and visibility issues due to Event Aggregator records [68297]
  • Fix – Fixed PHP notices and warnings raised when importing .ics files [69960]
  • Fix – Only show link to Venues if Pro is active in List View [69887]
  • Fix – Fixed and issue that would make Event Aggregator importing notices remain stuck in the Import screen [70614]
  • Fix – Avoid error screen when saving licenses on multisite installations [68599]
  • Fix – Fix calendar view links in WPML language switcher [67134]

[] 2016-12-13

  • Fix – Correct an oversight leading to breakages of the /all/ events archive for Events Calendar PRO users [70662]

[] 2016-12-09

  • Fix – Updates Tribe Common to remove some stray characters that were impacting page layouts (props: @Aetles) [70536]

[4.3.4] 2016-12-08

  • Tweak – Tribe Common now is loaded only once across our plugin suite, improves performance on some cases [65755]
  • Fix – Featured Images for Event Aggregator imports are works as expected again. [69465]
  • Fix – Google Calendar and iCalendar files are now updating it’s repective events [68684]
  • Fix – On demand Event Aggregator records will update events corretly [69542]

[4.3.3] 2016-11-16

  • Feature – Added Tribe Extension class and loader, to make small addons easier to build [68188]
  • Fix – Ordering on Month view is working as expected again [69123]
  • Fix – Enable ampersand character in mobile month view titles (thanks @kate for the report of this) [45409]
  • Fix – Prevent notices for Event Aggregator License checking [67981]
  • Fix – Miss-Matched text domains are resolved, important for translations (props to @Hans) [68462]
  • Fix – Sticky on Month View is working as expect again [68902]
  • Fix – Prevent HTTPS websites from pointing to Assets in HTTP [68372]
  • Fix – On WP_Query we will no-longer overwrite custom post__not_in params [42143]

[4.3.2] 2016-11-02

  • Fix – Fixes an issue where the text in the Location search field was URL encoded when using the back or forward button for navigation. [61742]
  • Fix – Aggregator Errors will not show more than once daily as comments (Thanks @Jacob for your report on the forums) [68094]
  • Fix – Event Aggregator ICS default configuration now are been Selected Correctly [67885]
  • Fix – Shortcode Month view now will display tooltips correctly [68094]
  • Fix – Avoid loading the select2 JavaScript library twice when Advanced Custom Fields is activated (props to @ryan for the initial report [43605]
  • Fix – Avoid errors and notices on calendar page when X theme and WPML plugins are active (thanks @ingrid for reporting this one) [64400]

[] 2016-10-20

  • Fix – Corrected a packaging issue from the 4.3.1 release [67936]

[4.3.1] 2016-10-20

  • Tweak – Implement the pruning of Event Aggregator history records after 7 days, filterable by tribe_aggregator_record_retention [68283]
  • Tweak – Event Aggregator will now verify that the license key has uses remaining before creating a history record [68286]
  • Tweak – Improve tribe_create_event documentation (Props to Keith) [44871]
  • Fix – Resolved an issue where scheduled Event Aggregator imports marked as “On Demand” were being run by cron [68284]
  • Fix – Resolved a bug where empty meta fields were being inserted into Event Aggregator record post meta [68290]
  • Fix – Resolved a bug where Venue and Organizers urls were been generated incorrectly (Thanks @Matt) [68168]
  • Fix – Pagination links on Month view are updating correctly [67977]
  • Fix – Resolved the support for translated event category archive slug that could lead to broken links on the front-end while using WPML (Props to Wilco in the support Forums) [62018]
  • Fix – Resolved a bug where searching for past events in the List view would always yield no results (Thanks for the report @Davide) [61863]
  • Fix – Resolved an issue where long file names would break plugin updates on some Windows installations (pros to @Alan [62552]
  • Fix – Resolved an issue where the /all link on recurring events on non English websites could be broken (reported by @lumiest – thanks!) [68062]
  • Fix – Pagination links on Month view are updating correctly [67977]

[] 2016-10-14

  • Fix – Preventing legacy Facebook events from been duplicated

[4.3] 2016-10-13

  • Feature – Added Event Aggregator to enable service-based event imports from iCal feeds, Facebook, and Meetup
  • Feature – Revamped the CSV import screens to work within the new Event Aggregator pages
  • Tweak – Adjusted some view logic to support the new Event Views shortcode in Pro [44800]
  • Tweak – Added a button to copy the system infomation on the help tab [43709]
  • Tweak – Added an option for users to opt into automatic system infomation so our support system can grab the system information found on the help tab automatically [31645]
  • Tweak – Use an earlier hook for iCal feed generation (props @jlambe) [64141]
  • Tweak – Revise and simplify integration with Event Tickets attendee screen [61992]
  • Tweak – Added context to a set of strings to make translation easier (props @pedro-mendonca) [64586]
  • Tweak – Deprecated various disused functions and classes relating to the Meta Factory [39905]
  • Fix – Cease using GLOB_BRACE for including deprecated files due to limited server support [63172]
  • Fix – Avoid problems that can occur when hooking and unhooking actions (props @Chouby) [63474]
  • Fix – Resolves an issue where we were duplicating a core WordPress hook but with a different set of parameters (props @Chouby) [66455]
  • Fix – Correct the datetime formatting issues within the iCal feed (props @henryk) [65968]
  • Deprecated – Tribe__Events__Main::initOptions() has been deprecated with no replacement
  • Deprecated – Tribe__Events__Main::set_meta_factory_global() has been deprecated in favor of using the Tribe__Events__Meta_Factory class
  • Deprecated – The setup_meta() method in both the Tribe__Events__Template__Single_Event and Tribe__Events__Template_Factory classes has been deprecated
  • Deprecated – The the_title(), event_date(), event_category(), event_tag(), event_website(), event_origin(), organizer_name(), organizer_email(), venue_name(), venue_address(), and venue_map() methods have been deprecated in the Tribe__Events__Advanced_Functions__Register_Meta class
  • Deprecated – The register(), check_exists(), and get_args() methods have been deprecated in the Tribe__Events__Meta_Factory class

[4.2.7] 2016-09-15

  • Tweak – Additional support for plugin extensions

[4.2.6] 2016-08-31

  • Add – tribe_is_event_past() conditional to detect if event end time is past current time (Reported by @Jonathan in our support forums – thanks Jonathan.)

[4.2.5] 2016-08-17

  • Fix – Fixed inconsistent template filtering logic for single event template [62525]
  • Tweak – Restored preview for published events [64874]

[4.2.4] 2016-08-03

  • Tweak – Changed “Event Add-Ons” to load faster [64286]
  • Fix – Fixed default venue setting [64628]
  • Fix – Fixed default venue state and province settings [64629]

[4.2.3] 2016-07-20

  • Fix – In month view, be sure to unhook JSON-LD output when calling unhook function
  • Fix – Incorrect JSON-LD event start and end times (thank you @jjbte for reporting on .org forums)
  • Fix – Show Google Map and Link checkbox so they show when editing an event (Reported originally by Michael of @NailedIT in the .org forum)
  • Fix – Use Community Events Venue Edit Link when on Community Events Forms instead of Admin (also as a result of the report abve from @NailedIT. Thanks again.)

[4.2.2] 2016-07-06

  • Fix – Small CSS Issue on Welcome Page
  • Fix – Month view on mobile device width doesn’t have links to prev/next months
  • Fix – Reimport of updated CSV removes featured image (Bug #46149)
  • Fix – Fixed the issue that would make multiple organizers details disappear when trying to submit invalid event data using Community
  • Fix – Add a check to avoid being unable to switch view when Filter Bar plugin is active and at least one field is set to auto-complete mode
  • Fix – Only add the events custom post type to the tag archive queries and not custom queries with tags [45635]
  • Fix – When using the filter tribe_events_excerpt_allow_shortcode shortcodes will be maybe be processed in event excerpts in the list views [42289]

[] 2016-06-28

  • Fix – Ensure translations load as expected with all supported versions of WordPress (thanks to @JacobALund for originally reporting this on .org forums)

[4.2.1] 2016-06-22

  • Tweak – Adjust the caching rules for Month View for faster loading
  • Fix – Replace a bad return type to avoid unnecessary notices in the error log
  • Fix – Add missing styles for correctly hide screen reader text
  • Fix – Fixes tribe_get_event_link() which wasn’t working when passing second parameter as `true’
  • Tweak – Reduce the ginormous font size of Month View titles in skeleton styles
  • Fix – Add styling to adjust List View description to full width
  • Fix – Miscellaneous tweaks to improve the Month and Day views
  • Fix – Fix a shorthand array that was causing errors in PHP 5.2 and 5.3 when importing events

[4.2] 2016-06-08

  • Feature – Added Google Maps API key field in the Settings tab to avoid map timeouts and errors on larger sites (Thanks to Yan for reporting this!)
  • Feature – Added support for featured image, multiple organizers, excerpt and more custom fields in the .csv file import function for events (Thank you to Graphic Designer for posting on UserVoice!)
  • Feature – Added support for featured image, description, map details and more custom fields in the .csv file import function for venues
  • Feature – Added support for featured image and description in the .csv file import function for organizers (Thank you to Rebecca for posting on UserVoice!)
  • Feature – Added an oEmbed template for events
  • Feature – Improve performance of a query used to determine if there are free/uncosted events (Thank you @fabianmarz for the pull request!)
  • Feature – Added support for attaching custom post types to events
  • Tweak – Improved filtering of the tribe_event_featured_image() function (Cheers to @fabianmarz!)
  • Tweak – Add an encoding class for the CSV importer to prevent non utf8 characters from preventing imports (Thanks to screenrage for the report!)
  • Tweak – Improved our JSON-LD output to ensure consistency (Props to @garrettjohnson and Lars!)
  • Tweak – Language files in the wp-content/languages/plugins path will be loaded before attempting to load internal language files (Thank you to user aafhhl for bringing this to our attention!)
  • Tweak – Switch to HTTPS for the “Powered by The Events Calendar” link (Thank you Cynthia for reporting this!)
  • Tweak – Switch to using HTTPS by default for interactions with Google Maps API
  • Tweak – Improved filterability of calendar excerpts by introducing the new tribe_events_get_the_excerpt filter hook
  • Tweak – Improved filtering of organizer details when importing by CSV (Props to @Geir for bringing this up!)
  • Tweak – Adjustments for single event view in Twenty Fifteen theme
  • Tweak – Improved performance of query used to test for events without any cost
  • Tweak – Added missing semicolon to a laquo (Props to mwender on GitHub for the fix!)
  • Tweak – Improve the “stickiness” of CSV import column mappings (Thank you @jamesgol!)
  • Tweak – Consistency of JSON-LD markup improved (Cheers to @garrettjohnson for the help!)
  • Tweak – Avoid notice-level errors when working with WP CLI on a site where The Events Calendar is also active (Thanks to @sun)
  • Tweak – Corrected the spelling of timezone in the CSV Importer’s event field
  • Tweak – Updated venue and organizer templates to use the new architecture for attaching custom post types to events
  • Tweak – Move plugin CSS to PostCSS
  • Tweak – Category default view is now set to default in place of hardcoding the current default view in the category base rewrite rule [31907]
  • Deprecated – Tribe__Events__PUE__Checker, Tribe__Events__PUE__Plugin_Info, and Tribe__Events__PUE__Utility classes are deprecated and are replaced by Tribe__PUE__Checker, Tribe__PUE__Plugin_Info, and Tribe__PUE__Utility classes
  • Fixed – Changed the use of have_posts() in the maybe iCal links for the main views that could cause an infinite loop
  • Accessibility – Focus styles added for search fields
  • Accessibility – Add ARIA labels for Month/Day/List sub nav
  • Accessibility – Add ARIA label for events footer sub nav heading

[4.1.4] 2016-05-19

  • Fix – Improve accuracy of list view pagination after switching from month view
  • Tweak – Give the multi-organizer form ‘sticky’ properties so values persist even if the submission is initially rejected
  • Tweak – Resolved minor CSS issues in the welcome page

[4.1.3] 2016-04-28

  • Fix – Month View single days are now ordered as follows: sticky events, ongoing multi-day events, all day events, then start time. In other words, all events should be ordered as you’d expect when viewing events in Month View.
  • Fix – Updated the compatibility of CSV importer with WordPress 4.5 due to a change in the post_status filter. This will help prevent some of the errors you may have seen when importing events using a CSV file.
  • Tweak – Added new event names for AJAX success to the List, Month, and Day views to help The Events Calendar’s compatibility with our other premium plugins.

[4.1.2] 2016-04-11

  • Tweak – Removed an unneeded hook that attempted to add a query argument to event tag links
  • Fix – Resolved an issue where events marked as “sticky” would not display as such in Month View
  • Fix – Dashes, hyphens, or whatever you like to call them in the events archive slug no longer breaks the URL
  • Fix – The notice that pops up when a conflicting “events” page exists can now be dismissed

[] 2016-04-07

  • Security – Tightened up security with post type link filtering (props to Nadal Soler for reporting this issue!)
  • Security – Tightened up security around tribe bar submissions (props to Paul Mynarsky for reporting this issue!)

[4.1.1] 2016-03-30

  • Fix – Resolved bug where array notices were output on single event pages when venues were not set (props to zaxiscreative for reporting this issue!)
  • Fix – Resolved issue where the Month View in mobile sizes retained the long day-of-week names when the abbreviations should have been used (props to Lucy for the bug report!)
  • Fix – Fixed bug where a “0” was added to the default Venue name when creating a new event
  • Fix – Fixed notice that caused Ajax requests to fail (props to cgrymala on for reporting this!)
  • Fix – Removed quotes from around TZID-specified timezones in iCal feeds which causes problems with some parsers (props to factory44 for reporting the issue that lead to this fix)
  • Fix – Resolved various capitalization issues with German translations (props to oheinrich in our forums for pointing out this issue!)

[] 2016-03-17

  • Fix – Resolved multiple issues with the German de_DE language file that caused a number of site-breaking issues

[4.1] 2016-03-15

  • Feature – Added a tribe_get_venue_website_url() function for fetching Venue website URLs (props to fervorcreative in our forums for this request!)
  • Performance – Lazy-load venue and organizer selector data
  • Tweak – Allow iCal filenames to be filtered via a new filter: tribe_events_ical_feed_filename
  • Tweak – Added a hook to allow single day queries in month view to be filtered: tribe_events_month_daily_events_query_args
  • Tweak – Improved the logic around rebuilding known date ranges
  • Tweak – Always show the “Merge Duplicates” button for venues and organizers in the Events General Settings page
  • Tweak – Allow the “same slug” notice to be dismissed and fix some text in that message
  • Tweak – Ignore alpha/beta/rc suffixes on version numbers when checking template versions
  • Tweak – Add a filter for month view daily events query: tribe_events_month_daily_events_query_args
  • Tweak – Added a more flexible cost range parsing function
  • Tweak – Obfuscate license keys Events > Help > System Information
  • Fix – Fixed a fatal that sometimes occurred when refreshing the import CSV page
  • Fix – Fixed issue where some characters were not escaped appropriately for month and year formats
  • Fix – Added missing tribe-loading@2x.gif
  • Fix – Fixed a warning produced by passing a DateTime() object into start_date or end_date args of tribe_get_events (props to iamhexcoder for the pull request!)
  • Fix – Fixed bug where events in month view were not always sorted in chronological order
  • Fix – Fixed the System Info URL in Events > Help
  • Fix – Resolved issue where the default country would be “Array” if no default country is set
  • Fix – Fixed bug where ajaxurl was sometimes undefined

[4.0.7] 2016-03-02

  • Fix – Resolve display issues on templates with Jetpack and a few themes
  • Fix – Mobile breakpoints on month view working with custom breakpoints
  • Fix – Reordering Venue and Organizer metadata no longer breaks titles
  • Fix – Prevented notices from happening when using the_title filter
  • Fix – iCal links now will respect categories on the first page
  • Fix – Prevent third-party bugs with SEO plugins when inserting events programmatically
  • Fix – Organizer information is showing up again correctly
  • Fix – Modified the add-on license validation method to better explain what is happening
  • Fix – Description on mobile views now have the correct class attribute on HTML
  • Fix – Added missing semicolon on the list navigation for “&laquo”

[4.0.6] 2016-02-17

  • Tweak – Adjust injection of event data into the_content from priority 10 to 9 for better 3rd-party plugin compatibility
  • Tweak – Change mobile month view selector to load event details below the calendar for better theme compatibility
  • Tweak – Better handling of edge cases on the post_excerpt for List View
  • Tweak – Removal of generic CSS classes like .updated and .published
  • Fix – Prevent Notices from appearing when using tribe_get_organizer()
  • Fix – Make HTML Single Event Pages valid
  • Fix – Numeric named categories URLs are now fully working
  • Fix – Event Title now Accepts HTML on Tooltips
  • Fix – Licenses Tab now will work with DISALLOW_FILE_MODS (Props to Sun for spotting and fixing this)

[4.0.5] 2016-01-15

  • Security – Security fix with Venues and Organizers (props to grantdayjames for reporting this!)

[4.0.4] 2015-12-23

  • Tweak – Including the latest embedded Event Tickets release for backward compatibility

[4.0.3] 2015-12-22

  • Tweak – Adjust single-event.php template to allow the “Time” title and content to be filterable (Props to Sitecrafting for highlighting this issue!)
  • Fix – Resolved issue with an overly escaped Event Category edit URL that prevented editing categories (Thanks to Ian for the first report of this issue!)
  • Fix – Fixed issue where clicking on columns on the Events listed in the Admin Dashboard were ALWAYS sorted by Event start/end date before sorting by the column selected (Cheers to Corrado for bringing this to our attention!)

[4.0.2] 2015-12-16

  • Tweak – Adding better support for non-numeric cost values on events (Props to Mirja for highlighting this!)
  • Tweak – Avoid notice level errors when advanced events list widget settings are saved (Thank you Johan for reporting the issue!)
  • Tweak – Improve messaging in the same-slug warning message (Thanks to Simon for bringing this to our attention!)
  • Tweak – Hook to Event Tickets to inject event dates into ticket emails
  • Tweak – Adding better support for default venues (Props to Karly for noting this!)
  • Tweak – Improve handling of internationalized slugs (Cheers to Oliver for the help!)
  • Fix – Ensure the past events list displays the correct events when accessed via ajax (Thank you Jesse for highlighting this!)
  • Fix – Support ordering by venue/organizer within event queries (Thank you Doug for bringing this to our attention!)
  • Fix – Fixed issue where events with the same date/time would sometimes be excluded from single-event navigation (Cheers to JeremyEnglert for the tip!)
  • Fix – Resolved issue where events set with the explicit cost of 0 were not showing as “Free” (Thank you terrizsolo for reporting this!)
  • Fix – Fixed bug where the datepicker in Twenty Sixteen was really ugly
  • Fix – Fixed bug where using Quick Edit on events caused the table columns in the event list to become jumbled on save (Props to A K for the report!)
  • Fix – Resolved bug where category links sometimes included event category 1 (Thank you Anthony for the original report of this problem!)
  • Fix – Fixed a settings page URL (Props to Kristy for the heads up!)

[4.0.1] 2015-12-10

  • Tweak – Add a warning message for major updates
  • Tweak – For SEO reasons, use an h1 for the title rather than an h2 (props to wpexplorer for this fix)
  • Tweak – Target the calendar view grid in JS using a simpler selector
  • Fix – Resolved WP 4.4 related fatal on the Nav Menu page that prevented the admin footer from rendering/enqueuing JS
  • Fix – Resolved bug where visiting /events/upcoming could sometimes result in an infinite redirect loop
  • Fix – Removed wp_trim_excerpt and use only it’s powers, fixing the excerpt problem
  • Fix – Fixed bug where the mobile calendar view did not display the date for the date being viewed
  • Fix – Fixed bug where the admin toolbar’s Events > Import > CSV did not link to the CSV importer page
  • Fix – Fixed issue where the events list in the admin dashboard were not ordered in an intuitive manner
  • Fix – Resolved bug where sorting by event category or tag resulted in an error
  • Fix – Fixed bug where full event content text was displayed where excerpts should have been displayed
  • Fix – Resolved issue where events imported via CSV were excluded from single event navigation
  • Fix – Fixed bug where /events/list would sometimes 404 on a new install
  • Fix – Resolved bug where multiday all-day events displayed the end date as one day later than it should be when the End of Day Cut-off was set to something other than 12am
  • Fix – Timezone handling fixed within generated iCal feeds

[4.0] 2015-12-02

  • Security – A TON of escaping was added to our codebase thanks to the efforts of the always-helpful Andy Fragen (@afragen)
  • Feature – Moved the Ticket framework code into its own plugin (event-tickets)
  • Feature – The event cost now supports more international formats with the addition of the tribe_events_cost_separators filter (Thank you remokrol for bringing this to our attention!)
  • Feature – Added support for the twentysixteen theme
  • Feature – Created a new Add-Ons tab in Settings so that TEC add-ons can have a consolidated settings tab
  • Feature – Improve the date formats UI by providing example output for each selected format
  • Tweak – Restructured TEC’s core settings code for reusability with other standalone plugins like Event Tickets
  • Tweak – Deprecate old JS event names in favor of a new JS event naming standard. Example: deprecated tribe_ev_runAjax in favor of run-ajax.tribe
  • Tweak – Consolidated import pages for TEC and add-ons
  • Tweak – When suggesting a UTF-8 compatibility CSV formatting tool, point to one that still exists
  • Tweak – Added the ability to filter attendees CSV items via tribe_events_tickets_attendees_csv_items (Props to @bostondv on GitHub for this patch!)
  • Tweak – Updated all excerpt output to use tribe_events_get_the_excerpt() to ensure a consistent display of excerpt content (Cheers to Joseph to pointing this out!)
  • Tweak – Add support for wp_get_document_title in response to the WordPress 4.4 deprecation of wp_title
  • Tweak – Check post creation permissions before letting users create venues and organizers from the event meta box
  • Tweak – Only display data separators between fields that have data when rendering organizers (Thank you Bud for highlighting this issue!)
  • Tweak – When a user cannot create organizers, prevent the auto-selection of organizers when editing an event
  • Tweak – Remove microformat CSS classes from templates and replace with namespaced content-relevant CSS classes
  • Tweak – Changed the “updated” CSS class to “tribe-updated” so that it is properly namespaced (Thank you vijayrajesh!)
  • Tweak – The Plugin Update Checker will now auto-save valid plugin keys (Thanks to Denon for originally bringing this up!)
  • Tweak – Cleaned up the output of JSON-LD data. Filterable via the new tribe_google_data_markup_json filter
  • Tweak – Drop the use of the generic CSS class “placeholder” in favor of “tribe-event-placeholder” (Thanks to Marc on the forums!)
  • Tweak – Adjusted the CSS padding on Admin Menu items for Events
  • Tweak – Various codesniffer fixes
  • Tweak – tribe_get_venue_link() no longer echoes if you ask it to return an element
  • Tweak – Error messages for empty Venue names
  • Tweak – Improve our responsiveness for the widget mini calendar, allowing smaller sidebars.
  • Tweak – No longer retrieve empty costs when fetching all costs for all events
  • Tweak – Change the priority of bootstrapping the-events-calendar to ensure it occurs before any of the TEC addons in the event some addons are upgraded to v4.0 later than TEC
  • Tweak – Adjust the logic used for adding a noindex/follow tag to event views
  • Tweak – No longer hiding default address fields when default venues are selected when Pro is active
  • Fix – Resolved issue where the iCal feed did not provide an appropriately formatted timezone in some cases (Cheers to Matt for the report!)
  • Fix – Added support for translating some previously untranslatable strings (Props to tititou36, media325, and Stef!)
  • Fix – Prevented duplicate CSS IDs on the mini calendars (Cheers to Corrado for the help!)
  • Fix – Fixed bug causing tribe_get_single_ical_link() and tribe_get_ical_link() to use the same URL when it shouldn’t (Props to Ben Byrne @drywall on Twitter for the heads up!)
  • Fix – Fixed issue where the “Add another organizer” text wasn’t using the correct singular label (Thank you MIKE for the report!)
  • Fix – Various CSS fixes for twenty(ten-fifteen)
  • Fix – Improved our handling of get_current_screen() across the plugin, avoiding notices and warnings (Thank you Mike for the help!)
  • Fix – Fixed bug where accessing object properties on a non object errored out when saving event meta (props to @dalethedeveloper on GitHub for this fix!)
  • Fix – Fixed bug where organizer ID meta attached sometimes included a blank record. That blank record is no longer returned in tribe_get_organizer_ids()
  • Fix – Fixed error message returned when tabbing away from a blank event name meta box so that it properly indicates that an event name is required (Our thanks to @tapan29bd for this fix!)
  • Fix – Resolved issue where Timezone event start/end date property name strings were malformed which guaranteed a a call to get_post_meta for Timezone date strings
  • Fix – Fixed CSS issue where the month view calendar could sometimes extend beyond the edge of the page when Skeleton Styles were enabled
  • Fix – Fixed a problem where iCal data was generated with incorrect dates in the case of some all days events (thanks to Matt for highlighting this)
  • Fix – Resolved a problem causing the previous month view to appear when it should not
  • Fix – Fixed issue in mobile month view where date was missing from heading
  • Fix – Resolved issue that caused /events/ to 404 if it was visited on a new install before hitting “Save” on the Events > Settings > Display page
  • Deprecated – The Tribe__Events__Main::defaultValueReplaceEnabled() method is being deprecated in favor of tribe_get_option(‘defaultValueReplace’). Schedules for removal in v4.5
  • Deprecated – The tribe_event_link() has been deprecated in favor of tribe_get_event_link(). Scheduled for removal in 5.0
  • Deprecated – The third parameter of tribe_get_organizer_link() (the $echo parameter) has been deprecated and is scheduled for removal in 5.0
  • Deprecated – Tribe__Events__Abstract_Deactivation in favor of Tribe__Abstract_Deactivation
  • Deprecated – Tribe__Events__Admin__Helpers in favor of Tribe__Admin__Helpers
  • Deprecated – Tribe__Events__App_Shop in favor of Tribe__App_Shop
  • Deprecated – Tribe__Events__Autoloader in favor of Tribe__Autoloader
  • Deprecated – Tribe__Events__Cache in favor of Tribe__Cache
  • Deprecated – Tribe__Events__Cache_Listener in favor of Tribe__Cache_Listener
  • Deprecated – Tribe__Events__Changelog_Reader in favor of Tribe__Changelog_Reader
  • Deprecated – Tribe__Events__Credits in favor of Tribe__Credits
  • Deprecated – Tribe__Events__Date_Utils in favor of Tribe__Date_Utils
  • Deprecated – Tribe__Events__Field in favor of Tribe__Field
  • Deprecated – Tribe__Events__Settings in favor of Tribe__Settings
  • Deprecated – Tribe__Events__Settings_Tab in favor of Tribe__Settings_Tab
  • Deprecated – Tribe__Events__Support in favor of Tribe__Support
  • Deprecated – Tribe__Events__Template_Part_Cache in favor of Tribe__Template_Part_Cache
  • Deprecated – Tribe__Events__Tickets__Attendees_Table in favor of Tribe__Tickets__Attendees_Table in the event-tickets plugin
  • Deprecated – Tribe__Events__Tickets__Metabox in favor of Tribe__Tickets__Metabox in the event-tickets plugin
  • Deprecated – Tribe__Events__Tickets__Ticket_Object in favor of Tribe__Tickets__Ticket_Object in the event-tickets plugin
  • Deprecated – Tribe__Events__Tickets__Tickets in favor of Tribe__Tickets__Tickets in the event-tickets plugin
  • Deprecated – Tribe__Events__Tickets__Tickets_Pro in favor of Tribe__Tickets__Tickets_Handler in the event-tickets plugin
  • Deprecated – Tribe__Events__Validate in favor of Tribe__Validate
  • Deprecated – Tribe__Events__View_Helpers in favor of Tribe__View_Helpers
  • Deprecated – Tribe__Events__Main::OPTIONNAME in favor of Tribe__Main::OPTIONNAME
  • Deprecated – Tribe__Events__Main::OPTIONNAMENETWORK in favor of Tribe__Main::OPTIONNAMENETWORK
  • Deprecated – Tribe__Events__Main::addHelpAdminMenuItem() in favor of Tribe__Settings_Manager::add_help_admin_menu_item()
  • Deprecated – Tribe__Events__Main::addNetworkOptionsPage() in favor of Tribe__Settings_Manager::add_network_options_page()
  • Deprecated – Tribe__Events__Main::array_insert_after_key() in favor of Tribe__Main::array_insert_after_key()
  • Deprecated – Tribe__Events__Main::array_insert_before_key() in favor of Tribe__Main::array_insert_before_key()
  • Deprecated – Tribe__Events__Main::debug() in favor of Tribe__Debug::debug()
  • Deprecated – Tribe__Events__Main::defaultValueReplaceEnabled() in favor of tribe_get_option( ‘defaultValueReplace’ )
  • Deprecated – Tribe__Events__Main::doHelpTab() in favor of Tribe__Settings_Manager::do_help_tab()
  • Deprecated – Tribe__Events__Main::doNetworkSettingTab() in favor of Tribe__Settings_Manager::do_network_settings_tab()
  • Deprecated – Tribe__Events__Main::doSettingTabs() in favor of Tribe__Settings_Manager::do_setting_tabs()
  • Deprecated – Tribe__Events__Main::do_licenses_tab() in favor of Tribe__Settings_Manager::do_licenses_tab()
  • Deprecated – Tribe__Events__Main::getNetworkOption() in favor of Tribe__Settings_Manager::get_network_option()
  • Deprecated – Tribe__Events__Main::getNetworkOptions() in favor of Tribe__Settings_Manager::get_network_options()
  • Deprecated – Tribe__Events__Main::getNotices() in favor of Tribe__Notices::get()
  • Deprecated – Tribe__Events__Main::getOption() in favor of Tribe__Settings_Manager::get_option()
  • Deprecated – Tribe__Events__Main::getOptions() in favor of Tribe__Settings_Manager::get_options()
  • Deprecated – Tribe__Events__Main::have_addons() in favor of Tribe__Settings_Manager::have_addons()
  • Deprecated – Tribe__Events__Main::isNotice() in favor of Tribe__Notices::is_notice()
  • Deprecated – Tribe__Events__Main::pluginDir in favor of Tribe__Events__Main::plugin_dir
  • Deprecated – Tribe__Events__Main::pluginName in favor of Tribe__Events__Main::plugin_name
  • Deprecated – Tribe__Events__Main::pluginPath in favor of Tribe__Events__Main::plugin_path
  • Deprecated – Tribe__Events__Main::pluginUrl in favor of Tribe__Events__Main::plugin_url
  • Deprecated – Tribe__Events__Main::removeNotice() in favor of Tribe__Notices::remove_notice()
  • Deprecated – Tribe__Events__Main::renderDebug() in favor of Tribe__Debug::render()
  • Deprecated – Tribe__Events__Main::saveAllTabsHidden() in favor of Tribe__Settings_Manager::save_all_tabs_hidden()
  • Deprecated – Tribe__Events__Main::setNetworkOptions() in favor of Tribe__Settings_Manager::set_network_options()
  • Deprecated – Tribe__Events__Main::setNotice() in favor of Tribe__Notices::set_notice()
  • Deprecated – Tribe__Events__Main::truncate() in favor of tribe_events_get_the_excerpt()
  • Deprecated – tribe_event_beginning_of_day() in favor of tribe_beginning_of_day()
  • Deprecated – tribe_event_end_of_day() in favor of tribe_end_of_day()
  • Deprecated – tribe_event_format_date() in favor of tribe_format_date()
  • Deprecated – tribe_events_the_notices() in favor of tribe_the_notices()

3.x and previous

For release notes from the 3.x and older lifecycles, see our full historical release notes.