March 4th, 2008 at 4:50 am by David Potter

NextGEN Gallery Review - Configuration

There are a lot of options available in this plugin.  To configure it, you find a top-level Gallery menu in the admin menu.  The main page looks very similar to the WordPress Dashboard page.  The one thing that is missing is a link to the plugin page itself.

Before you do anything else, go to the Options sub-page.  From here you’ll notice a number of options pages for configuring different parts of the plugin, including General, Thumbnails, Images, Gallery, Effects, Watermark, and Slideshow.

General Options
  • Gallery path
    Most people won’t have to change this.  I needed to because I share the same WordPress installation using a modification of MultiBlog by Stephen Rider, so the default location (wp-content/gallery/) would place the images for all sites using that installation in the same directory.
  • Delete image files
    Check if you want to the image files to be deleted from the disk when you delete images from a gallery.  Disabled by default.
  • Activate batch upload
    Allows you to specify multiple image files to upload in a single batch.  Requires Adobe Flash 9.  This provides a major improvement in the upload experience.  Disabled by default.
  • Activate permalnks
    Check this if you want nice permalinks to be generated for galleries and images.  After checking this you have to regenerate permalinks.  Disabled by default.
    • If your WordPress site is hosted on IIS, you won’t be able to check this checkbox unless you’ve purchased a product that gives you the .htaccess features of Apache.
  • Activate related images
    Check this to have the plugin generate a section at the end of posts for images whose tag matches the post’s tag or category (see the next option).  Pretty cool!  One problem I found is that the background behind the images is white which may not match your theme.  Disabled by default.
  • Match with Categories or Tags
    Specifies whether you want an image’s tag to be matched against a post’s category or tag.  Defaults to Category.
  • Max. number of images
    Specifies the maximum number of images to show with each post.  Specifying 0 will show all images.  This value defaults to 7.
Thumbnails

After making changes to thumbnail options, you will need to regenerate thumbnails in all galleries.

  • Width x height (in pixels)
    Specifies the maximum width and height for thumbnail images.  The default is 100 x 70.  I like larger thumbnails so I specify 128 x 128.
  • Set fixed dimensions
    Ignores the aspect ratio of images and generates a thumbnail to the exact dimensions specified above.  Disabled by default.
  • Crop square thumbnail from image
    Creates square thumbnails.  The note on the page says to use only when the dimensions are set to 128 x 128.  I’m not sure what happens if the dimensions are set to something else.  Hopefully it fails gracefully.  Disabled by default.
  • Thumbnail quality
    This is a percentage of maximum quality.  I haven’t played with this so I can’t comment on how it works.  Defaults to 100%.
  • Resample mode
    Specify a value between 1 and 5, with higher values using more CPU.  I haven’t played with this so I can’t comment on how it works.  Defaults to 3.
Images
  • Resize images
    Specifies the width and height that images will be resized to.  These are maximum dimensions and aspect ratio is maintained.  Images are only resized when you choose to do that specifically.  Images are not resized when you upload them.  Defaults to 800 x 600.
  • Image quality
    This is a percentage of maximum quality.  I haven’t played with this so I can’t comment on how it works.  Defaults to 85%.
  • Resample mode
    Specify a value between 1 and 5, with higher values using more CPU.  I haven’t played with this so I can’t comment on how it works.  Defaults to 4.
  • Cache single pictures
    When using the singlepic tag, the image is resized for display on the page based on the values specified with the tag.  If this is checked, those images will be cached for each singlepic setting, which will improve load times and CPU loads on subsequent page loads.  I haven’t played with this so I can’t comment on how well it works.  Disabled by default.
  • Clear cache folder
    Push button that allows you to clear the cache.
