Events Planner Logo

Shortcodes

Events Planner Pro v1.1 introduces more arguments for narrowing down the event list by taxonomy, location, and/or organization.

Jump to shortcode troubleshooting

[events_planner]
  • This shortcode must reside on a Published page.

The minimum required shortcode. It will display the event list and is the events planner processor on the WP side. This will load the default event list or your customized theme template event list (see Theme Template Tags).

How to display the big calendar

[events_planner display="calendar"] (Pro 1.0+)

This shortcode will display the FullCalendar. You can choose your calendars colors and other attributes from WP Admin > Events Planner > Settings > Calendar Tab.

How to display a class list

[events_planner display="list-class"] 

This shortcode will display a list of available classes in tabular form ( example class list ). This list by itself is just a HTML table but it accepts a few attributes to make it more usable.

The following options are available as of 
Pro 2.0.6

1) display_cols: Use this to limit the columns displayed.  For example, [events_planner display="list-class" display_cols="title,date,time"] to only display the three columns.  Choices are:  title, day_of_week, date, time, category, location, instructor, available_spaces, regis_button
  • ​Do not include spaces between the comma separated choices.  The correct way will be "title,day_of_week,date,time"
  • You can arrange the order of this shortcode attribute to dictate the column order.  For example display_cols="regis_button,date,time,available_spaces" will display the table in that order.
2) ​datatable=1: Use this attribute to enable the datatable functionality on the class list.  This will add pagination, sorting, and live search functionality to the list.
3) datatable_sort_col=1: Use this attribute to sort the datatable when the class list is loaded. 

How to display only certain events in the event list by event id

[events_planner event_id="1,5,10"] (Pro 1.2.2+)
This shortcode will display the list of events based on the event id(s) indicated. The ids can be obtained by going to the Event List, in the Event ID column.  This shortcode will be expanded for use by the calendar in one of the upcoming version.

How to include events from certain categories only

[events_planner taxonomy="art,dance"] (Pro 1.1+)
This shortcode will display the list of events that belong to the comma delimited list of category slugs. The category slugs can be obtained by going to Events Planner > Event Categories > Slug column

How to include events from a specific location only

[events_planner location="123"] (Pro 1.1+)

This shortcode will display events that belong to the indicated location id. The id can be obtained from Events Planner > Event Locations > ID column. Only one id can be used at a time.

How to include events by specific organizations

[events_planner org="234"] (Pro 1.1+)

This shortcode will display events that belong to the indicated organization id. The id can be obtained from Events Planner > Organizations > ID column. Only one id can be used at a time.

How to combine shortcode attributes

[events_planner display="calendar" taxonomy="art" location="123" org="234"] (Pro 1.1+)

You can use a combination of all/any of the above to further narrow down your event list.

How to display an attendee list on a page

[events_planner display="attendee-list" event_id="123"] (Pro 1.2+)

This shortcode will list all the attendees for that event in a table.  You can select the fields that you would like to display by going into event edit > Settings meta box > Attendee List tab.


Troubleshooting

The page is displaying [events_planner] instead of the event list

  • Make sure that the plugin is active in WP Admin > Plugins list.
  • Edit the page, click on the Text tab (screenshot) and make sure that the shortcode is intact, without any span or p tags surrounding portions of the shortcode (screenshot)


The page is displaying missing "xxx.php" file

  • Please edit the page and remove all the double quotes from the shortcode.  So [events_planner display="calendar" location="123"] will become [events_planner display=calendar location=123]

 

Did you find this article helpful?