To upload a map, make sure you're logged in, go to the "Map" tab on your campaign or a place page and then upload your map image.
To add a pin, make sure you're logged in and click on your map (only GM's and Assistant GM's can add pins). A dialog will pop up. Enter the name of the place you want pinned (has auto-complete). Hit "Create" and the pin will be added to your map where you clicked on it.
If you add a second pin with the same place name, it will move the previous pin to the new location.
To remove a pin, click on it. A summary of that place will swipe in on the right of the map. Click on the "Unpin" button on that summary.
Design principles
Easy/intuitive
Minimal functionality to be useful
Works with both mobile and desktop platforms
Requirements
A user's campaign and any place within that campaign can have a map
To see the map, click on the Map tab from a Campaign or Place page
Can see pins attached to the map
Pins represent other places within the campaign
Any place except the current place can be assigned to a pin, even if that place is not a neighbor or sub-region. This is to keep things simple.
A map can have any number of pins, including zero.
A place can be pinned to any number of maps of other places
All pins are the same color and the user cannot change the color.
Pins do not have tooltips. This is to make the map feature mobile-device friendly.
Only a GM or Assistant GM can edit a map
User with edit rights clicks on the map background causes a "Pin" dialog to pop-up
Any other user clicks on map background, nothing happens
Pin Dialog
Title: "Pin"
Fields
Place with auto-complete
Buttons
Cancel
Create Pin
Pins cannot be moved. You must create a new pin with the same place name. This is because dragging on mobile-devices doesn't really work.
Clicking on a pin causes summary to sweep in on side. You can then click on the "More" link to go to that place.
Pin summary on right has "Unpin" button, which only works for users with edit rights.