2011
06.30
UPDATE: WP Supersized is now at version 3.0.2. It now allows the use of images from NextGEN Gallery, the WordPress Media Gallery, your own choice of directory within the wp-content folder, or a list of slides defined in an xml file (for advanced users). See the changelog.
PayPal — The safer, easier way to pay online.

After my previous tutorials about the integration of Supersized 3.1 and 3.1.x in WordPress, I had started to write an updated version of those tutorials. Until I realised that I should really use my understanding of this integration of Supersized in WordPress in a better way.
Why not write a plugin that would seamlessly integrate Supersized in WordPress, without the user having to modify his templates ?
I quickly read a book about WordPress plugins and I analyzed several plugins that I was using on my WordPress install. Armed with this information and my fresh and limited PHP knowledge, I decided to take up the challenge and write a WordPress plugin.
After several evenings of hard work, here is the result: WP Supersized.

Download WP Supersized here

WP Supersized gives you the ability to easily integrate the Supersized jquery extension in the pages/posts you want.

I am not the developer of the Supersized jquery extension itself. It was written by Sam Dunn. My plugin only integrates it into your theme and gives you easy access to many options for displaying this full screen resizeable slideshow background where you want on your website or blog.

I have now moved all the FAQ and other details to the WordPress plugins repository. Much easier to maintain. So, please go to the FAQ for more details.

Do not hesitate to comment this post if you need help or if you want to say how good my plugin is ;-)

558 comments so far

