Knowledgebase

Check the knowledge base articles to get a jump start on your integrations, modifications, and all around user questions. If you don’t find what you’re looking for hit the forums.

Search Knowledgebase

Events Calendar PRO Widget Shortcodes Overview

In WordPress, widgets can typically be be placed in a sidebar or footer. Events Calendar Pro ships with a number of cool widgets, but sometimes you might want to use them on your site in locations other than a sidebar.

There are actually a couple of ways this can be achieved. One is to use a WordPress function called the_widget() in some custom coding in your theme or another plugin. Writing custom code like this is extremely flexible, but it also requires you to be comfortable writing in PHP—and it comes with the burden of maintaining that code through future upgrades.

A simpler alternative is to use a set of shortcodes provided by Events Calendar Pro that make it easy to embed the widgets within pages and posts; this is what we will look at in this article.

Mini Calendar Shortcode

Using the shortcode is as easy as adding the following piece of text within a page or post:

[tribe_mini_calendar]

Filters

Of course, the calendar widget also comes complete with an advanced set of filtering options and these can also be used with the shortcode. Here’s an example that looks for events in the party category:

[tribe_mini_calendar category="party"]

We can supply a list of several category or tag slugs (we just need to separate them with commas) and we can also use IDs by prefixing them with the # symbol:

[tribe_mini_calendar categories="party, black-tie" tag="#512"]

Note how we used categories (plural), there. Singular and plural forms are interchangeable – and the same goes for tags.

Event List Shortcode

To embed the advanced list widget, simply use the following shortcode:

[tribe_events_list]

Filters

The same slug and ID based filtering capabilities offered by the mini calendar shortcode can also be used by this one. Here’s an example:

[tribe_events_list tags="#1024, #2048, featured" category="tickets-available"]

Choose which information is displayed

Also, just like the advanced list widget itself, it is possible to specify extra information which should be displayed, such as the phone number and address of each venue:

[tribe_events_list phone="yes" address="yes"]

Here’s a complete list of those optional details:

  • venue
  • country
  • address
  • city
  • region
  • zip
  • phone
  • cost
  • organizer

Finally, you can specify the maximum number of events that should be listed:

[tribe_events_list limit="10"]

When you use the featured venue shortcode you must include at least one argument – the ID or slug of the venue that is being featured. Here’s an example using a slug:

[tribe_featured_venue slug="the-eiffel-tower"]

It is also possible to use the venue’s post ID:

[tribe_featured_venue id="4096"]

This shortcode optionally accepts one other argument – a limit for the number of events to list for the specified venue:

[tribe_featured_venue slug="the-whitehouse" limit="20"]

Will show the widget even if no upcoming events are scheduled for the venue:

[tribe_featured_venue slug="hollywood-bowl" hide_if_empty=false]

Countdown Shortcode

The countdown widget can be embedded with the following shortcode:

[tribe_event_countdown id="8192"]

Just like the featured venue shortcode, an ID or slug must be specified or it will not work. This shortcode optionally allows for two further arguments, the first of which is show seconds:

[tribe_event_countdown slug="new-year-2016" show_seconds="yes"]

This causes the number of seconds to be displayed. The other argument is the text to show once the event begins and the countdown is complete:

[tribe_event_countdown slug="joes-party" complete="Yee hah!"]

This Week Widget

The This Week widget can be embedded with the shortcode [tribe_this_week].

You can customize the plugin in a number of ways. For example, you can decide how many events per day to display:

[tribe_this_week count="2"]

By default the widget is laid out horizontally. If you want, you can do a vertical layout instead:

[tribe_this_week layout="vertical"]

A full list of the available shortcode options for the This Week widget is available here.

Common Arguments

Whichever shortcode you opt for, you can always make use of these additional arguments:

  • before_widget
  • before_title
  • title
  • after_title
  • after_widget

These are, hopefully, pretty self-explanatory and often will not be required when you use shortcodes-but they are there if you need them.


🔔 Are you looking for shortcodes to embed full calendar views? As of version 4.3 of Events Calendar Pro, you can use a shortcode called [tribe_events] to insert full calendar views anywhere on your site. If this sounds useful, read more about this shortcode here.