WordPress.org

How do I use it?

Once you have the plugin installed, edit a post, and use a shortcode of [bingMap] to create a Bing Map on the page.

If you just put [bingMap] on your page you'll get something, but it centers the map on Timbuktu, so you might want to change some attributes:

1. location - Specify where you want your map centered. Be as specific as you can, include the country code, an example would be "Birmingham, West Midlands, UK".
2. width - Define how wide you want your map to be. Default is 400px.
3. height - Define how high you want your map to be. Default is 400px.
4. title - Define a title for your map - displays above the map.
5. locationtitle - Override location title (dynamic map only)
6. locationlink - Set a URL for your title to link to (dynamic map only)
7. type - "static", or "dynamic". If you leave it blank, it will default to dynamic.
8. maptype - In static mode, options are: "Road", "Aerial" and "AerialWithLabels". In dynamic map mode, "Road", "Aerial", "AerialWithLabels" or "Birdseye". Default is "Road".
9. zoom - Define the zoom level. the higher the more zoomed in. If you are in Birdseye mode, zoom is quite restricted.
10. pp - Where to place a pushpin on your map. If you don't include a pp attribute, the center of the map will be used. Turn it off by setting pp to "false".
11. pp* - Add pushpins to your map. Use pp1="", pp2="" and so on. Bear in mind there is a limit to the number of pushpins you can actually have. If you're not in Birdseye mode, the map will automatically zoom out so all pushpins can display.
12. ppt* - Set the pushpin title (dynamic map only)
13. ppd* - Set the pushpin description (dynamic map only)
14. ppl* - Set the pushpin link (dynamic map only)

Here are a few examples:

• [bingMap location="Birmingham, West Midlands, UK" maptype="AerialWithLabels" zoom="15" description="Center of Birmingham, UK"]
• [bingMap type="static" location="Mexico City, Mexico" zoom="13"]
• [bingMap maptype="birdseye" location="Niagara Falls, Canada" width="650" height="300" pp="false"]
• [bingMap location="New York, USA" pp1="Philadelphia, USA"]

Why won't my maps show at all?

Have you signed up for a Bing Maps API key? And have you entered it in the settings page? If not, follow these steps:

1. Sign up for a Bing Maps API Key.
2. Enter it in the "Bing Maps for WordPress" settings page - it's under Settings in your WordPress Control Panel.

I've signed up, but I don't have an API key

You have to go to the create/view keys section on the Bing Maps API signup - just create a key and enter your blog details.

How do I change the style of the pushpin?

At the moment, you can't if you're using a dynamic Bing map. But if you're using a static map, add ";5" (5 is the icon style) to the end of your pp attribute, so something like: pp="Timbuktu;10"

For a full list of all icon styles for pushpins, check out http://msdn.microsoft.com/en-us/library/ff701719.aspx

How do I style the map on my blog?

All of the content is in a <div> container with a class of "bingMapsForWordpressContainer", the maps then sit inside a <div> with a class of "bingMapsForWordpress", so the structure looks a bit like this:

<div class="bingMapsForWordpressContainer">
    <div class="bingMapsForWordpress">
        <span class="bingMapsForWordpressTitle">Map Title</span>
        ... map content is here ...
    </div>
</div>

Reference any of these classes and IDs in your theme CSS and the maps will be styled - here is how to add a border to all your bing maps:

.bingMapsForWordpress{border:solid 2px red;}

And here is how to style just the title:

.bingMapsForWordpressTitle{font-weight:bold;}