Events Date Range Template Add-on

View quick links for this add-on –> 

---

Need to Buy a Support License for the Events Date Range Template Add-on?
https://eventespresso.com/product/date-range/

---

Installation

---

---

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 Date Range Template add-on for Event Espresso 3 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.

Usage

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

The Custom Template add-on must be installed and activated before you can use this template add-on. View documentation for the Custom Template add-on

• Show the template with all of your events
  [EVENT_CUSTOM_VIEW template_name=date-range]
• Show the template with all events and order by start date
  [EVENT_CUSTOM_VIEW template_name=date-range order_by=start_date]
• Show the template with all events and sort by ascending order (descending order is also available)
  [EVENT_CUSTOM_VIEW template_name=date-range sort=ASC order_by=start_date]
• Show the template with a specific number (e.g. 15 events) of events
  [EVENT_CUSTOM_VIEW template_name=date-range limit=15]
• Show events on the template and include expired events
  [EVENT_CUSTOM_VIEW template_name=date-range show_expired=true]
• Show events on the template and include secondary (waitlist) events
  [EVENT_CUSTOM_VIEW template_name=date-range show_secondary=true]
• Show events on the template and include deleted events
  [EVENT_CUSTOM_VIEW template_name=date-range show_deleted=true]
• Show events on the template and include expired events
  [EVENT_CUSTOM_VIEW template_name=date-range show_expired=true]
• Show events from a specific category on the template
  [ESPRESSO_EVENTS_TABLE_TEMPLATE template_name=date-range category_identifier=your-event-category-identifier]
• Show events from a specific category on the calendar and include expired events
  [EVENT_CUSTOM_VIEW template_name=date-range category_identifier=your-event-category-identifier show_expired=true]
• Show events from a specific month
  [EVENT_CUSTOM_VIEW template_name=date-range month=nameofmonth]

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=false (order events by start date instead of title; enable by setting to start_date)
sort=ASC (set the sort order such as ASC (ascending) or DESC (descending); must be used with order_by parameter)
limit=false (set a numeric limit on the number of events to show (e.g. 15))
show_expired=false (set to true to include expired events)
show_secondary=false (set to true to include waitlist events)
show_recurrence=false (set to true to include recurring events)
show_expired=false (set to true to include expired events)
recurrence_only=false (set to true to show only recurring events)
max_day=false (show events over a period of time starting from today; uses event start date)
event_category_id=false (retrieve events from a certain category, using the event category which is a numeric value such as 123)
category_identifier=false (retrieve events from a certain category, using the event category which is a alphanumeric value such as featured-events-12345)
user_id=false (show events from a specific WordPress user; uses the numeric ID of a WP user)

Events Date Range Shortcode Parameters

The following parameters are specific for this template add-on and are only available for this template add-on.

user_select=false (set to true to disable date filter)
start_date=false (specify a start date in a year-month-day format (e.g. January 1, 2015 would be 2015-01-01)
end_date=false (specify a start date in a year-month-day format (e.g. January 31, 2015 would be 2015-01-31)
current_month=false (set to true to show events for the current month)
set_month=false (specify the month to show events from (e.g. January would be 01 and December would be 12))

Note: the set_month parameter does not have an option to show events for a specific year.

Troubleshooting

The plugin will not install. Can you help?
Are you running the latest version of Event Espresso 3?

My template will not display. I see a shortcode on my page.
Is the Custom Template add-on installed and activated?

Customizations

• None at this time. Check back soon!

---