Plugin Directory

Test out the new Plugin Directory and let us know what you think.
!This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

WP Supersized Image Map

This Plugin adds an image map to Supersized. It ables you to resize the browser and keep the spots in place.

It's easy to create an image map, right? But, what you do when you want your background to be full screen? And you need to set some images above.

Step 1: Get jQuery (can be done here: http://jquery.com). Now a days you use it to everything, we can't live without it.

Step 2: If you Google it, you will find some scripts that will help you define a full screen background. I used supersized, that can be download here: http://www.buildinternet.com/project/supersized/

Why supersized? In my case, I need my background to be full screen and to act like a slideshow.

Step 2.2: Important options. Set "autoplay: 0", the image only changes on button click. Set "horizontal_center: 1", to set the image at the center of the browser. Set a title in a descending order.

I set a title to know what hotspots I need to show.

[js] jQuery(function($){


    autoplay: 0, //Only plays on button click
    horizontal_center: 1, //Defines the image at the center

  // Functionality
    slide_interval: 3000,       // Length between transitions
    transition: 1,          // 0-None, 1-Fade, 2-Slide Top, 3-Slide Right, 4-Slide Bottom, 5-Slide Left, 6-Carousel Right, 7-Carousel Left
    transition_speed: 3000,     // Speed of transition

    // Components                           
    slide_links: 'blank',   // Individual links for each slide (Options: false, 'number', 'name', 'blank')
    slides: [           // Slideshow Images
    {image: 'images/backgrounds/Frato-795531.jpg', title: 'hotspots_14', thumb: 'images/thumb/ambi_795531.jpg'},
    {image: 'images/backgrounds/Frato-794891.jpg', title: 'hotspots_13', thumb: 'images/thumb/ambi_794891.jpg'} 

  // Theme Options             
    progress_bar:   0,          // Timer for each slide                         
    mouse_scrub: 0


}); [/js]

You can see more options on the plugin page.

Optinal Step 2.3: As you can see, I set some thumbnails with mouse event. To do this, you need to set the "thumb:" options of the supersized configurations.

Then you set the HTML. [html]


And the css. I set it on the supersized.shutter.css


thumb-tray-wrapper{width:452px; height:60px; position:absolute; text-align:center; bottom:58px!important;

left:50%; z-index:3000; padding:0 0 0 32px; margin:0 0 0 -250px;}

thumb-tray{overflow:hidden; width:427px; height:59px; padding:0;}

ul#thumb-list{width:1500px !important; display:inline-block; list-style:none; position:relative; left:0px; padding:0 0px;}

ul#thumb-list li{list-style:none; background:none; display:inline; width:91px; height:46px; overflow:hidden; float:left; margin:7px 7px; padding:0; display:block !important;}

thumb-back{left:0; background: url('../img/btn_play.png') no-repeat 0 0;} thumb-forward{right:0; background:url('../img/btn_play.png') no-repeat 100% 0;}


Step 3: You need to do some changes in supersized.shutter.js.

Befone any image transition, we hide the hotspots, so the user don't see it moving.

[js] supersized.shutter.js beforeAnimation : function(direction){

if (api.options.progress_bar && !vars.is_paused) $(vars.progress_bar).stop().animate({left : -$(window).width()}, 0 );

/* Update Fields ----------------------------*/ // Update slide caption if ($(vars.slide_caption).length){ (api.getField('title')) ? $(vars.slide_caption).html(api.getField('title')) : $(vars.slide_caption).html(''); }

// Update slide number if (vars.slide_current.length){

  $(vars.slide_current).html(vars.current_slide + 1);

  $(".image_map").css("display", "none");
  $(".image_map").css("visibility", "hidden");

} [/js]

Step 4 This step is where the magic happens.

What I do is to get the width, height, top and left of the image. Then, I calculate the center of the image. Transform the negative numbers to positive. Move all the hotspots to the center of the image. Then get the distance from the center defined in percentage in the html link, like «top="1%"» and «left="28%"».

To calculate the distance, I set the percentage from the center and calculate that percentage in pixels. Example: Image width = 400px Image height = 400px Image center vertical = 200px Image center horizontal = 200px

Horizontal Percentage Distance from center = 20% Horizontal Distance from center in pixels = Image width - Percentage Distance = 400px-20% = 80px

So, the hotspots is positioned 80px from the center.

After that, you need to see if the hotspot is position to the left or to the right. To the left you set a negative percentage, to the right, you set it positive.

At this point all the hotspots are at the center of the image. Then you position all the hotpots assigning the calculated value to the margin.

Example: Horizontal Distance from center in pixels = 80px Margin-left: -80px

You get the current image title to know what hotspots to show and it is good to go.

Step 4.1: Set up the hotspots. As I said above, I define the top and the left.



[css] body, html{margin:0; padding:0; overflow:hidden;} .image_map{width:100%; height:100%; z-index:2000; position:absolute; display:none;} .image_map a{position:absolute; z-index:9000; width:20px; height:20px; background:url('../images/icons/icon_yellow.png') center center no-repeat;} [/css]

Step 4.2 Still in the supersized.shutter.js file. After the image transition you calculate the sizes, positions, move and show the right hotspots.

[js] supersized.shutter.js /* After Slide Transition ----------------------------*/ afterAnimation : function(){ if (api.options.progress_bar && !vars.is_paused) theme.progressBar(); // Start progress bar

var imageId = "#supersized .activeslide img";     

//Image style
var style = $(imageId).attr("style");
var partsArray = style.split(':');

var w = 0; //width
var h = 0; //height
var t = 0; //top
var l = 0; //left

var temp = 0;
var partsStyle = style.split(' ');

for(var i=0; i<partsStyle.length; i++) {

  temp = parseInt(partsStyle[i+1]);

  if(partsStyle[i]=="width:") w = temp; 
  else if(partsStyle[i]=="height:") h = temp; 
  else if(partsStyle[i]=="top:") t = temp;
  else if(partsStyle[i]=="left:") l = temp; 


//Calculate center
var dif_w = Math.round(w / 2);
var dif_h = Math.round(h / 2);

//Negative to positive
var newL = Math.abs(l);
var newDifW = dif_w - newL;

var newT = Math.abs(t);
var newDifH = dif_h - newT;

//Move to center
$('.image_map a').css('left', function(i, v) { return newDifW+"px"; });
$('.image_map a').css('top', function(i, v) { return newDifH+"px"; });     

//Get top and left
$('.image_map a').css('margin-top', function(i, v) {

  var marginTop = $(this).attr('top');

  var newMTP = Math.abs(parseInt(marginTop));

  var newMT = h * (newMTP / 100);

  if(parseInt(marginTop) > 0) return newMT+"px";
  else return "-"+newMT+"px";   


$('.image_map a').css('margin-left', function(i, v) {

  var marginLeft = $(this).attr('left');

  var newMLP = Math.abs(parseInt(marginLeft));

  var newML = w * (newMLP / 100);

  if(parseInt(marginLeft) > 0) return newML+"px";
  else return "-"+newML+"px";


var next_map = "#" + api.getField('title');
$(next_map).css("display", "inline");
$(next_map).css("visibility", "visible");


}, [/js]

Step 5: When the browser is resized the hotspots are hidden and the "show hotspots" button changes. So, when the user clicks to show the hotspots, they are positioned to the right place.

[js] $(window).resize(function() { $('#show').html("show hotspots"); $('#show').addClass("show"); $('#show').removeClass("hide"); $(".image_map").css("display", "none"); $(".image_map").css("visibility", "visible");
}); [/js]

Step 5.2: Set a button to show or hide the hotspots. [js] $('#show').click(function() { var state = $(this).attr('class'); if(state=="show") { repositionHotspots(); //function that position the hotspots $(this).html("hide hotspots"); $(this).addClass("hide"); $(this).removeClass("show"); var next_map = "#" + api.getField('title'); //What hotpots will be show next - This fucntion comes with supersized
$(next_map).css("display", "inline"); $(next_map).css("visibility", "visible");
} else {
$(this).html("show hotspots"); $(this).addClass("show"); $(this).removeClass("hide"); $(".image_map").css("display", "none"); $(".image_map").css("visibility", "hidden"); } }); [/js]

Opticional Steps:

This steps were made so the user have a better experience when surfing the website.

Show a tooltip with the name of the product. From here: http://docs.jquery.com/Plugins/Tooltip [js] $('.image_map a').tooltip({ track: true, delay: 0, showURL: false, showBody: " - ", fade: 250 }); [/js]

Open a colorbox popup when click on the hotspot. From here: http://colorpowered.com/colorbox [js] $(".image_map a").colorbox({ iframe:true, scrolling:false, innerWidth:"750px", innerHeight:"450px" }); [/js]

Requires: 3.0 or higher
Compatible up to: 3.3.2
Last Updated: 4 years ago
Active Installs: Less than 10


3 out of 5 stars


Got something to say? Need help?


Not enough data

0 people say it works.
0 people say it's broken.