The Events Calendar Shortcode & Block

Here’s the full list of shortcode and block options you can use to customize how your events display: Basic shortcode: [ecs-list-events] cat - Show events from an event category [ecs-list-events cat='festival'] or specify multiple categories [ecs-list-events cat='festival, workshops'] limit - Total number of events to show. Default is 5. [ecs-list-events limit='3'] order - Order of the events to be shown. Value can be 'ASC' or 'DESC'. Default is 'ASC'. Order is based on event date. [ecs-list-events order='DESC'] date - To show or hide date. Value can be 'true' or 'false'. Default is true. [ecs-list-events eventdetails='false'] venue - To show or hide the venue. Value can be 'true' or 'false'. Default is false. [ecs-list-events venue='true'] excerpt - To show or hide the excerpt and set excerpt length. Default is false. [ecs-list-events excerpt='true'] //displays excerpt with length 100 excerpt='300' //displays excerpt with length 300 thumb - To show or hide thumbnail image. Default is false. [ecs-list-events thumb='true'] //displays post thumbnail in default thumbnail dimension from media settings. thumbsize - Specify the size of the thumbnail. [ecs-list-events thumb='true' thumbsize='large'] thumbwidth / thumbheight - Customize the thumbnail size in pixels [ecs-list-events thumb='true' thumbwidth='150' thumbheight='150'] message - Message to show when there are no events. Defaults to 'There are no upcoming events at this time.' viewall - Determines whether to show 'View all events' or not. Values can be 'true' or 'false'. Default to 'true' [ecs-list-events cat='festival' limit='3' order='DESC' viewall='false'] contentorder - Manage the order of content with commas. Default to title, thumbnail, excerpt, date, venue. [ecs-list-events cat='festival' limit='3' order='DESC' viewall='false' contentorder='title, thumbnail, excerpt, date, venue'] month - Show only specific month (in YYYY-MM format). Type 'current' for displaying current month only or 'next' for next month. [ecs-list-events cat='festival' month='2024-06'] past - Show Outdated Events. [ecs-list-events cat='festival' past='yes'] key - Hide events when the start date has passed [ecs-list-events cat='festival' key='start date'] orderby - Change the ordering to the end date [ecs-list-events orderby="enddate"] With The Events Calendar Shortcode & Block Pro you also get the following options: design - Shows improved design by default. Set to 'standard' for the regular one, 'compact' for a more compact listing, 'calendar' for a monthly calendar view, 'columns' to show a horizontal/columns/photo view, or 'grouped' to group events by day filter bar - Allow the user to filter the events shown (ie. by category, state/province, country, venue, etc) pagination - Allow the user to view additional pages of events days - Specify how many days in the future, for example [ecs-list-events days="1"] for one day or [ecs-list-events days="7"] for one week tag - Filter by one or more tags. Use commas when you want to filter by multiple tags. id - Show a single event, useful for displaying details of the event on a blog post or page location (city, state/province, country) - Display events by location. Use commas when you want to include events from multiple (ie. country='United States, Canada') description - Use the full description instead of the excerpt of an event in the listing raw_description - Avoid filtering any HTML (spacing, links, bullet points, etc) in the description raw_excerpt - Avoid filtering any HTML (spacing, links, etc) in the excerpt featured only - Show only events marked as "featured" date - Show only events for a specific day [ecs-list-events date='2024-04-16'] year - Show only events for a specific year [ecs-list-events year='2024'] date range - Show only events between certain days [ecs-list-events fromdate='2024-05-31' todate='2024-06-15'] timeonly - To show just the start time of the event. [ecs-list-events timeonly='true'] offset - Skip a certain number of events from the beginning, useful for using multiple shortcodes on the same page (with ads in between) or splitting into columns custom design - Create one or more of your own using shortcode variables or templates for use with the shortcode hiderecurring - To only show the first instance of a recurring event, set to 'true' Get The Events Calendar Shortcode & Block Pro

Yes! There is now a block to list your events anywhere in a page or post, just click "+" in the top-left and search for The Events Calendar Block (under Common).

You can put the shortcode in a text widget.

Yes! This plugin includes an Elementor Widget.

By default the plugin does not include styling. Events are listed in ul li tags with appropriate classes for styling with a bit of CSS. ul class="ecs-event-list" li class="ecs-event" and "ecs-featured-event" (if featured) event title link is H4 class="entry-title summary" date class is time venue class is venue span .ecs-all-events p .ecs-excerpt Want a better looking design without knowing any CSS? Check out The Events Calendar Shortcode & Block Pro

Put this in the template where you want the events list to display: <?php echo do_shortcode("[ecs-list-events]"); ?>

The pro version of the plugin has the option to put design="calendar" in the shortcode (or pick Calendar as the design with the block) to show a calendar view of the events you want.