Location formatting

Locations format works in the same way as events, but the parameters are different.

  • #_LOCATIONFIELD{xx} displays the database value of the location property called ‘xx’ (with ‘xx’ being ‘location_name’, ‘location_od’, etc … see eme_locations.php, function eme_new_location) This can replace a number of more specific placeholders below (and future placeholders can be avoided like this too)
  • #_LOCATIONNAME indicates the location name (weird, huh?)
  • Other general parameters are #_ADDRESS, #_CITY,#_STATE, #_ZIP, #_COUNTRY, #_LOCATIONDETAILS, #_MAP and #_LOCATIONIMAGE. The #_LOCATIONIMAGE placeholder is also used in the location balloon for the event.
  • #_LOCATIONPAGEURL returns the URL of the location
  • #_LOCATIONIMAGEURL returns the URL of the image associated with the location
  • #_LOCATIONIMAGETHUMB shows a thumbnail of the featured image, instead of the whole image. The size can be choosen in the EME settings (panel ‘Other’), by default it is ‘thumbnail’ size
  • #_LOCATIONIMAGETHUMBURL returns the url to the thumbnail
  • Three tags allow the display of events taking place in the given location. Use #_NEXTEVENTS to insert a list of the upcoming events, #_PASTEVENTS for a list of past events, #_ALLEVENTS for a comprehensive list of all events. They also have an optional parameter so you can decide the sorting order of the events shown. Default is ASC, e.g.:
    More complex ordering can be used too, see the eme_events shortcode for tips
  • #_LOCATIONID returns the location ID
  • #_LATITUDE and #_LONGITUDE return the langitude and longitude for the location
  • #_DIRECTIONS displays a small form so you can ask for driving directions to an event/location
  • #_LOCATIONCATEGORIES displays a comma-separated list of categories a location is in
  • #_LOCATIONCATEGORIES_CSS display a space-separated list of categories (so you can use them to do css stuff based on these names).
  • #_LOCATIONCATEGORYDESCRIPTIONS returns the different category descriptions for a location
  • #_EDITLOCATIONLINK inserts a link to the edit location page, only if a user is logged in
  • #_EDITLOCATIONURL just shows the link to the edit location page (if a user is logged in), not clickable like #_EDITLOCATIONLINK is
  • #_LOCATION_EXTERNAL_REF returns the external reference for a location (typically the facebook id)

The aforementioned events list can be similarly formatted through the Default location event list format setting field. This field follows the conventions of events formatting.

You can also use the shortcode [eme_events] in the “single location format” or “location list format” setting, with the option location_id=this_location. E.g. this would show the future 5 events for the specific location when viewing that single location details:
[eme_events scope=future limit=5 location_id=this_location]