Table of Contents

Installation Back to top

To do a new installation of the plugin, please follow these steps:

  1. Download the zipped plugin file to your local machine.
  2. Unzip the file.
  3. Upload the wp-lightbox folder to the /wp-content/plugins/ directory.
  4. Activate the plugin through the 'Plugins' menu in WordPress.
  5. Optionally, go to the "Lightbox Evolution" page under Settings tab and configure the options.
  6. Go to your blog post or page and add a links to images.
  7. If you would like to display a title for your image, simply add a title attribute to the link.

If you have already installed the plugin:

  1. De-activate the plugin.
  2. Download the latest files.
  3. Follow the new installation steps.

Support Back to top

This plugin supports the following browsers:

Quirks mode is not supported in any browser, but that doesn't necessarily mean that it won't work. This means that you need to use either a strict or transitional DOCTYPE in order to use Lightbox.

Frequently Asked Questions Back to top

  1. Can I use this script on my client's website?

    Yes. Your license includes the rights to use the script on any one website at a time. If you'd like to use the script as part of a service, please consider purchasing an Extended License.

  2. Can I make modifications to this script?

    Feel free to make any modifications you need. Also feel free to blog about it and show your friends, but please do not redistribute the script with your changes.

  3. Why the plugin doesn't work?

    Make sure you don't have multiple versions of jquery in your page. Look at the source view in your browser to see what jscripts you are loading.

    For example:

    <script src="crazy_path/jquery.js" type="text/javascript"></script>
    ...
    <script src="crazy_path/jquery.min.js" type="text/javascript"></script>
    ...
    <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4/jquery.min.js"></script>
    

    jquery.js and jquery.min.js are the same script. Delete the last one if you can. Keep only one.

    Also, please check that there is a wp_head(); template tag in your theme header.php and there is a wp_footer(); template tag in your theme footer.php.

    Alternately you may have other plugins that conflict with Lightbox Evolution. Try disabling your other plugins and see if that helps. If it does, re-enable each plugin, one at a time to see which one is causing the conflict. Please let me know which plugin is causing the problem.

  4. Does the lightbox work with galleries?

    Yes it does. There are few simple requirements however. You you must set Link thumbnails to: Image File or use [gallery link="file"] for the gallery options.

  5. The shadow overlay doesn't stretch to cover full browser window.

    Remove the default margin and padding from the body tag. Add body{ margin: 0; padding: 0; } to your stylesheet.

  6. How to automatically start Lightbox on page load?

    Add the code below in the footer.php of your theme just before </body> tag:

  7. <script type="text/javascript">
      jQuery(document).ready(function(){
      
        jQuery.lightbox("image.jpg");
    
      });
    </script>
    
  8. Why Flash objects appear through overlay?

    By default Flash will overlay any HTML content. This can be prevented by setting the 'wmode' param and embed attribute to 'transparent'.

    For more information from Adobe Support

    AC_FL_RunContent( 'codebase', 'http...', 'pluginspage', 'http...',  'wmode', 'transparent', 'width', '99', 'height', '99', 'src', 'images/home', 'quality', 'high' );
    
    var so = new SWFObject("home.swf", "home", "99", "99", "9", "#222222");
    so.addParam("allowfullscreen", "true");
    so.addParam("allowScriptAccess", "always");
    so.addParam("wmode","transparent");
    
    <object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" codebase="http..." width="999" height="999">
      <param name="movie"   value="images/home.swf" />
      <param name="quality" value="high" />
      <param name="wmode"   value="transparent" />
      <embed src="images/home.swf" wmode="transparent" width="999" height="999" quality="high" pluginspage="http..." type="application/x-shockwave-flash"></embed>
    </object>
    
  9. Lightbox is positioned incorrectly or behaving strangely in Internet Explorer

    This is likely a doctype issue. This plugin requires a valid doctype and rendering in quirks mode is not supported. Make sure you are using the full doctype declaration to insure rendering in standards mode.

    This abbreviated doctype renders the document in quirks mode for Internet Explorer:

    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
    

    The doctype with URI renders in standards mode for all browsers:

    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    
  10. How can I open Lightbox from inside a Flash movie?

    In your Flash movie you need to use getURL to call your custom callback function, like so:

    getURL("javascript:jQuery.lightbox('image.jpg')");
    
  11. How can I open Lightbox in parent window from inside an iframe?

    First thing you need to do is install the script in your parent window, but don't initialize it. Don't use jQuery(document).ready, instead, add the code below:

    <script type="text/javascript">
      function frameload(iframe) {
        var doc = iframe.contentWindow || iframe.contentDocument;
        if (doc.document) { doc = doc.document; };
        
        jQuery('.lightbox', doc.body).lightbox();
      };
    </script>
    

    Insert onload="frameload(this);" in your iframe markup.

    <iframe src="iframe_child.html" onload="frameload(this);" width="500" height="500"></iframe>     
    

    When you click an image in the child page, the lightbox will be displayed in your parent page. Remember to remove the script in your child page to avoid any problem.

  12. How can I configure the lightbox to work with NextGEN Gallery plugin?

    Go to Gallery > Options > Effects, select Custom and paste the code below:

    class="lightbox" rel="%GALLERY_NAME%"

Known Problems Back to top

  1. No support for iPad (if someone wants to donate an iPad to me I'll guarantee support)
  2. In some instances performance may be slow in IE - this may be due to plugin conflicts or slow JavaScript performance in IE.

Support Notes Back to top

To be able to help solve a problem quickly, please read the entries below. I'll do my best to assist you. I provide a full range of Support except:

  1. I don't (and can't) support the 3rd-party code (i.e. external plugins, javascripts, flash players, etc.) In such cases you shall have to contact the authors.
  2. I don't support errors provoked by the strong modification of the original packages.
  3. I don't customize the packages in personal way.
  4. If you sure that your improvement ideas will be helpful to others, please don't hesitate to share it with me. Most likely that it will became a free package update.

If you have a more general question relating to scripts on CodeCanyon, you might consider visiting the forums and asking your question in the "Item Discussion" section. Once again, thank you so much for purchasing this plugin.

aeroalquimia (Eduardo Daniel Sada)
Buenos Aires, Argentina. Jul 2010