Image Handler 3 Support Thread (for ZC v1.3.9)

[DivaVocals]

The kids are moving out dad!

Welcome to the new support thread for Image Handler 3, v3.0.

This version works on ZC v1.3.9. If you're looking for something for a newer version of Zen Cart, see
http://www.zen-cart.com/showthread.p...mage-Handler-4

Image Handler 3, v3.0 is available for download here:
http://www.zen-cart.com/index.php?main_page=product_contrib_info&products_id=1910


The previous support threads can be found here:
http://www.zen-cart.com/forum/showthread.php?t=35913
http://www.zen-cart.com/forum/showthread.php?t=33373

All support related questions for Image Handler 3 for v1.3.x should be posted on THIS support thread. The Image Handler 2 Support thread will continue to serve as the support thread for those who are not upgrading to Image Handler 3 for v1.3.x.

Any IH2 questions posted here will be (gently) re-directed back to the Image Handler 2 Support thread.(and vice versa)

Image Handler 3 v3.0 for v1.3.x
Image Handler 3, v3.0 for v1.3.x is based on an original contribution by Tim Kröger.

Why the new name??
With the guidance of the Zen Cart admins, Image Handler 3 was submitted as a NEW add-on with a new name to minimize confusion so this new CLEAN support thread could be started. The bugs/issues reported in the old support thread have been addressed in this new version, and the readme has been revamped to provide MORE information upfront to those who use this add-on which will (hopefully) address some of the usual install and configuration questions.. (versus having to search through a 5 year old support thread)

So on to the good stuff.

