Placemarks

1. 

   Demo of how the plugin works with custom locations and marker images

2. 

   How a map might look on a post page

3. 

   Creating a new 'Placemark'

4. 

   With the settings you can customize the types of placemarks, locations and icons available.

5. 

   And then we embed a map!

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"}
        ]
    }
    ]
}

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.