[eme_filterform]

[eme_filterform]

Creates a form with drop-downs for categories, locations, cities, countries, weeks, months (configurable in the settings). This shortcode is only usefull if used on the same page as the shortcodes [eme_events], [eme_locations], [eme_calendar] or [eme_locations_map] (because it is in fact these shortcodes that interpret the filter submit).

Accepts the following parameters:

• multiple: 0 or 1. If 1, you can select multiple categories, locations or towns (not weeks, years). Default: 0.
• multisize: the size of the drop-down window if multiple. Default: 5.
• scope_count: the number of future weeks/months to be shown. Default: 12.
• submit: the text on the submit button. Default: Submit.
• category: can contain a comma separated list of categories you want the category selection to be limited to
• notcategory: can contain a comma separated list of categories you want excluded from the category selection box
• template_id (optional): use a predefined format template for the filter form, instead of the default settings configured. See the doc concerning placeholders for the filter form for the placeholders you can use. If you leave this empty, the default setting defined in the EME setting called ‘Default event list filtering format’ will be used.
• filter_type (optional): Can be 'events' or 'locations'. If present, the fields shown will restrict themselves to the possible values of the matching events/locations
• Several options to force a value for filter fields if the corresponding filter is present:
  'default_scope'
  'default_location'
  'default_city'
  'default_state'
  'default_country'
  'default_category'
  'default_author'
  'default_contact'
  'default_field_XXX' (with XXX a custom formfield ID or unique name)
  If one of these is present and the corresponding filter exists, it will become read-only with the value mentioned as fixed and applied filter.

Example (to be used as content on a regular wp page):
[eme_filterform scope_count=5]
[eme_events]

Or to force the filter for a custom field TEST to "AAA" for locations and limit all other choices to existing ones matching the locations:

[eme_filterform filter_type='locations' default_field_TEST='AAA']
[eme_locations]