Events Grid View Template Add-on

The Events Grid View Template add-on for Event Espresso 4 will display your events in a grid format.

Need to buy a support license for the EE4 Events Grid View Template add-on?

https://eventespresso.com/product/eea-events-grid-view-template/

Installation for the Event Espresso 4 Events Grid Template 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 Grid View Template add-on for Event Espresso 4 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 for the EE4 Events Grid Template Add-on

You will not see any new WordPress administration menus for the add-on.

Usage for the Event Espresso 4 Events Grid Template Add-on

The Events Grid View Template add-on can be used by adding a shortcode to a WordPress page or post.

This is the default template and it displays events in a CSS grid structure, using the featured image for an event. Hovering over the image will display further information about an event. If the event does not have a featured image available, then it will use a default one.

The default image is a white image with black text that states “Image Coming Soon”. You can change this by setting the default_image parameter to an URL of an image.

• Show the template with all of your events

  [ESPRESSO_GRID_TEMPLATE]

• Show the template with all events and sort by ascending order (descending order is also available)

  [ESPRESSO_GRID_TEMPLATE sort=ASC]

• Show the template with a specific number (e.g. 15 events) of events

  [ESPRESSO_GRID_TEMPLATE limit=15]

• Show events on the template and include expired events

  [ESPRESSO_GRID_TEMPLATE show_expired=true]

• Show events from a specific category on the template

  [ESPRESSO_GRID_TEMPLATE category_slug=your-event-category-slug]

• Show events from a specific category on the calendar and include expired events

  [ESPRESSO_GRID_TEMPLATE category_slug=your-event-category-slug show_expired=true]

• Show events for a specific month

  [ESPRESSO_GRID_TEMPLATE month=august-2016]

• Display a default image when no featured image is set for an event

  [ESPRESSO_GRID_TEMPLATE default_image=http://example.com/wp-content/uploads/myimage.JPG]

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=start_date

These parameters (options) are available for the order_by shortcode parameter above. Multiple parameters should be separated by a comma.

id

start_date

end_date

event_name

venue_title

city

state

sort=ASC (set the sort order such as ASC (ascending) or DESC (descending); must be used with order_by parameter)

limit=15 (set a numeric limit on the number of events to show (e.g. 15))

show_expired=false (set to true to include expired events)

month=august-2016 (show events for a specific month)

category_slug=your-event-category-slug (retrieve events from a certain category, using the category slug)

default_image = when an event does not have a featured image, show this image URL instead (e.g. default_image=http://example.com/wp-content/uploads/myimage.JPG)

Link Text Shortcode Parameters

button_text="Your custom link text"

(this will override the default Register text; shown on hover)

alt_button_text="Your custom link text"

(this will override the default View Details link text; used when registration is turned off or an alternate URL is set for an event)

Troubleshooting the Event Espresso 4 Events Grid Template Add-on

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 can see event information but the styling looks broken.

This add-on requires wp_footer() to work correctly. WP footer is used by many popular WordPress plugins and is used to load resources in the footer of a page. Please ensure that wp_footer() is being used in your theme’s footer (typically footer.php theme template file).

Customizations for the Event Espresso 4 Events Grid Template Add-on

• You can display the available spaces in the EE4 grid template by copying the

  espresso-grid-template.template.php file to your active WordPress theme.

  Then you copy this code into the template just after the $datetime variable is defined:

if ( $datetime instanceof EE_Datetime ) {
    $limit = $datetime->get('DTT_reg_limit');
    $remain = $datetime->spaces_remaining( true );
    if ( $datetime->sold_out() ) {
        $remaintext = '<em>Sold out</em>';
	} 
	if ( $limit == EE_INF ) {
		$remaintext = '<em>A lot available</em>';
	} else {
    	$remaintext = sprintf( _nx(
    	    '%1$sOne space available%3$s', 
    	    '%1$sThere are %2$s spaces available%3$s', 
    	    $remain, 'event ticket info', 'event_espresso' ),
    	    '<em>', $remain, '</em>'
    	);
	}
}

• Visit the row on Git: https://gist.github.com/joshfeck/f19c050bc47682ff30b62202cfcde9d8#file-grid-php

  
  

  Then you add this code to the template to the spot where you want the tickets remaining message displayed:

  echo '<strong>' . $remaintext . '<strong>';