Shortcode Generator

The My Calendar Submissions Form shortcode generator

The shortcode generator allows you to generate a heavily customized form with My Calendar’s event fields. You can use the up and down arrows to modify the order of fields, customize labels, set default category or location, and choose which fields are included.

Some types of fields don’t support custom labeling through shortcodes. These fields (registration and recurring settings) are compound fields, and the section of the form you enable with that setting includes multiple form inputs, rather than just a single input.

Shortcodes

My Calendar Pro includes six shortcodes:

[advanced_search]

Outputs the advanced search form.

Attributes:

  • date – ‘false’ to exclude date parameters from search.
  • author – ‘false’ to exclude author parameters from search.
  • host – ‘false’ to exclude author parameters from search.
  • category – ‘false’ to exclude categories from search.
  • location – ‘false’ to exclude locations from search.
  • home – integer ID attribute used to generate the target URL for searches (used to render searches on a page other than the current page.)

API Sources

[my_calendar_api_sources]

When you’re using the REST API to allow external sites to send events to your calendar, this shortcode is used to output a list of external sites that are registered to send events. The list contains buttons for each source and is used along with the main calendar widget to enable and disable events from a given source on the calendar.

Attributes: none.

Submit Payment

[submit_payment]

When payments are enabled, the ability to purchase payment keys are automatically added at the top of the Event Submission form. The submit payment shortcode provides a payment mechanism that’s independent of the event submissions form, so that you can invite users to purchase submission keys in a more compact context.

Attributes: none.

Geolocate

[geolocate]

Generates a map of all My Calendar locations within a given distance of a specified latitude and longitude. Requires loading a geolocation database (not included in standard package due to size, but available on demand.), and enabling via filter.

Attributes:

  • latitude – Centering latitude. If not provided, the map will attempt to source from the user’s IP.
  • longitude – Centering longitude. As above.
  • radius – Radius to search within in kilometers.
  • limit – Maximum number of locations to return.

Submit Event

[submit_event]

Form to submit events to the calendar. This is a highly complicated shortcode, and using the shortcode generator is the recommended way to build these shortcodes.

Attributes:

  • fields – Comma separated list of field IDs to include in form.
  • categories – 1 to include categories form, 0 to exclude.
  • locations – ‘either’ (select form and enter new location), ‘enter’ (new locations only), ‘none’, or ‘choose’ (select an existing location).
  • category – Integer for the default category a form should submit.
  • location – Integer for the default location a form should use.
  • location_fields – Comma separated list of location field IDs to include in form.
  • form_id – Unique ID to represent this form.

Submitted Events

[submitted_events]

A table of events that the current logged-in user is allowed to edit.

Attributes

  • orderby – Default ordering. Table is sortable by the user, so this is just how it appears by default.
  • order – ‘desc’ or ‘asc’
  • past – Include events from the past. Defaults to ‘false’; ‘true’ to include.