Title: Placemarks
Author: Nagmay
Published: <strong>October 24, 2013</strong>
Last modified: October 13, 2019

---

Search plugins

![](https://ps.w.org/placemarks/assets/banner-772x250.png?rev=1625337)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://ps.w.org/placemarks/assets/icon-256x256.png?rev=1625338)

# Placemarks

 By [Nagmay](https://profiles.wordpress.org/gabrielmcgovern/)

[Download](https://downloads.wordpress.org/plugin/placemarks.zip)

 * [Details](https://test.wordpress.org/plugins/placemarks/#description)
 * [Reviews](https://test.wordpress.org/plugins/placemarks/#reviews)
 *  [Installation](https://test.wordpress.org/plugins/placemarks/#installation)
 * [Development](https://test.wordpress.org/plugins/placemarks/#developers)

 [Support](https://wordpress.org/support/plugin/placemarks/)

## Description

Create maps, drop pins, and so much more!

This plugin adds a new `placemark` post type that allows author to create and update
map content.

The author interface includes:

**Place**

 * An interactive map to drop and move pins
 * A way to edit GPS by hand and make use of the geolocation on your mobile phone
 * An editable set of drop-down lists for picking locations
 * An alternative text area to describe the location

**Mark**

 * An editable drop-down of marker types and associated icons
 * An optional title
 * Optional bubble text
 * Optional link

** Optional **
 The locations and marker types can be set by an administrator. This
allow the you to:

 * Customize the types of markers includeing the image
 * Set a custom taxonomy for locations, allowing authors to zoom in to campus, building,
   floor, etc…
 * Add image overlays to each location, including floorplans.

To embed the maps a simple short code is used. You can limit which type of placemarks
will show up on each map.

A basic API allows you to pull out the data for other mapping systems.

## Screenshots

 * [[
 * Demo of how the plugin works with custom locations and marker images
 * [[
 * How a map might look on a post page
 * [[
 * Creating a new ‘Placemark’
 * [[
 * With the settings you can customize the types of placemarks, locations and icons
   available.
 * [[
 * And then we embed a map!

## Installation

 1. Upload the `placemarks` folder to the `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Create some new placemarks
 4. Include the shortcode [placemarks] on any page or post

## FAQ

  What can the shortcode do?

[placemarks types=”list of type names” ids=”list of placemarker ids” lat=# lng =#
zoom=# width=”” height=”” alt=true/false]

Everything after `placemark` is optional:

 * `types`: String. List of types slugs to include on the map “type, foo bar” (shows
   all by default)
 * `locations`: String. List of location slugs to include on the map “location-1,
   location-2”. can be used with types to further limit.
 * `ids`: String. List of placemarker ids – handy if you only want 1, or 2. Can 
   be used with types and locatiosn to help limit.
 * `lat`: Number. Use lat+lng+zoom to choose an initial map view (defaults to show
   all pins)
 * `lng`: Number. Use lat+lng+zoom to choose an initial map view (defaults to show
   all pins)
 * `zoom`: Number. Use lat+lng+zoom to choose an initial map view (defaults to show
   all pins)
 * `width`: String. Change the width of the map (default ‘100%’)
 * `height`: String. Change the height of the map (default ‘400px’)
 * `alt`: True/False. A text list of all the markers shows under th map by default.
   This can be used to turn it off.

  How do I edit the locations and types drop-downs?

Go to `Settings` -> `Placemarks`. Here you can use JSON to create custom lists. 
For example:

**Marker Types (JSON)**: `name` and `src` are required

    ```
    { "types": [
        {"name":"Default", "src":"http://www.yoursite.com/default.png"},
        {"name":"Hot", "src":"http://www.yoursite.com/hot.png"}
        ]
    }
    ```

**Locations (JSON)**: `name` and `slug` are required. slug should always be unique

    ```
    {"locations": [
        {"name":"Oregon","slug":"or"},
        {"name":"Washington","slug":"wa"}
        ]
    }
    ```

Optionally, you can also include: `lat`, `lng`, `zoom`. Together, these control 
the map when selected in the admin interface.

    ```
    {"locations": [
        {"name":"Oregon","slug":"or","lat":45.563282,"lng":-122.673457,"zoom":17},
        {"name":"Washington","slug":"wa","lat":45.563838,"lng":-122.672342,"zoom":19}
        ]
    }
    ```

Each location can also include `locations`. This can be used to create hierarchies
of select lists!

    ```
    {"locations": [
        {"name":"Oregon","slug":"or", "locations":[
            {"name":"Portland","slug":"pdx"},
            {"name":"Bend","slug":"bend"}
            ]
        },
        {"name":"Washington","slug":"wa", "locations":[
            {"name":"Seattle","slug":"sea"}
            ]
        }
        ]
    }
    ```

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Placemarks” is open source software. The following people have contributed to this
plugin.

Contributors

 *   [ Nagmay ](https://profiles.wordpress.org/gabrielmcgovern/)

[Translate “Placemarks” into your language.](https://translate.wordpress.org/projects/wp-plugins/placemarks)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/placemarks/), check
out the [SVN repository](https://plugins.svn.wordpress.org/placemarks/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/placemarks/) by 
[RSS](https://plugins.trac.wordpress.org/log/placemarks/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 3.02

 * Disabled error reporting display
 * Updated calls to API using rest_url() – to work with non-standard WordPress installs

#### 3.01

 * Multiple maps on a single page without conflict

#### 3.00

 * Reformat code using the WP Boilerplate format
 * Switched from Google Maps to OpenStreetMaps
 * New network settings available in multisite
 * Uses the WordPress REST API (discontinue old api)
 * Fixed xss vulnerability in old api (by removing it 🙂
 * Admin data pulled direclty from api

#### 2.1.0

 * Remove/hide preview button
 * Remove “view” message on update
 * Shortcode: allow “ids” to only show 1 or 2
 * Update icon on map from default
 * Add slug to location
 * Rename script/style files to make sence
 * Create data export page
 * Limit by location slug in shortcode

#### 2.0.3

 * Basic functions in place
 * All placemarks: Show location names instead of slugs
 * Embedded map: Add “edit” link to markers displayed on map when user is logged
   in for quick editing!

#### 2.0.2

 * Bugfix: Only enqueue js on placemark admin pages
 * Settings: Allow locations in locations (via JSON)

#### 2.0.1

 * Bug fix: 2.0.0 was missing function files
 * Shortcode: set defaults for gps and zoom

#### 2.0.0

 * Feature: Setting can now be changed at the network level
 * Feature: Basic API for pulling data: /placemarks-data/

#### 1.1.0

 * Bug fix: Lots of bug fixes
 * Update: Marker types should now include slug. Allows you to change the name without
   breaking everything. Will work fine without slug for now.
 * Update: All placemarks list view updated.
 * Feature: Icon on map updates as you change type.
 * Feature: Allow for overlay images in Locations JSON!
 * Feature: Data page /placemarks-data/ to act as api for external maps

#### 1.0.3

 * Bug fix: Only set up map if map_canvas is found on page

#### 1.0.2

 * Bug fix: Fixed comment error on pages with shortcode

#### 1.0.1

 * Bug fix: Only enqueue js on placemark admin pages
 * Bug fix: Fix error on pages with comments
 * Feature: Add edit link to each placemark on map

#### 1.0.0

 * First version to be released.

## Meta

 *  Version **3.0.1**
 *  Last updated **6 years ago**
 *  Active installations **20+**
 *  WordPress version ** 3.0 or higher **
 *  Tested up to **5.2.24**
 *  Language
 * [English (US)](https://wordpress.org/plugins/placemarks/)
 * Tags
 * [map](https://test.wordpress.org/plugins/tags/map/)[maps](https://test.wordpress.org/plugins/tags/maps/)
   [placemark](https://test.wordpress.org/plugins/tags/placemark/)[placemarks](https://test.wordpress.org/plugins/tags/placemarks/)
   [places](https://test.wordpress.org/plugins/tags/places/)
 *  [Advanced View](https://test.wordpress.org/plugins/placemarks/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/placemarks/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/placemarks/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/placemarks/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/placemarks/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/placemarks/reviews/?filter=1)

[Add my review](https://wordpress.org/support/plugin/placemarks/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/placemarks/reviews/)

## Contributors

 *   [ Nagmay ](https://profiles.wordpress.org/gabrielmcgovern/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/placemarks/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](http://www.dreamhost.com/donate.cgi?id=17157)