Add Your Comment
  1. Hello there,

    great plugin you have created. I have one question. When I resize the browser the image gets cut off at the top. Is there a way that I can position the images so when I shrink the browser the image doesn’t get cut off on the top? I’ve tried the ‘Always fit option’ but that gives me a gap on the sides of the images. Thanks in advance :)

    • Alistair,
      If you update to version 3.1.5, you will be able to use the option ‘Always fill’ which does what you are looking for.

  2. Artisteer v4 just made a mess on your beautiful plugin…
    I have a site that works perfectly with the template made with Artisteer v3.
    When I jump to Artisteer 4 the plugin just stop working.
    http://www.digitalbla.com/Teste/LeoDale

    • Sorry, I am not familiar with Artisteer. There has probably been some modifications in Artisteer 4 that introduced some conflicts with the plugin. Are other plugins working correctly ? It could be some jQuery conflict.

  3. Plugin rocks!

    I’m having trouble getting the thumbnail footer to show up though. I’ve turned all the options on under the components tab, and I still see nothing. Any ideas?

    Website: http://test.theflyphoto.com

    • Matt,
      It could be that the footer is hidden behind parts of your current theme. Please make sure that your theme has a transparent footer (if it has any).

  4. Hi, great plugin!

    I was just wondering if it is possible to make the slideshow appear above all my content rather than in the background?

    cheers

    • Mark,
      You need to modify the css files to have the z-index of the supersized elements at a higher level (for example, change the z-index of #supersized to 99 instead of -999. You will also need to adapt the z-index of the other elements of supersized of course.

  5. Install on a Multisite is giving me problems, which weirdly wasn’t the case before, on an older installation… The problem is the reference to the source directory.
    I don’t understand why I didn’t have this problem before… Is there any chance of downloading the previous version, and see if that solves the problem?

    I have been looking at the file WPSupersized.php, and specifically the bit about setting the content directory:
    /*
    *
    * build_wpcontent_dir()
    * Builds the correct wp-content directory path
    * Returns $wpContentDir
    *
    */

    public static function build_wpcontent_dir(){
    $home_url = home_url();
    if (defined(‘ICL_SITEPRESS_VERSION’)) // checks for the presence of WPML
    $home_url = self::clean_wpml_home_url();

    $wordpressDir = ltrim(str_replace($home_url,”,site_url()),”/”); // removes the root url and the leading slash if present
    if ($wordpressDir !== ”) $slash=”/”;
    else $slash=”;
    $wpContentDir = $wordpressDir.$slash.’wp-content’;
    return $wpContentDir;
    }

    As I am not a php-coder, I don’t know how to adjust this for multisite usage.
    My Supersized folder in my previous installation was in “/wp-content/blogs.dir/7/files/Supersized/”. How can I tell WP Supersized to go to the root directory, and the to the blogs.dir?
    Under multisite installation there is no factual “mydomain.com/myfirstsite/”; there is only “mydomain.com/wp-content/blogs.dir”

    Thanks for your ideas…!

    • Aernout,
      There is indeed no reason why it would have worked before and not now. Nothing has changed to the way the content folder is used in recent updates.
      Could you please try updating to the latest version and reset your options. This could help.
      If you want to try earlier versions, all previous versions are still available in the WordPress plugin repository.

  6. Hi Ben,

    Just here to say I absolutely love version 3 of your plugin! I have used the plugin before but it has become a really GREAT plugin!!

    Thanks
    Joke

    • Thanks Joke :-)
      Very much appreciated!

  7. I love this plugin, it is exactly what I wanted for my page. I had a couple of comments that my site wasn’t displaying right so I checked it out. In IE and Firefox, the photos don’t show at all. In Chrome, it works fine. I didn’t change anything at all. Any thoughts?

    • I forgot an important clue. My dropdown submenus don’t work either. That might be a clue to what the problem is.

    • Jon,
      This looks like a jQuery conflict. Please try deactivating other plugins until you find the culprit. One of the Nivo slider plugins available (Nivo Slider for WordPress) is often the cause of problems because of the way it loads jQuery (not the orthodox WP way).

  8. Hi, I love this plugin but I have one issue and maybe you could assist me: I want my background to scroll. Is there there an easy fix for this?

    • John,
      Try modifying the css of #supersized to:
      #supersized {
      position:absolute;
      top:0;
      left:0;
      }

  9. Here I am again :)
    I ran into a problem: a conflict with another plugin. I have already reported this with the other plugin, but unfortunately no reaction yet, so I am hoping you can help…
    The plugin I am referring to is NextGen Image Rotation.
    If NGG Image Rotation is activated the Supersized plugin only works on pages that displays a NNG gallery.
    If a pages has no gallery the Supersized plugin does not work, regardless of wether it takes it’s background image from a NNG gallery or the WP media gallery.
    As soon as I de-activate NGG Image Rotation, Supersized does what it should do.

    Thanks for your time, and I hope you can help!
    Joke

    • I fixed it by adding images=[''] to my template. That fixed the conflict.

      • oops sorry: forgot that I can’t post code very well here… that was between javascript tags…

  10. Hello, i´m having some trouble the slide will not work on my site, could it be a jquery conflict? Would you please take a look

    thanks in advance

    • Willian,
      Please update to the latest version and reset your options. This could solve the problem. Otherwise, contact me again.

  11. hi
    theres a conflict with the latest wordpress version

    since last update the plugin doesnt work good at the backend

    the tab cant be press on the wp supersized panel option

    thanks

    • Eitan,
      Please update to the latest version and reset your options. This should solve the problem.

  12. Hi! Love your plug-in. I use it on my site http://www.devignelements.com. Up until today, when I updated everything has worked well, but I am now getting an error: Warning: Invalid argument supplied for foreach() in /homepages/32/d388612952/htdocs/wp-content/plugins/wp-supersized/includes/WPSupersized.php on line 125.

    I was wondering if you could help me? Thank you.

    • Dawn,
      Please update to the latest version and reset your options. This should solve the problem.

      • Just wanted to say thank you. You are really awesome!

      • Thanks Dawn!
        Very much appreciated :-)

  13. Hi

    Firstly i LOVE this plugin but I am in desperate need of some help. Everything was working perfectly until I upgraded my wordpress to the latest version. since then the slides have not been loading on my font page http://elmurphy.co.uk/ – any help would be greatly appreciated

    • Emma,
      Please update to the latest version and reset your options. This should solve the problem.

  14. Plugin breaks in WordPress 3.5 – the loading animation shows and the image never loads. Can you please issue a fix (there are a number of comments in the WP support forum about this) or post a link to the last version of the plugin that was working correctly?

    • Debbie,
      Please update to the latest version and reset your options. This should solve the problem.

  15. just updated to your latest version and your plugin now now longer works. I would prefer to go back to my previous version any suggestions how I can accomplish this?
    thanks in advance

    • Nils,
      Please update to the latest version and reset your options. This should solve the problem.
      All previous versions are still available in the WordPress plugin repository.

  16. after updating to v3.1.2 I get this error:

    Warning: Invalid argument supplied for foreach() in /var/www/vhosts/mannistruck.de/httpdocs/wpress/wp-content/plugins/wp-supersized/includes/WPSupersized.php on line 104

    Warning: Invalid argument supplied for foreach() in /var/www/vhosts/mannistruck.de/httpdocs/wpress/wp-content/plugins/wp-supersized/includes/WPSupersized.php on line 136

    Warning: Invalid argument supplied for foreach() in /var/www/vhosts/mannistruck.de/httpdocs/wpress/wp-content/plugins/wp-supersized/includes/WPSupersized.php on line 104

    Warning: Invalid argument supplied for foreach() in /var/www/vhosts/mannistruck.de/httpdocs/wpress/wp-content/plugins/wp-supersized/includes/WPSupersized.php on line 136

    Warning: Invalid argument supplied for foreach() in /var/www/vhosts/mannistruck.de/httpdocs/wpress/wp-content/plugins/wp-supersized/includes/WPSupersized.php on line 104

    Warning: Invalid argument supplied for foreach() in /var/www/vhosts/mannistruck.de/httpdocs/wpress/wp-content/plugins/wp-supersized/includes/WPSupersized.php on line 136

    • Manni,
      Please update to the latest version and reset your options. This should solve the problem.

  17. I’m having trouble since the upgrade to WordPress 3.5. All I see is the spinning wheel but no images load. I’m pulling the images from a NextGEN gallery. I’m not sure what to do. Any ideas?

    • Sherice,
      It seems that many users have recently had trouble with the interaction between the plugin and NextGen Gallery. I also had this problem and it was solved easily. If you check the announcement of NextGen Gallery 1.9.8 on the Photocrati website, they advise users of NextGen Gallery to deactivate and reactivate NextGen Gallery to have it working correctly.
      I also advise to update to the latest version of WP Supersized and to reset its options.

  18. Hi,
    first of all before all the “please make it work”-nag, let me just start by saying that this is a wonderful plugin.. easy to configure, many options and so forth. I’t great and it makes my life a lot easier. I salute you for doing this:
    Now the “please make it work” rant. :D
    I updated to 3.1.5 today, activating the plugin (not having it active for a few releases as I’m still developing a new theme for myself) All I got was the progress circle.. and there it stayed.

    Downloading some old releases didn’t help much either so I’m kinda stuck.
    I’m running WP 3.5 with the following pugins active: contact form7, nextgen gallery (that I intend to use as my slide source), nivo slider for wp and real simple captsha.

    The JS error i get is:
    “wordpress:169TypeError: ‘undefined’ is not a function (evaluating ‘$.supersized’)”

    Knowing it’s hard to guess what it is.. what could be causing this?

    • I quick think and I found the cause… Nivo. So my question changes abit to if these two plugins can coorperate and what I have to do on my end.

      • Nic,
        Some of the many Nivo slider plugins available for WP cause problems because of the way they load jQuery. Avoid Nivo Slider for WordPress and try NIVO slider light instead. My experience shows that the latter works well together with WP Supersized.

    • It seems that many users have recently had trouble with the interaction between the plugin and NextGen Gallery. I also had this problem and it was solved easily. If you check the announcement of NextGen Gallery 1.9.8 on the Photocrati website, they advise users of NextGen Gallery to deactivate and reactivate NextGen Gallery to have it working correctly.
      Nivo can also introduce some conflicts. One well documented problem (not only with my plugin) occurs with one of the many plugins that adds a Nivo slider to WP (Nivo Slider for WordPress). One that I have tested without problem is NIVO slider light.

      If you still have problems with WP Supersized after doing that, try resetting the options.

  19. I am using NGG and I am running into a bug when I try to specify a different slide to start. I get the following error:

    Uncaught TypeError: Cannot read property ‘url’ of undefined

    • Tim,
      It seems that many users have recently had trouble with the interaction between the plugin and NextGen Gallery. I also had this problem and it was solved easily. If you check the announcement of NextGen Gallery 1.9.8 on the Photocrati website, they advise users of NextGen Gallery to deactivate and reactivate NextGen Gallery to have it working correctly.
      If you still have problems with WP Supersized after doing that, try resetting the options.

  20. Hi, This is just what I have been looking for. I tried jetpack carousel but the reduced size of the images was not what I wanted. I have a wordpress gardening website http://www.aberdeengardening.co.uk I installed and activated supersized directly from the plugins page, installed no bother. I have published a test page but when I added the images using wordpress gallery no option for supersize is showing. Please help. Alistair

    • Alistair,
      If you want to use images from WP Media Gallery, the only thing you need to do is attach the chosen images to the page/post (you do not need to insert them in the page/post). And then select WP Media Gallery as source of images in the WP Supersized meta box in the page/post editor.

  21. Just finished the update to WP 3.5 and the plugin no longer works. You can see the results at http://www.northscottsdalepreferred.com. I’m guessing this has to do with the jQuery updates in WP 3.5. Any plans to update the plugin to work with WP 3.5?

    • Sorry about that. I did some digging and upon updating the network looks like some of my settings had to be reset in the database. I went through every screen and set the plugin up again. Now everything is working. Thanks for such a great plugin.

      • Ryan,
        Yes, since I introduced an error (sorry about that!) in a recent update, a reset of the options is advised to get everything back to normal. You will of course need to set your options again to what you want.

  22. Will transparent png’s work with this? I have images with transparent backgrounds to use in the full width version of Supersized but the transparency disappears. Is there any way to keep transparency?
    Thanks.

    • Caitlin,
      Although I have never tried them, png files should normally work fine. Supersized is simply displaying the image as is so transparency should still be present. I will have a look at this.

  23. Hi,

    Thanks for the great plugin!
    I do have a question though:
    Is it possible to set a different nextgen gallery per category? Or per templatevariation?

    Hope you can help me out here

    • Bram,
      A different NextGen gallery per category or template is not possible for the moment but I will include this possibility in a coming update.

  24. Hello,

    I am using this plugins and works great, I just updated it to version 3.1.5 and its now having some conflicts with Easy-Fancybox plugin. Its disturbing the position of the lightbox.

    please provide me with some solution.

    • Himanshu,
      Thanks for spotting this bug. I quickly found the culprit: the jquery.animate-enhanced.js file that I had added since version 3.1.2 to reduce flickering on iPad and iPhone. Removing it solves the issue. I will add an option in the next update to remove it if it causes problems like yours.
      In the meantime, you can comment out the following lines in version 3.1.5: 55, 178, 187, 191, 195 and this will solve the problem.

      • Thanks Ben for the quick response.

        I just commented out the animate-enhanced file and now my fancybox is working good.

        Thanks a lot.

  25. Hi,

    I have a background image that I am trying to set up using this plugin. I can see at the bottom of my page that the background image is there, but for some reason it seems trapped behind the background of the theme we are currently using. I am able to see the WP Supersized image only across the very bottom. Do you have any suggestions about how to replace the plain background color of the theme with the plugin image?

    Thank you very much for your help!

    • Samantha,
      You need to check which background image stands in the way (use Chrome and its developer tools for that, very useful). Once identified, you can modify the css of your page to remove that particular image.

  26. Hi Ben,

    The actual plain background color of the theme is what’s blocking the image I have attempted to install using this plugin. Is there a known issue of this plugin not working with the Fotographia theme?

    Thank you!

Notify me of followup comments via e-mail. You can also subscribe without commenting.