Locations format works in the same way as events, but the parameters are different.
#_LOCATIONDBFIELD{xx}displays the database value of the location property called ‘xx’ (with ‘xx’ being ‘location_name’, ‘location_id’, 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)#_LOCATIONNAMEindicates the location name (weird, huh?)- Other general parameters are
#_ADDRESS,#_CITY,#_STATE,#_ZIPor#_POSTAL,#_COUNTRY,#_LOCATIONDETAILS,#_MAPand#_LOCATIONIMAGE. #_LOCATIONPAGEURLreturns the URL of the location#_LOCATIONIMAGEURLreturns the URL of the image associated with the location#_LOCATIONIMAGETHUMBshows 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#_LOCATIONIMAGETHUMB{MyCustomSize}shows a thumbnail of the specified custom size of the image, instead of the whole image. The size is a custom size either known to wordpress or defined in your functions.php via the function add_image_size()#_LOCATIONIMAGETHUMBURLreturns the url to the thumbnail#_LOCATIONIMAGETHUMBURL{MyCustomSize}returns the url to the thumbnail of the specified custom size. The size is a custom size either known to wordpress or defined in your functions.php via the function add_image_size()#_LOCATIONIMAGETITLE,#_LOCATIONIMAGEDESCRIPTION,#_LOCATIONIMAGEALTand#_LOCATIONIMAGECAPTIONreturn the image title, descripton, alternative title and caption (the 4 wordpress properties you can set for an image)- Three tags allow the display of events taking place in the given location. Use
#_NEXTEVENTSto insert a list of the upcoming events,#_PASTEVENTSfor a list of past events,#_ALLEVENTSfor 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.:
#_PASTEVENTS{ASC}
#_NEXTEVENTS{DESC}
More complex ordering can be used too, see the eme_events shortcode for tips #_LOCATIONIDreturns the location ID#_LATITUDEand#_LONGITUDEreturn the langitude and longitude for the location#_DIRECTIONSdisplays a small form so you can ask for driving directions to an event/location#_LOCATIONCATEGORIESdisplays a comma-separated list of categories a location is in.
In case you want to show or hide specific categories, you can do so by specifying 2 optional filters to include/exclude categories. To be used like this:
#_LOCATIONCATEGORIES{1,3}{} ==> this will get all categories for the location, but only show cat 1 or 3
#_LOCATIONCATEGORIES{}{1,3} ==> this will get all categories for the location, but not show cat 1 or 3#_LOCATIONCATEGORIES_CSSdisplay a space-separated list of categories (so you can use them to do css stuff based on these names). Exclusions as in#_LOCATIONCATEGORIESare possible.#_LOCATIONCATEGORYDESCRIPTIONSreturns the different category descriptions for a location. The same optional filters to include/exclude categories as for #_LOCATIONCATEGORIES can also be used here.#_EDITLOCATIONLINKinserts a link to the edit location page, only if a user is logged in#_EDITLOCATIONURLjust shows the link to the edit location page (if a user is logged in), not clickable like#_EDITLOCATIONLINKis#_LOCATION_EXTERNAL_URLreturns the external url for a location#_LOCATION_EXTERNAL_REFreturns the external reference for a location (typically the facebook id)#_FIELD{xx}returns the answer (the tag, not the real value chosen for multi-option fields) for the extra form field with ID or name xx. For fields of type “file” it will return a list of clickable links.#_FIELDVALUE{xx}returns the answer (not the tag, but the real value chosen for multi-option fields) for the extra form field with ID or name xx. For fields of type “file” it will return the url to the file.#_FIELDNAME{xx}returns the name for the extra form field with ID or name xx
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=#_LOCATIONID (also location_id=this_location works, but not for paging/calendar/…). 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=#_LOCATIONID]