Gallery
  • Activate jQuery navigation
    You should not check this box.  Alex’s advice to anyone who ever checked it is to disable it.  My advice to Alex is that if it shouldn’t be used, he should remove it before releasing each version.  Disabled by default.
  • Deactivate gallery page link
    When enabled, clicking on a gallery (e.g. in an album) will cause the gallery to be displayed on the same page.  When disabled, the page you have associated with the gallery will be displayed.  Enabled by default.
    • I’ve made some changes to this behavior which I’ll describe later.
  • Number of images per page
    Specifies how many images are displayed on a gallery page.  All images are displayed if 0 is specified.  Defaults to 0.
  • Integrate slideshow
    Allows visitors to switch between viewing the thumbnails in the gallery and viewing the pictures as a slideshow.  You can also specify the text that is displayed to switch between the two modes.  Enabled by default.
  • Show first (thumbnails, slideshow)
    Specifies what to view first when a gallery is displayed.  Defaults to Thumbnails.
  • Show thumbnail description
    Specifies what to display under thumbnails in a gallery.  Defaults to None.
    • None - Just the thumbnail is displayed with no text.
    • Description text - The text entered in the description field for each image is displayed under the thumbnail.
    • Alt/Title text - The text entered in the alt/title text field for each image is displayed under the thumbnail.
  • Show ImageBrowser
    If enabled, a larger version of the image will be displayed on the page when clicking on an image.  If not enabled, what looks like a pop-up window is displayed in the middle of the page to display the image and the page behind it goes dark.  I much prefer the non-ImageBrowser effect (disabled).  Disabled by default.
  • Sort thumbnails
    Specifies how thumbnails are sorted when displayed in a gallery.  Defaults to Image ID.
    • Image ID - Sorts thumbnails by the ID of the image.  This works well if you import them in the order you want them displayed.
    • File name - Sorts thumbnails by the name of the image file.  This works well if your image files are named the way you want them sorted.
    • Alt/Title text - Sorts thumbnails by the alt/title text specified for each image.  This defaults to the name of the image file or to the EXIF data if you specified that during import, but you can change this at a later date.
  • Sort direction
    Specifies the direction for sorting (ascending or descending).  Defaults to Ascending.
Effects

This page has a note about Thickbox being the only effect that is added to the theme.  I’m not sure what this actually means, it could mean that you have to install something before the other effects will actually work.  It would be handy if there was a pointer to the other effects on this page.

  • JavaScript thumbnail effect
    Selects the effect to use when clicking on a thumbnail.  Choices include None, Thickbox, Lightbox, Highslide, Shutter, and Custom.  Although it’s not clear from the UI (because it’s always editable), it appears that selecting Custom allows you to modify the style used (in the Link code line box).  I’ve only tried Thickbox so I can’t comment on the others.  Defaults to Thickbox.
  • Link code line
    Shows the code that will be used to display images when the visitor clicks on a thumbnail.  The text is always editable, but it may only be saved when Custom is selected for JavaScript thumbnail effect.
  • thickbox-options.jpgSelect loading image
    This option is only displayed when JavaScript thumbnail effect is set to Thickbox.  Two options are displayed - a series of dots in a circle and a horizontal bar that looks like a progress bar moving like a barber pole.  The latter is the default.
Watermark

These options allow you to add a watermark to images.  There’s a note at the top of this page saying that once a watermark is added it can’t be removed.  Watermarks are added from the Manager Gallery page.

You can choose to add either an image or text as a watermark.  There are several additional options if you select text, such as font, size, color, and opacity.

Slideshow

