The Events Table View Template add-on for Event Espresso 4 will display information about your events in a table format.
View quick links for this add-on –>
This add-on is a plugin for WordPress and can be installed through your WP dashboard (WP-admin).
Download the latest version of the Events Table View Template add-on from your Event Espresso account.
Then login to your WordPress dashboard (WP-admin) and go to Plugins. Next, click on Add New –> Upload and browse to the plugin on your computer. Then select the zip file and begin the upload process. Wait for the plugin to upload and then click on Activate.
Setup and Configuration
You will not see any new WordPress administration menus for the add-on.
The Events Table View Template add-on can be used by adding a shortcode to a WordPress page or post.
- Show the template with all of your events
- Show the template with all events and order by start date
- Show the template with all events and sort by ascending order (descending order is also available)
- Show the template with a specific number (e.g. 25 events) of total events
- Show the template with a certain amount of events (e.g. 15 events) before paginating
- Show events on the template and include expired events
- Show events from a specific category on the template
- Show events from a specific category on the template and include expired events
[ESPRESSO_EVENTS_TABLE_TEMPLATE category_slug=your-event-category-slug show_expired=true]
- Show events for a specific month
- Show all of the date times
- Remove the venue column
Standard Shortcode Parameters
The following parameters are available for this add-on. You can see examples of these parameters in use in the section above.
- order_by=event_name (order events by title instead of start date by using event_name; set to start date by using start_date) other accepted parameters include: id, venue_title, end_date
- sort=ASC (set the sort order such as ASC (ascending) or DESC (descending); must be used with order_by parameter)
- limit=25 (set a numeric limit on the number of events to show (e.g. 25))
- table_pages=15 (set a numeric limit on the number of events to show before paginating (e.g. 15))
- show_expired=false (set to true to include expired events)
- month=january-2016 (show events for January 2016)
- category_slug=your-category-slug (retrieve events from a certain category, using the category slug)
- category_filter=false (set to false to remove the category filter)
- show_all_datetimes=true (show all the date times instead of just one)
- show_venues=false (set to false to remove the venue column)
Table Style Shortcode Parameters
We’ve included the FooTable jQuery scripts in this add-on to help make your tables look great.
- footable=false (disables FooTable and all parameters below)
- table_search=false (set to false to turn off search)
- category_filter=false (set to false to turn off the category filter)
- table_style=standalone (alternate styles: metro)
- table_sort=false (set to false to disable FooTable sorting)
- table_striping=false (set to false to turn off striping as a style)
- table_paging=false (set to false to hide pagination)
- table_pages=10 (specify the maximum number of events per page),
(creates a table with two columns and a toggle to expand the row)
Here is an example of how to use the toggle template:
Link Text Shortcode Parameters
reg_button_text='Your custom link text'
(this will override the default Register text)
alt_button_text='Your custom link text'
(this will override the default View Details link text)
sold_out_button_text='Your custom link text'
(this will override the default Sold Out link text)
The plugin will not activate. Can you help?
Are you running a current version of Event Espresso 4? This add-on needs at least version 4.4 to activate.
Where is the menu screen for this add-on?
This plugin does not create any new menus in the WordPress admin screen. It can be used by adding a shortcode to a WordPress post or post. Please see the documentation in the usage section on this page.
I can’t exclude categories using the category parameter.
The parameters for this add-on do not currently support excluding certain categories or using multiple categories at once (an array of categories).
I’m still using Event Espresso 4.3. Can I still use this add-on?
We recommend updating to the current version of Event Espresso. If you cannot update due to PHP 5.2, then you’ll need to switch out a template in this add-on.
Replace the EES_Espresso_Events_Table_Template.shortcode.php with this older version.
The Events Table View Template Add-on will first check in your active WordPress theme when it looks for its templates. For example, you can copy the
template from the plugin’s /templates/ folder into your WordPress theme. Then you can make customizations to your copy, and that template will be used when the [ESPRESSO_EVENTS_TABLE_TEMPLATE] shortcode is parsed.
Here is an example that shows how to customize the template:
Please be sure to set up a child theme before you begin to make theme modifications. When you keep your modifications within the child theme, it will preserve your changes should the theme need to be updated in the future.