Here's the answers to the most frequently asked question: "What does Image Handler 3 do?"
(which BTW REALLY IS explained in detail in the readme for those who REALLY wanna know.. it doesn't hurt to download the fileset..)

Purpose & Aim
Image Handler 3 at the heart of its code is really meant to ease the management of product images (particularly the management of additional product images), and to help improve page performance by optimizing the product images.

Image Handler 3 generates product images (based on your image settings) in the Image Handler 3 bmz_cache folder. It DOES NOT replace or modify the original images. So it's PERFECTLY safe to use on an existing store.

Image Handler 3 enables you to use GD libraries or ImageMagick (if installed on your server) to generate and resize small, medium and large images on the fly on page request. You can simply upload just one image or you can have different sources for medium and large images. Image Handler 3 further enables you to watermark your images (overlay a second specific translucent image) and have medium or large images pop up when you move your mouse over a small image (fancy hover).

This contribution includes a powerful admin interface to browse your products just like you would with the Attribute Manager and upload / delete / add additional images without having to do this manually via FTP. Image Handler 3 works fine with mass update utilities like EzPopulate.

Features

• [FONT=Tahoma]Improve site performance (faster loading, faster display)[/FONT]
• [FONT=Tahoma]Professional looking images (no stair-effects, smooth edges)[/FONT]
• [FONT=Tahoma]Choose preferred image-types for each image size[/FONT]
• [FONT=Tahoma]Uploading one image automatically creates small, medium and large images on page request[/FONT]
• [FONT=Tahoma]Drops in and out seamlessly. No need to redo your images. All images are kept.[/FONT]
• [FONT=Tahoma]Easy install. One-click-database-upgrade.[/FONT]
• [FONT=Tahoma]Works with mass-update/-upload tools like EzPopulate.[/FONT]
• [FONT=Tahoma]Watermark images to prevent competitors from stealing them.[/FONT]
• [FONT=Tahoma]Fancy image hover functionality lets a larger image pop up whenever you move your mouse above a small image (switchable).[/FONT]
• [FONT=Tahoma]Choose an image background color matching to match you site's color or select a transparent background for your images.[/FONT]
• [FONT=Tahoma]Manage your multiple images for products easily from one page just like you do with attributes in the Products Attribute Manager.[/FONT]

Image Handler 3 is meant to ease the work required to setup images for your store. It works WITH default Zen Cart functionality, it does not replace it.

It is very strongly recommended that you read through the ENTIRE "Configuration" & "Usage" sections of the Image Handler 3 readme file. There you will find out exactly what Image Handler 3 can do.

[DivaVocals]

[FONT=Tahoma]BEFORE[/FONT][FONT=Tahoma] YOU POST A SUPPORT QUESTION HERE READ THROUGH THIS SECTION (this is from the Image Handler readme file):

Troubleshooting Basics [/FONT] [FONT=Tahoma]
[/FONT][FONT=Tahoma]Make sure your custom template is active. (Admin > Tools > Template Selection)
[/FONT][FONT=Tahoma]
Make sure Image Handler 3 is installed. Admin > Tools > Image Handler3 > Admin. Set permissions in both your images and bmz_cache folders to 755 (eg: both of these folders need to have the same permissions. For some webhosts you may have to set these permissions to 777).
[/FONT][FONT=Tahoma]
If Image Handler 3 does not work or gives you errors:
[/FONT]

• [FONT=Tahoma]Make sure all files are in correct location[/FONT]
• [FONT=Tahoma]Make sure you uploaded ALL the Image Handler 3 files [/FONT]
• [FONT=Tahoma]Make sure the files are not corrupt from bad FTP transfers[/FONT]
• [FONT=Tahoma]Make sure your file merge edits are correct[/FONT]
• [FONT=Tahoma]MAKE SURE YOU RE-READ THE CONFIGURATION AND USAGE SECTIONS!!![/FONT]
• [FONT=Tahoma]Make sure that there are no javascript conflicts from other programs[/FONT]
• [FONT=Tahoma]Make sure that your main product image files names DO NOT contain any special characters
  ie: non-alphanumeric characters such as
  / \ : ! @ # $ % ^ < > , [ ] { } & * ( ) + =
  
  Always use proper filenaming practices when naming your images - See this document as a reference: [/FONT][FONT=Tahoma]http://www.records.ncdcr.gov/erecords/filenaming_20080508_final.pdf\[/FONT]

[FONT=Tahoma]When posting bugs/issues about[/FONT][FONT=Tahoma]Image Handler 3, it's a WHOLE LOT more helpful to resolve them if you post details. Just saying "it's broken" or "doesn't work" does not provide nearly enough information to help YOU resolve YOUR issue.

Please provide as MUCH information as possible including:
[/FONT]

• [FONT=Tahoma]The version of Zen Cart you are running[/FONT]
• [FONT=Tahoma]The version of Image Handler 3 you are running (you can see this by going to “Admin > Tools > Image Handler3” – the version is displayed in the upper left hand side)[/FONT]
• [FONT=Tahoma]Any other add-ons you may have also installed[/FONT]
• [FONT=Tahoma]Hosting/server information (PHP versions, mySQL versions, hosting provider etc)[/FONT]
• [FONT=Tahoma]The EXACT error/issue you are experiencing [/FONT]
• [FONT=Tahoma]AND if you're REALLY detail oriented, tell us the install sequence/method you used to install Image Handler 3.[/FONT]
• [FONT=Tahoma]Post a link (not a screen print) to a specific product/product listing page where the issue you are experiencing can be seen (Please DO NOT make folks fish through your site looking for an example of your issue)
  
  AND this last point is important.. The volunteers who help here need to SEE what you see LIVE. A screenprint really isn’t good enough.[/FONT]

[FONT=Tahoma]
[/FONT] [FONT=Tahoma]And a (gentle) reminder about FREE forum support:
[/FONT][FONT=Tahoma]This is ain’t Microsoft folks!
(a frequently used analogy by some to compare open source projects to commercial projects)

[/FONT] [FONT=Tahoma]Like other open source projects, this support forum is manned by VOLUNTEERS (ie: unpaid folks). They are not OBLIGATED to assist here, but they do so because they WANT to. They give of their time here when their individual schedules permit. Usually the response is pretty quick 'round these parts, but when it’s not or your question has gone unanswered this may mean one of a few things:
[/FONT]

• [FONT=Tahoma]NO ONE has an answer to your question/issue.
  (Some folks will only respond when they have something MEANINGFUL to say versus a blanket “I don’t know how to do that” kind of answer.)[/FONT]
• [FONT=Tahoma]Folks are just busy and will answer if/when they can..
  (family and other personal obligations, day jobs, paid jobs, etc will usually trump forum participation – this is to be expected – after all it’s unrealistic to expect that folks are sitting around this forum all day and night waiting to answer questions)[/FONT]
• [FONT=Tahoma]Your question got missed. (and while I’m on this point) Your post MIGHT have been missed if your post is now a FEW pages back (like more than TWO or more pages) with no response.. Missed does NOT mean “it’s been an hour and no one responded to my question, so let me 'bump' the thread by re-posting my question again” [/FONT]

[FONT=Tahoma]
[/FONT] [FONT=Tahoma]Anyway.. carry on.. Enjoy the new version..
[/FONT]

[DivaVocals]

[FONT=Tahoma]Zen Cart and Image Management
[/FONT][FONT=Tahoma]Image Handler 3 is meant to ease the work required to setup images for your store.. It works WITH default Zen Cart functionality, it does not replace it.. Here's some additional FAQs which discuss how product images work in Zen Cart.
[/FONT]

• [FONT=Tahoma]Image Preparation - How-to[/FONT]
• [FONT=Tahoma]My images are distorted/fuzzy/squished, help?[/FONT]

[FONT=Tahoma]Information on how Zen Cart identifies/manages additional product images can be found on these Zen Cart FAQs:
[/FONT]

• [FONT=Tahoma]Why am I seeing images for other products on my product pages?[/FONT]
• [FONT=Tahoma]How do I add multiple images to a product?[/FONT]
• [FONT=Tahoma]How do I add more than one image of a product? I want to have a main image and also one or two other images that show more parts of a particular product. How/where do I add additional images to a product page? Thanks![/FONT]

[FONT=Tahoma]Check out these FAQs and see if they help clarify how Zen Cart works with product images.

Prepare Your Site for Growth [/FONT] [FONT=Tahoma]
[/FONT][FONT=Tahoma]Not many users are aware that Image Handler 3 can manage the needs of a very large site as easily as it does a small one. When first building a site, the owner of a small site needs only to load images to the images folder. But when the site gets bigger and images multiply like rabbits, this can cause file naming confusions for Zen Cart and slow down the site. Preparing for your business to grow from the beginning will save you hours of work later on!
[/FONT][FONT=Tahoma]
Without Image Handler 3 installed, Zen Cart requires you to create, optimize, and upload three different size images for each image you want to use. You must name these images using naming suffixes, and place them in corresponding folders inside your main image folder. For example: A product called "Widget" requires images/widget.jpg (small image) images/medium/widget_MED.jpg (medium image) and images/large/widget_LRG.jpg. This is such a hassle, especially if many of your products have multiple images. And as your site grows, it becomes an impossible task!
[/FONT]
[FONT=Tahoma]With Image Handler 3, you no longer have to make three sizes of the same images and place them in different folders (unless you want to)! Instead, you need upload only one image in one folder and Image Handler 3 will do the rest! Simply upload your largest highest quality image and Image Handler 3 will resize and optimize your image as needed, and serve up small, medium, or large image sizes appropriate to the page loaded - all automatically and all without actually modifying your original image file in any way! Check out the Configuration Tab of this ReadMe for more info about this awesome functionality!
[/FONT]
[FONT=Tahoma]Prepare your site for growth by simply creating sub-folders in your main images folder. For example, you may want to put all your "widget" images in a folder called "widgets" and all your doodad images in a folder called "doodads" , like this:
[/FONT][FONT=Tahoma]Product: Blue Widget with 3 images
----------------------------------
/images/widgets/blue_widget1.jpg (main product image for a blue widget, i.e. front view)
/images/widgets/blue_widget2.jpg (additional product image for a blue widget, i.e. side view)
/images/widgets/blue_widget3.jpg (additional product image for a blue widdget, i.e. rear view)
[/FONT][FONT=Tahoma]Product: Red Widget with 1 image
--------------------------------
/images/widgets/red_widget.jpg (main product image for a red widget)
[/FONT][FONT=Tahoma]Product: Gold Doodad with 2 images
----------------------------------
/images/doodads/gold_doodad1.jpg (main product image for a gold doodad, i.e. view from above)
/images/doodads/gold_doodad2.jpg (additional product image for a gold doodad, i.e. view from side)
[/FONT][FONT=Tahoma]Product: Silver Doodad with 3 images
------------------------------------
/images/doodads/silver_doodad1.jpg (main product image for a silver doodad, i.e. product)
/images/doodads/silver_doodad2.jpg (additional product image for a silver doodad, i.e. product detail)
/images/doodads/silver_doodad3.jpg (additional product image for a silver doodad, i.e. product's silver stamp)
[/FONT]
[FONT=Tahoma]Using Image Handler 3, you can easily sort and manage thousands of images without confusion or hassle! When selecting the main image for a product in the Image Handler 3 interface, Image Handler 3 lets you pick the location for this image. This prompt disappears afterwards because Image Handler 3 knows that additional images need to be in the same folder as their main product image and handles that automatically![/FONT]

[DivaVocals]

What doesn't work? Please be more specific!!

Hey guys just install version 3. Can't seem to work

http:// q isahn . com

EXACTLY.. cybertai I see you read my previous post on the IH2 thread (which is why you are now correctly posting your question here)

BUT

you still have not provided ANYTHING that helps us understand your issue..

Help us help you.. This is from PAGE ONE of this support thread.. It's also in the readme.. Did you try any of the troubleshooting tips??? If not review this and the readme and after you've tried troubleshooting this based on the information we've provided, provide some DETAILS of your issue..

[FONT=Tahoma]BEFORE[/FONT][FONT=Tahoma] YOU POST A SUPPORT QUESTION HERE READ THROUGH THIS SECTION (this is from the Image Handler readme file):

Troubleshooting Basics [/FONT] [FONT=Tahoma]
[/FONT][FONT=Tahoma]Make sure your custom template is active. (Admin > Tools > Template Selection)
[/FONT][FONT=Tahoma]
Make sure Image Handler 3 is installed. Admin > Tools > Image Handler3 > Admin. Set permissions in both your images and bmz_cache folders to 755 (eg: both of these folders need to have the same permissions. For some webhosts you may have to set these permissions to 777).
[/FONT][FONT=Tahoma]
If Image Handler 3 does not work or gives you errors:
[/FONT]

• [FONT=Tahoma]Make sure all files are in correct location[/FONT]
• [FONT=Tahoma]Make sure you uploaded ALL the Image Handler 3 files [/FONT]
• [FONT=Tahoma]Make sure the files are not corrupt from bad FTP transfers[/FONT]
• [FONT=Tahoma]Make sure your file merge edits are correct[/FONT]
• [FONT=Tahoma]MAKE SURE YOU RE-READ THE CONFIGURATION AND USAGE SECTIONS!!![/FONT]
• [FONT=Tahoma]Make sure that there are no javascript conflicts from other programs[/FONT]
• [FONT=Tahoma]Make sure that your main product image files names DO NOT contain any special characters
  ie: non-alphanumeric characters such as
  / \ : ! @ # $ % ^ < > , [ ] { } & * ( ) + =
  
  Always use proper filenaming practices when naming your images - See this document as a reference: [/FONT][FONT=Tahoma]http://www.records.ncdcr.gov/erecords/filenaming_20080508_final.pdf\[/FONT]

[FONT=Tahoma]When posting bugs/issues about[/FONT][FONT=Tahoma]Image Handler 3, it's a WHOLE LOT more helpful to resolve them if you post details. Just saying "it's broken" or "doesn't work" does not provide nearly enough information to help YOU resolve YOUR issue.

Please provide as MUCH information as possible including:
[/FONT]

• [FONT=Tahoma]The version of Zen Cart you are running[/FONT]
• [FONT=Tahoma]The version of Image Handler 3 you are running (you can see this by going to “Admin > Tools > Image Handler3” – the version is displayed in the upper left hand side)[/FONT]
• [FONT=Tahoma]Any other add-ons you may have also installed[/FONT]
• [FONT=Tahoma]Hosting/server information (PHP versions, mySQL versions, hosting provider etc)[/FONT]
• [FONT=Tahoma]The EXACT error/issue you are experiencing [/FONT]
• [FONT=Tahoma]AND if you're REALLY detail oriented, tell us the install sequence/method you used to install Image Handler 3.[/FONT]
• [FONT=Tahoma]Post a link (not a screen print) to a specific product/product listing page where the issue you are experiencing can be seen (Please DO NOT make folks fish through your site looking for an example of your issue)
  
  AND this last point is important.. The volunteers who help here need to SEE what you see LIVE. A screenprint really isn’t good enough.[/FONT]

[FONT=Tahoma]
[/FONT] [FONT=Tahoma]And a (gentle) reminder about FREE forum support:
[/FONT][FONT=Tahoma]This is ain’t Microsoft folks!
(a frequently used analogy by some to compare open source projects to commercial projects)

[/FONT] [FONT=Tahoma]Like other open source projects, this support forum is manned by VOLUNTEERS (ie: unpaid folks). They are not OBLIGATED to assist here, but they do so because they WANT to. They give of their time here when their individual schedules permit. Usually the response is pretty quick 'round these parts, but when it’s not or your question has gone unanswered this may mean one of a few things:
[/FONT]

• [FONT=Tahoma]NO ONE has an answer to your question/issue.
  (Some folks will only respond when they have something MEANINGFUL to say versus a blanket “I don’t know how to do that” kind of answer.)[/FONT]
• [FONT=Tahoma]Folks are just busy and will answer if/when they can..
  (family and other personal obligations, day jobs, paid jobs, etc will usually trump forum participation – this is to be expected – after all it’s unrealistic to expect that folks are sitting around this forum all day and night waiting to answer questions)[/FONT]
• [FONT=Tahoma]Your question got missed. (and while I’m on this point) Your post MIGHT have been missed if your post is now a FEW pages back (like more than TWO or more pages) with no response.. Missed does NOT mean “it’s been an hour and no one responded to my question, so let me 'bump' the thread by re-posting my question again” [/FONT]

[FONT=Tahoma]
[/FONT] [FONT=Tahoma]Anyway.. carry on.. Enjoy the new version..
[/FONT]

[cybertai]

Heeh sorry guys.. just frustrated after hours to trying to get it work. IH3 was installed, but looking at the site, it is still loading the hi-res images ... the images did not get cache.

• Permission - checked
• File Uploaded - checked
• Proper image name - checked

Zen Cart v1.3.9h/v1.3.9e : Image Handler3 Version: v3.0

I've read through all documentation, did everthing. Re-do everything .. yet its loading the full image instead of on-the-fly resize

[DivaVocals]

[FONT=Tahoma]Post a link (not a screen print) to a specific product/product listing page where the issue you are experiencing can be seen (Please DO NOT make folks fish through your site looking for an example of your issue)[/FONT]

Heeh sorry guys.. just frustrated after hours to trying to get it work. IH3 was installed, but looking at the site, it is still loading the hi-res images ... the images did not get cache.

• Permission - checked
• File Uploaded - checked
• Proper image name - checked

Zen Cart v1.3.9h/v1.3.9e : Image Handler3 Version: v3.0

I've read through all documentation, did everthing. Re-do everything .. yet its loading the full image instead of on-the-fly resize

[tony r]

Hi, not sure this is the proper place for this, if not remove it. Seems to be lots of problems resizing images to the proper size without buying photoshop or some other expensive program. I found and use a free program from sourceforge called photoscale. You can make your base images any size needed to load into IH3. One at a time or a folder full. P.S.- I LOVE IH3!!

[cybertai]

[FONT=Tahoma]Post a link (not a screen print) to a specific product/product listing page where the issue you are experiencing can be seen (Please DO NOT make folks fish through your site looking for an example of your issue)[/FONT]

Sorry about that. Here's the link to product listings.:
http://www.qisahn.com/sony-playstati...onsole-c-33_34

And here's a link to product page:
http://www.qisahn.com/sony-playstati...rt-only-p-1598

As you can see, both the smaller images are not resize, but are hi-res images.

And the product list somehow has got 2 hover images.

[DarkAngel]

Heeh sorry guys.. just frustrated after hours to trying to get it work. IH3 was installed, but looking at the site, it is still loading the hi-res images ... the images did not get cache.

• Permission - checked
• File Uploaded - checked
• Proper image name - checked

Zen Cart v1.3.9h/v1.3.9e : Image Handler3 Version: v3.0

I've read through all documentation, did everthing. Re-do everything .. yet its loading the full image instead of on-the-fly resize

mine did that on 1 image too and all I did was open it in Photoshop then resave it "save for web" then replace it on the server and it behaved...not sure why it did it but that worked for me.

Aside from that no other program is really needed to resize images...just create them...lol

I see your IH3 is working on the sidebox image is it behaving elsewhere?

[DivaVocals]

mine did that on 1 image too and all I did was open it in Photoshop then resave it "save for web" then replace it on the server and it behaved...not sure why it did it but that worked for me.

Aside from that no other program is really needed to resize images...just create them...lol

I see your IH3 is working on the sidebox image is it behaving elsewhere?

It would help if cybertai would post a link to a specific place where there is an issue and provide some better details as to what it is he thinks is not working.. It would help to SEE what he sees so folks can get a better sense of the problem... (versus rooting around his whole site guessing at stuff) Frankly based on what's been posted so far, I'm not fully clear as to what is the issue..