The options on this page configure how NextGEN Gallery displays slideshows using JW Image Rotator.  Alex provides a nice link to the options that can be set on the rotator (http://www.jeroenwijering.com/?item=JW_Image_Rotator).  I’ll summarize the options here as they appear on the Slideshow option page.

  • Default size (W X H)
    Specifies the default size of the slideshow.  This is the size at which slideshows are displayed.  Defaults to 320 x 240.
  • Shuffle mode
    If enabled images are displayed in a semi-random order.  Otherwise they are displayed in the order specified by the sorting options on the Gallery page.  Disabled by default.
  • Show next image on click
    When enabled, causes the next image to be displayed when the current image is clicked.  Enabled by default.
  • Show navigation bar
    When enabled, shows a bar about 1/5th of the way up from he bottom that displays the description in the middle and arrows on either side for navigating between pictures.  When using the default slideshow size, I found the navigation bar to be too distracting.  It might be more useful on larger slideshows.  Disabled by default.
  • Show loading icon
    I didn’t see a difference whether this was enabled or disabled.
  • Use watermark logo
    Uses the settings on the Watermark options page to add a watermark to each image in the slideshow.  I suspect it is only added to the scaled version being displayed, not the original version stored in the gallery.  Disabled by default.
  • Stretch image
    Allows you to specify how images that have a different aspect ratio than the slideshow.  For example, this is useful for determining how portrait images should be displayed.  I found that no option had any effect whatsoever; portrait images were always stretched to fit the slideshow area.  Defaults to true.  From the JW Image Rotator page:
    • true - stretch images proportionally to fit the slideshow area.
    • false - stretch images to fit the slideshow area (I’m not sure how this differs from fit)
    • fit - stretch images disproportional to fit the slideshow area.
    • none - keep original dimensions.
  • Duration time
    Specifies how many seconds each image should be displayed before moving on to the next one.  Defaults to 10 seconds.
  • Transition / fade effect
    Specifies how to transition from one image to another.  Defaults to random.
    • fade - fades one image out as the new image fades in.
    • bgfade - fades to the background color and then fades to the new image.
    • slowfade - like fade only slower.
    • circles - displays rotating circles that grow larger to reveal the new image underneath.
    • bubbles - displays rising bubbles that grow larger to reveal the new image underneath.
    • blocks - displays blocks that move from one corner to the opposite corner to reveal the new image underneath.
    • fluids - like bubbles only from the center, as if liquid has been spilled on the image.
    • flash - quickly flashes to white and then fades the new image in.
    • lines - displays vertical lines that move left and right to reveal the new image underneath.
    • random - randomly selects a transition effect for each transition.
  • Use slow zooming effect
    This enables a very cool effect that zooms into the images a little bit and then moves across them.  Disabled by default.
  • Background color
    Specifies the color of the background for slideshows and for image popups.  Defaults to black (000000).
  • Text/button color
    Specifies the color for text and buttons.  Defaults to white (FFFFFF).
  • Rollover/active color
    Specifies the color of text and buttons when rolling over them.  Defaults to red (CC0000).
  • Screen color
    Not really sure here as by default there is no numeric value.  It looks like it uses white, though.
  • Background music (URL)
    A URL to a music file to play while the slideshow is playing.
  • Try XHTML validation (with CDATA)
    I didn’t try this so I can’t comment on it.  There is a comment next to this option saying that it could cause problems with some browsers.

27 Comments

  1. Alex Rabe · March 13th, 2008 at 12:34 am #

    Wow , wow, wow…
    Thanks for this post !

    I always was a little bit lazy in writing documentation and your review covers nearly all aspects for the first step. I will add you article add my blog.

    Thanks again

  2. David Potter · March 16th, 2008 at 8:54 pm #

    Glad to do it. If you link to these pages, you should probably link to either the Introduction or Installation pages. The Configuration page would even be better than the Image Management page as that page assumes you’ve already configured the plugin.

    I plan to add another page in the series discussing how to use the plugin (i.e. how to show images, albums, galleries, etc. to a page or post). I also hope to add some images. But, of course, that all takes time.
    :-)

    Anyway, thanks for the kudos.

  3. Alex Rabe · March 20th, 2008 at 6:22 am #

    Yup,
    I changed my link ….

  4. tyronebcookin · April 14th, 2008 at 1:08 pm #

    Hello David, can’t see straight anymore so I am going to bed…but I have a doozy of a problem which may be corrected simple but right now I don’t want to look at it… here goes:

    I installed all as directed but my menu options use the following links:
    http://www.tyroneandstephanie.com/blog/wp-admin/nextgen-gallery?page=nggallery-options - and these don’t work - only if you type in admin.php in place of the nextgen-gallery bit like this :
    http://www.tyroneandstephanie.com/blog/wp-admin/admin.php?page=nggallery-options - again, that would be the menu option under gallery tag in dashboard, NOW the ‘manage galleries’ & ‘upload pictures’ buttons in the ‘welcome to nextgen’ line work fine, they both use the string I am talking about above with the admin.php bit instead of the nextgen-gallery bit….

    So how can I change one of the files (which file) to properly point the menu option links in the right direction?! Or what is going on that is so wrong that the menu doesn’t link right, but the two buttons in the welcome line do?! I am in WP 2.5 any help would be appreciated.

    tyronebcookin

  5. David Potter · April 14th, 2008 at 2:41 pm #

    Hi Tyrone. I’m not running 2.5 yet so unfortunately I can’t really provide much help. You might ask on Alex’s forum: http://alexrabe.boelinger.com/forums/

  6. Karl · May 1st, 2008 at 2:08 am #

    HI I’ve installed the plugin ok, is there a demo of the code some where, I’m alittle lost on how to bring up the gallery images on a side bar, can you point me the right way please.

    K

  7. sally lundburg · May 13th, 2008 at 8:31 pm #

    Hi,
    I have a question that I cannot figure out about Next Gen Gallery (for my site).
    How do I get my portrait images to NOT resize so large. I’ve tried adjusting the “resize image” in the Gallery/Image section, all the way down to 200, but with no effect. Also, I cannot seem to get the slideshow option to work using the slideshow=ID code . I tried uploading the JW image rotater, but I do not see it in my plugins to activate. I’d appreciate your help if you have time!
    Sally

  8. David Potter · May 14th, 2008 at 1:40 am #

    @Karl - I’m part way through a series of articles on how to display images. Check them out and let me know what you think.

    @sally - I’ve had similar issues with slideshows when the images are not 4:3 landscape. Unfortunately I haven’t had a chance to troubleshoot. Sorry.

  9. Adam · May 15th, 2008 at 6:42 pm #

    Great job, love the write up! Can’t wait to read more. I just installed this a few days ago and have been trying to get everything sorted. Great plugin. So far my only problem is the same as other have had getting the slideshow to properly display a portrait image. Thanks!

  10. Nick · May 23rd, 2008 at 8:36 am #

    Hi, I don’t have widgets in my template… what code do I use to enter the gallery into my sidebar? Thanks for your help.

  11. Chris M · August 3rd, 2008 at 2:59 pm #

    Hey,

    This is a super write up! I am getting the following problem after uploading pictures during thumbnail creation:
    Follow thumbnails could not created.
    104-lancia.jpg (Error : Exceed Memory limit. Require : 52.98 MByte)

    How do I solve this thanks?

    Chris

  12. Lucky Dog ยป Announcement !! · August 5th, 2008 at 12:53 am #

    [...] NextGEN Gallery Review - Configuration [...]

  13. Fred · August 10th, 2008 at 3:22 pm #

    How do you enable the Use slow zooming effect?

  14. David Potter · August 12th, 2008 at 2:19 pm #

    @Adam - I’ve had the same issue, but I haven’t had time to investigate. Sorry.

    @Nick - Check out the functions in the nggwidget.php file. That should get you going.

    @Chris - Typically that message is displayed when the PHP limit has been exceeded. To fix this, you need to go into your php.ini file and set the upload_max_filesize to something that will accommodate the files you want to upload.

    @Fred - Sorry, I haven’t used the slow zooming effect yet.

  15. sara · August 22nd, 2008 at 6:13 pm #

    Greetings.
    Wonderful breakdown. thanks much.
    I have a question about the NextGen Widget.

    I got it working. but when you click on the thumbnails, the link goes to the actual image path.
    I see that other sites with the widget have a feature enabled that brings up some sort of flash gallery over the page… how to i implement this feature?

    thanks much!

    sara

  16. Ivan · August 24th, 2008 at 9:18 pm #

    Hello David,
    for some reason I can get the below step to work on my website any advice please helppppppp.

    Show ImageBrowser
    If enabled, a larger version of the image will be displayed on the page when clicking on an image. If not enabled, what looks like a pop-up window is displayed in the middle of the page to display the image and the page behind it goes dark. I much prefer the non-ImageBrowser effect (disabled). Disabled by default.

  17. Mark Rouse · August 28th, 2008 at 4:31 pm #

    Hi David.

    My problem is once I’ve installed the plugin and I try to add a gallery I get the following error message:

    Unable to create directory wp-content/gallery/as!
    Directory wp-content/gallery/as is not writeable !
    Unable to create directory wp-content/gallery/as/thumbs !

    I have tried everything but I really do not know where I am going wrong and no doubt this is simple as pie!! :(

  18. louisville guy · August 28th, 2008 at 8:14 pm #

    same problem as the others above…. portrait images get mangled on individual view and nothing I can seem to do prevents it from being resized. Your comments above state that it does not re-size by default. In my case, large portrait images are being scaled down; others above indicate they cant restrict such images to smaller sizes. Answer?

  19. » Testing NextGEN Gallery Plugin by Adding a Whole Gallery to a Post · August 30th, 2008 at 5:39 pm #

    [...] it off in the feed and make the photos only viewable from the site. Also, came across a pretty good write up on how NEXTGen Gallery works, even if it doesn’t help with my current [...]

  20. Mike · September 3rd, 2008 at 1:22 am #

    Anyway to put the images in a non web-accessible directory? I tried but the plugin couldn’t find it.

  21. kevin · September 10th, 2008 at 8:32 pm #

    Hopefully you’ll be able to assist me with this problem. I’m trying to activate permalinks within my Nextgen Gallery. In the address bar, it shows something to the extent of “/nggallery/post//page/1″

    The permalink default configuration I have within WP is just /%category%/%postname%/ - within that, I get a 404 error.

    What is the correct permalink structure?

  22. Serge Norguarf · September 15th, 2008 at 7:22 pm #

    i’m trying to get the slideshow to work but all i get is a blackbox and nothing else.

    I thought it may take some time for the images to load so, after loading the permalink, i left it on it’s own for 5 minutes and when i cam back it was a black box. Right click on it and states that images did not load.

    appreciate any help that can be given for this.

  23. mache · September 17th, 2008 at 9:09 am #

    Hi,
    I need help to know how to make the descriptive text show on the slideshow widget. I have try different ways but is not working and I can’t figure out why. S.O.S. please! :-/

  24. bruce · September 20th, 2008 at 8:10 pm #

    hi, i cant seem to find the nggallery admin page! arg. this is making me sad. its not on my main wordpress dashboard even after i activated the plugin. argg…

  25. Ferpont · September 28th, 2008 at 4:38 pm #

    Hi David! Do tou happen to know where can I modify the transparency of the overall layer that covers up the screen when popping up a slide? I need to make it show plain white.

  26. Ferpont · September 29th, 2008 at 9:41 am #

    Sorry! I have already solved it! everything related to the popping images is on the “thickbox” folder . I fiddled around with thickbox.css and the two .js and got the thing to work to my command!
    Thank you anyway!

  27. Gerad T · October 4th, 2008 at 11:58 am #

    Can you please explain the permalinks piece? Why would I want to turn that on? When I currently hover over the image, I do see a link in the status bar. So, what does that feature really do for the blog?

    Thanks in advance.

Leave a Comment




XHTML: You can use these tags: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>