This is the default design in The Events Calendar Shortcode Pro if you don’t specify another one. This design is good for a list view within a post or a page.
[ecs-list-events]
You can change how many events are displayed with the limit parameter, ie.
[ecs-list-events limit="2"]
Note if the ‘Google Maps Link’ is enabled for an event, it will be shown.
Late Night Party
Los Angeles, CA 90013 United States
Pagination
Show previous and next links, allowing more events to be displayed by visitors. The amount of events on each page can be controlled using the limit value.
[ecs-list-events pagination="true" limit="3"]
Farmer’s Market
Lahaina, 96761 United States
Kitten Adoption Day
San Jose, 95128 United States
Excerpt
You can show the excerpt with:
[ecs-list-events excerpt="true"]
Movie Marathon
San Jose, 95128 United States
Dictumst nunc in turpis ad, ullamcorper enim quis donec sodales, placerat lorem volutpat penatibus, ...
Rock Concert
Portland, 97214 United States
Suspendisse magna aliquet integer molestie, nunc justo dolor nec tellus, lobortis sit nisl dignissim...
Description
The full description content can be shown by adding description=”true” or even showing the full description content (with formatting/HTML) using:
[ecs-list-events excerpt="true" description="true" raw_description="true"]
Kitten Adoption Day
San Jose, 95128 United States
Ut donec ut facilisis molestie, orci in mi molestie, adipiscing vestibulum et ante, neque quis mollis nunc dictumst. Elit placerat sit elit wisi, voluptas wisi amet ultricies non, in maecenas imperdiet ornare. Nisl urna quisque aptent sollicitudin, venenatis donec nulla eu cursus. Cras posuere wisi luctus ut, magna porttitor suspendisse lectus, mi id nulla quis, nec viverra justo gravida quam. Vulputate nec augue varius, quibusdam enim conubia nibh, fusce vestibulum faucibus fringilla, proin lectus varius dolor. Ante sed sem id, est justo dolor turpis, eleifend sit nonummy erat per, faucibus erat natoque in. At id arcu nullam lorem, fusce faucibus mi a, lorem id dolor velit. Consequat ac in curabitur id, mauris nulla facilisi consectetuer sem. Est sed duis suspendisse, class sit adipiscing commodo, leo eu ac ut dignissim. Erat id mauris etiam sagittis, tortor at curabitur adipiscing vestibulum. Sed ante rutrum ipsum nec, neque sed elementum et nonummy, integer nunc vivamus rutrum, justo dapibus wisi quis eget. Turpis per nunc fusce tristique, urna malesuada cum et vitae.
Cost
The cost can also be displayed in this view:
[ecs-list-events limit="2" cost="yes"]
Rock Concert
$15 – $40
Portland, 97214 United States
Late Night Party
$5
Los Angeles, CA 90013 United States
Button
You can put whatever text you want with the button option, and modify the colors of the button with buttonbg and buttonfg
Note: Adding buttonlink=”website” will change the button to use the “Event Website URL” (ie. a link to an external ticketing site) instead of the internal link to the event.
[ecs-list-events limit="2" buttonbg="#f77530" buttonfg="white" button="View Details"]
Late Night Party
Los Angeles, CA 90013 United States
Group by Month/Day
Adds a heading with the month before each event. Use groupby=”day” to group by day instead.
[ecs-list-events limit="4" groupby="month"]
January 2023
Kitten Adoption Day
San Jose, 95128 United States
Rock Concert
Portland, 97214 United States
February 2023
Rock Concert
Portland, 97214 United States
Filter Bar
Let your visitors select the events they want to see with the filter, on any page! See the Filter Bar page for more examples.
[ecs-list-events design="default" filterbar="true" pagination="true" filterorder="category, venue, state, country, tag, fromdate"]
Farmer’s Market
Lahaina, 96761 United States
Kitten Adoption Day
San Jose, 95128 United States
Rock Concert
Portland, 97214 United States
Rock Concert
Portland, 97214 United States