Image Handler 4 (for v1.5.x) Support Thread

DivaVocals:

Please review the instructions.. Items 6 & 7 cover these files and their location in the IH4 fileset, and it covers what to do with these files.. Again, if you do NOT have a "/includes/modules/YOUR_TEMPLATE/additional_images.php" file in place after installing IH4, then you do not have this installed correctly..

(copy ALL of the add-on files to your store!! Most issues are caused by store owners who decide to NOT load ALL of the module files)

Just installed this on my test site.. Please note the message which refers to the creation of the "/includes/modules/YOUR_TEMPLATE/additional_images.php" file

Image Handler files all exist in correct positions in the directory structure. |

CORE FILE OVERWRITE : /home2/overthe4/public_html/zentestcart/YOUR_ADMIN/includes/modules/category_product_listing.php was overwritten. A back up copy was saved. |

CORE FILE OVERWRITE : /home2/overthe4/public_html/zentestcart/includes/modules/pages/popup_image/header_php.php was overwritten. A back up copy was saved. |

CORE FILE OVERWRITE : /home2/overthe4/public_html/zentestcart/includes/modules/pages/popup_image_additional/header_php.php was overwritten. A back up copy was saved. |

TEMPLATE FILE CREATE : /home2/overthe4/public_html/zentestcart/includes/modules/custom_template/additional_images.php was created. A back up copy of any overwritten file was saved. |

TEMPLATE FILE CREATE : /home2/overthe4/public_html/zentestcart/includes/modules/custom_template/main_product_image.php was created. A back up copy of any overwritten file was saved. |

TEMPLATE FILE CREATE : /home2/overthe4/public_html/zentestcart/includes/templates/custom_template/css/style_imagehover.css was created. A back up copy of any overwritten file was saved. |

TEMPLATE FILE CREATE : /home2/overthe4/public_html/zentestcart/includes/templates/custom_template/jscript/jscript_imagehover.js was created. A back up copy of any overwritten file was saved. |

TEMPLATE FILE CREATE : /home2/overthe4/public_html/zentestcart/includes/templates/custom_template/popup_image_additional/tpl_main_page.php was created. A back up copy of any overwritten file was saved. |

Image Handler has been successfully installed |

Again, if you are not seeing this file after your IH4 install is complete, then that tells me that IH4 is probably not installed correctly.. But I don't know how that's possible since it would give you an error message if the files is not created..

@fanisme

If you did not add a custom template to your installation then YOUR_TEMPLATE or CUSTOM_TEMPLATE would be classic.

When you see YOUR_TEMPLATE, CUSTOM_TEMPLATE, etc used in the forum or a mod's instructions, it is used to represent whatever template you are using. You can quickly find out what YOUR_TEMPLATE is by opening your home page, right-click somewhere and view page source. On 1.5.1 around line 15, you'll start seeing a lot of link rel="stylesheet" calls. Look at the one for stylesheet.css. If you have a custom template, it would look like "includes/templates/******/css.stylesheet.css. If there is nothing where the asterisks are, you are not using a custom template. If there IS something where the asterisks are, then that is YOUR_TEMPLATE.

Thank you, guys.
Hi Divavocals, you are right. I made a stupid mistake. Really appreciate your patience.
I just found another question. Do you think there is any conflict between IH and zx_slideshow? I had check this again and again. IH works very well when I didn't install slideshow. After installing slideshow, something wrong happened: can't jump to IH interface through clicking on the small icon on the right column of the product in catalog/categories/product and just one category can be chosen to edit on the IH interface. (exactly the problem that we talked and I showed you a vedio before)

dbltoe:

@fanisme

If you did not add a custom template to your installation then YOUR_TEMPLATE or CUSTOM_TEMPLATE would be classic.

When you see YOUR_TEMPLATE, CUSTOM_TEMPLATE, etc used in the forum or a mod's instructions, it is used to represent whatever template you are using. You can quickly find out what YOUR_TEMPLATE is by opening your home page, right-click somewhere and view page source. On 1.5.1 around line 15, you'll start seeing a lot of link rel="stylesheet" calls. Look at the one for stylesheet.css. If you have a custom template, it would look like "includes/templates/******/css.stylesheet.css. If there is nothing where the asterisks are, you are not using a custom template. If there IS something where the asterisks are, then that is YOUR_TEMPLATE.

With regards to IH4, the auto-install detects the current template and copies the appropriate files to the correct override folders.. but this only works IF the installation instructions are followed and folks don't cherry pick what files THEY think are important..

fanisme:

Thank you, guys.
Hi Divavocals, you are right. I made a stupid mistake. Really appreciate your patience.
I just found another question. Do you think there is any conflict between IH and zx_slideshow? I had check this again and again. IH works very well when I didn't install slideshow. After installing slideshow, something wrong happened: can't jump to IH interface through clicking on the small icon on the right column of the product in catalog/categories/product and just one category can be chosen to edit on the IH interface. (exactly the problem that we talked and I showed you a vedio before)

No clue.. I've never used this slideshow.. If there are files modified by this slideshow that are also modified by IH4, then it's possible that the code for the two needs to be merged properly..

DivaVocals:

With regards to IH4, the auto-install detects the current template and copies the appropriate files to the correct override folders.. but this only works IF the installation instructions are followed and folks don't cherry pick what files THEY think are important..Yep...
Even with the auto-install is used, it appeared that the OP was not familiar with the terminology.> But I really can't find includes/modules/YOUR_TEMPLATE/ untill installed zen lightbox which has includes/modules/YOUR_TEMPLATE/ in its installing folder.

dbltoe:

Yep...
Even with the auto-install is used, it appeared that the OP was not familiar with the terminology.
Yep and that's exactly why I referred the OP back to the original install instructions where this is covered in pretty good detail. But I'm open to ideas if this needs to be worded differently for better clarity..

I installed the image-handler4
How to change the file？
Can be achieved

zch0071:

I installed the image-handler4
How to change the file？
Can be achieved

Since you provided NO DETAILS here, it's hard to answer your question.. Since you are leaving folks to GUESS what you mean by "how to change the file", let me lob a guess answer at you.. if you are asking can you create a slider with Image Handler, the answer is no, and I will kindly refer you to the first post of this support thread or the readme where it is explained what Image Handler does (and more importantly) and does not do.

Hi DV and friends

I was hoping not to have to post here :-( I've read, read again, scratched, read again to be sure, tweaked, uploaded, flicked on, off, etc etc and cannot get this working as expected.

I've installed IH4 using defaults on a developing Zen v1.5.1 install. No conflicts with files of note (one or two that were never modified-overwritten with IH4 versions). Several add-ons installed but nothing directly affecting images yet--seemed wise for IH4 to be the first and base for image related add-ons. IIRC/AFAIK, I'm not using any jscript or such with the add-ons.

Previously (with existing store) I've generated all images and uploaded to respective directories; ../images/nameX../ ../medium/nameX/.. ../large/nameX/.. for each manufacturer and used suffixes; _m, _l for medium and large versions. All .jpg. EP for bulk/mass product manipulation. FTP for images uploads. Almost all products (1'000's) have images and most have multiple images, sometimes up to 10.

For testing purposes on this new v1.5.1 install, I just dumped a few 'handfuls' of the small images for a few manufacturers. All working as expected.

For testing IH4, I have uploaded renamed large images directly to the relative images directory. Full size but no suffix.

Problem scenario 1:

1. No additional images (thumbnails) displayed despite images present - both existing and one or two products where I have specified/uploaded images via IH4 tools (not an option for me going forward, btw - not feasible for the number of images I deal with regularly).
2. Watermark on large image only (should be medium too)
3. No hover effects

Image - Use Proportional Images on Products and Categories = 1

For this test product...

• Full size images (x3) in 'small' directory i.e., ../images/nameX/
• No images of same name/model in 'medium' and 'large' directories.

Now, before you jump... the following configuration setting changes things...

Image - Use Proportional Images on Products and Categories = 0

SAME - Full size images (x3) in 'small' directory i.e., ../images/nameX/
SAME - No images of same name/model in 'medium' and 'large' directories.

1. Additional images present (full size displays on click too)
2. No watermarks
3. No hover effects
4. Medium image reduced quality compared to previous settings (crisp but not smooth lines). Thumbnail images also a little more jagged than expected (crisp but not smooth lines).
5. Medium image on click displays blank pop-up window i.e., no large image.

Other config settings...
Originally had my previous settings for small and medium sizes set (e.g., 100x80, etc) but now have used your example config settings (width only for small, medium and large [1200 for large]) and exactly the same result.

[edit: GD 2.0.34 installed according to server info]

I intended to write up other scenario details but my head is spinning now reproducing the settings and documenting the results.:wacko:

I have my fingers-crossed that you will be able to say 'Oh, flick this and click that... and all will be good', but I don't have much faith in that. ;-)

Cheers
GAM

GAM:

Hi DV and friends

I was hoping not to have to post here :-( I've read, read again, scratched, read again to be sure, tweaked, uploaded, flicked on, off, etc etc and cannot get this working as expected.

I've installed IH4 using defaults on a developing Zen v1.5.1 install. No conflicts with files of note (one or two that were never modified-overwritten with IH4 versions). Several add-ons installed but nothing directly affecting images yet--seemed wise for IH4 to be the first and base for image related add-ons. IIRC/AFAIK, I'm not using any jscript or such with the add-ons.

Previously (with existing store) I've generated all images and uploaded to respective directories; ../images/nameX../ ../medium/nameX/.. ../large/nameX/.. for each manufacturer and used suffixes; _m, _l for medium and large versions. All .jpg. EP for bulk/mass product manipulation. FTP for images uploads. Almost all products (1'000's) have images and most have multiple images, sometimes up to 10.

For testing purposes on this new v1.5.1 install, I just dumped a few 'handfuls' of the small images for a few manufacturers. All working as expected.

For testing IH4, I have uploaded renamed large images directly to the relative images directory. Full size but no suffix.

Problem scenario 1:

1. No additional images (thumbnails) displayed despite images present - both existing and one or two products where I have specified/uploaded images via IH4 tools (not an option for me going forward, btw - not feasible for the number of images I deal with regularly).
2. Watermark on large image only (should be medium too)
3. No hover effects

Image - Use Proportional Images on Products and Categories = 1

For this test product...

• Full size images (x3) in 'small' directory i.e., ../images/nameX/
• No images of same name/model in 'medium' and 'large' directories.

Now, before you jump... the following configuration setting changes things...

Image - Use Proportional Images on Products and Categories = 0

SAME - Full size images (x3) in 'small' directory i.e., ../images/nameX/
SAME - No images of same name/model in 'medium' and 'large' directories.

1. Additional images present (full size displays on click too)
2. No watermarks
3. No hover effects
4. Medium image reduced quality compared to previous settings (crisp but not smooth lines). Thumbnail images also a little more jagged than expected (crisp but not smooth lines).
5. Medium image on click displays blank pop-up window i.e., no large image.

Other config settings...
Originally had my previous settings for small and medium sizes set (e.g., 100x80, etc) but now have used your example config settings (width only for small, medium and large [1200 for large]) and exactly the same result.

[edit: GD 2.0.34 installed according to server info]

I intended to write up other scenario details but my head is spinning now reproducing the settings and documenting the results.:wacko:

I have my fingers-crossed that you will be able to say 'Oh, flick this and click that... and all will be good', but I don't have much faith in that. ;-)

Cheers
GAM
perhaps it's because it's early, but in this very long post I'm not truly clear on what the issue is.. and you haven't provided a link to your site.. (as we suggest ALL the time in this support thread).. I'm not entirely clear on what you mean by "Full size but no suffix". Does this refer to the filename extension or something else..

I gather that there are several issues (watermarks, image hover, image quality issue with medium images, no large popup)

Suggest going back to the readme.. review the configuration and usage tabs.. assuming you have this installed correctly (and since you've provided none of the information suggested in the readme or even on the first page of this post we can only guess that you do have this installed correctly) there are specific configuration settings required for the image hover to work.. There are other settings that may help with the image quality issues. Bottomline it may indeed be a button to "flick". Sounds like your admin settings need to be adjusted, and the usage & configuration tabs will provide the info you need..

DivaVocals:

perhaps it's because it's early, but in this very long post I'm not truly clear on what the issue is..

LOL. No offence intended here, but I'm with you, it is hard to tell exactly what the issue is. This is just GAM's 'style' of bug reporting, it is all perfectly clear in his head, but it doesn't always translate well to the written word, <g>.

DivaVocals:

and you haven't provided a link to your site.. (as we suggest ALL the time in this support thread)..

Fair comment, but unless I'm mistaken, he's currently in the process of doing an upgrade on a non live site, as such, there is no suitable link to be provided.

DivaVocals:

I'm not entirely clear on what you mean by "Full size but no suffix". Does this refer to the filename extension or something else..

This related to ZenCarts 'conventional' image filenames for the different sized images (*_MED, *_LRG), which I admit has me a little confused because I'm under the impression that IH4 negates the need for these anyway.. doesn't it?

DivaVocals:

I gather that there are several issues (watermarks, image hover, image quality issue with medium images, no large popup)

My conclusion was that IH4 simply isn't working. period.

DivaVocals:

Suggest going back to the readme.. review the configuration and usage tabs.. assuming you have this installed correctly (and since you've provided none of the information suggested in the readme or even on the first page of this post we can only guess that you do have this installed correctly) there are specific configuration settings required for the image hover to work.. There are other settings that may help with the image quality issues. Bottomline it may indeed be a button to "flick". Sounds like your admin settings need to be adjusted, and the usage & configuration tabs will provide the info you need..

That was going to be my suggestion too, but I thought I'd wait to see what your input was first.

With respect to GAM, I will add that he's not a novice/noob. He has been using ZenCart for almost as long as I can remember (my wife just laughed, and said its been much longer than my 2 week memory capacity. <g>).

I fear that because of this, there probably isn't much that we can give in the way of specific advice for the problem(s) reported (This is where I was hoping you may have been more helpful than I could). Methinks there is just some fundamental cause, a misplaced file, a javascript conflict, or something of a similar nature that is going to be impossible for us to guess at, in which case, yes, its back to the readme and/or repeating the install until it does work.

GAM, FWIW, I have also had similar issues in the past with some IH installations. I know how frustrating it can be, but I don't think I've ever come across the same problem more than once... IOW, each time, the cause has been some minor thing that I'd overlooked or missed during the install.
The idea that it could be a 'Oh, flick this and click that' is a very good one, but as an old 'nemesis' used to frequently say 'It aint that simple'.

Cheers
Rod

Good moanin'

LOL, perhaps it was because it was late (GMT+10 here) ;-) Apologies for the somewhat confusing/unclear post. I was tackling that post at the end of (another) very long day following round upon round of read, reread, tweak, etc. :blink:

Thank you both for responding.

I have stock coming in and a load of orders to deal with this morning but I hope to get back to it ASAP and will read again with clearer mind and perform the necessary installation and configuration steps.

Rod is very astute and knows me well. We have worked on Ozpost together at different times for a very long time. Thanks for your input and assistance Rod. And yes, you are correct... mostly; IH4 isn't working properly and the site is currently 'down for maintenance'.

For clarity, Image - Use Proportional Images on Products and Categories setting effects results as follows:

Image - Use Proportional Images on Products and Categories = 1

1. No additional images (thumbnails) displayed
2. Watermark on large image only (should be medium too)
3. No hover effects

Image - Use Proportional Images on Products and Categories = 0

1. Additional images displayed (full size displays in pop-up)
2. No watermarks
3. No hover effects
4. Medium image quality not good
5. Medium image on click displays blank pop-up window i.e., no large image.

All other config settings as per Readme example.

Ignoring the above for now if necessary, please answer the following:

The readme states that IH4 works with Easy Populate and also works with an existing store, not affecting/modifying any existing images. My questions are:

1. Does IH4 regenerate images where they exist already? (I thought so)

2. How does it determine which image to use for IH4 'default' image given zen-cart image directory structure:

• store/images/my_manufacturer = small images with filename no suffix
• store/images/medium/my_manufacturer = medium images with filename and '_m' suffix
• store/images/large/my_manufacturer = large images with filename and '_l' suffix
  [where, in my case, filename = model number]

Cheers
GAM

GAM:

Ignoring the above for now if necessary, please answer the following:The readme states that IH4 works with Easy Populate and also works with an existing store, not affecting/modifying any existing images. My questions are:1. Does IH4 regenerate images where they exist already? (I thought so)2. How does it determine which image to use for IH4 'default' image given zen-cart image directory structure:- store/images/my_manufacturer = small images with filename no suffix- store/images/medium/my_manufacturer = medium images with filename and '_m' suffix- store/images/large/my_manufacturer = large images with filename and '_l' suffix[where, in my case, filename = model number]CheersGAM1. Regenerate in the sense that IF you replace any of the product images it will re-generate the image in the IH4 image cache.. Regenerate i nthe sense that if you clear (delete/remove) the images in the image cache IH4 will regenerate the image cache images.The STOCK images in the image folder however will NOT be regenerated if you delete it..

2. As the readme instructions state, (as does the first page of this support thread.. and I and others often say..) you DO NOT need to follow the DEFAULT Zen Cart structure for uploading large medium and small images.. UPLOAD THE LARGEST IMAGE and IH4 will take care to create the proper small, and medium images based on your image settings.. This means DO NOT use the medium and large image folders or suffixes or ANY of that..

Please do read through the read me usage tab.. It REALLY does explain in DETAIL how the image uploda works and other variations that IH supports (for example small image is one picture, while large image is a DIFFERENT image)

RodG:

LOL. No offence intended here, but I'm with you, it is hard to tell exactly what the issue is. This is just GAM's 'style' of bug reporting, it is all perfectly clear in his head, but it doesn't always translate well to the written word, <g>.

Thanks for confirming that it wasn't because I needed coffee!!!:laugh:

RodG:

Fair comment, but unless I'm mistaken, he's currently in the process of doing an upgrade on a non live site, as such, there is no suitable link to be provided.

Fair enough.. OP just needed to make that clear when posting going forward.. It's the first thing EVERYONE asks as you know!!:laugh:

RodG:

This related to ZenCarts 'conventional' image filenames for the different sized images (*_MED, *_LRG), which I admit has me a little confused because I'm under the impression that IH4 negates the need for these anyway.. doesn't it?

You sir are correct!! and thanks for the clarification.. I hear "suffix" and I think .jpg, .png..

RodG:

With respect to GAM, I will add that he's not a novice/noob. He has been using ZenCart for almost as long as I can remember (my wife just laughed, and said its been much longer than my 2 week memory capacity. <g>).Got it.. We'll work it all out.. (you can translate when needed..:laugh:)

Hi

I've identified the problem... active template not set correctly. Sorry for wasting everyone's time. :( Hopefully this helps someone else out in the future in similar circumstances.
[Interesting though how some IH functions were activated/deactivated by the Image - Use Proportional Images on Products and Categories configuration setting]

I'm not used to having more than one template on my site and somehow managed to have 'English' set to the new template and Default(All) set to the old one. :frusty:

Preliminary testing indicates that IH4 is now functioning correctly on my site. There are some other curious little quirks that I need to investigate but probably my fault again.

Thank you Diva Vocals for your assistance and answers. I did have to ask the question regarding how IH4 handles existing images as it was unclear to me from the information provided in the readme. If it is stated there, I didn't notice and I apologise if I simply overlooked it. What I have noticed from testing and the results is that IH4 seems to use my primary images in my defined 'large' directory over any other images [small, medium] present for the same product. I'm wondering what it will do if I upload a low res image to my 'large' directory and a higher res image to my 'medium' directory... or if this case was present prior to IH4 being installed.

Your answer to question 2 was a good reminder but mostly out of context, which was... how does IH4 deal with 'existing' images.

From the point of view of someone that has been using default Zen-Cart image directory structures and methods for some time and no prior Image Handler experience, I feel that a little more detail could be provided in the readme on:

a. How IH4 processes images already existing on a site
b. Usage general practice for uploading bulk images (not using Image Handler admin tools). [Thorough details, explanations and instructions are provided for using the admin tools and dealing with images one at a time.]

Cheers
GAM

GAM:

Thank you Diva Vocals for your assistance and answers. I did have to ask the question regarding how IH4 handles existing images as it was unclear to me from the information provided in the readme. If it is stated there, I didn't notice and I apologise if I simply overlooked it. What I have noticed from testing and the results is that IH4 seems to use my primary images in my defined 'large' directory over any other images [small, medium] present for the same product. I'm wondering what it will do if I upload a low res image to my 'large' directory and a higher res image to my 'medium' directory... or if this case was present prior to IH4 being installed.

Your answer to question 2 was a good reminder but mostly out of context, which was... how does IH4 deal with 'existing' images.

From the point of view of someone that has been using default Zen-Cart image directory structures and methods for some time and no prior Image Handler experience, I feel that a little more detail could be provided in the readme on:

a. How IH4 processes images already existing on a site
b. Usage general practice for uploading bulk images (not using Image Handler admin tools). [Thorough details, explanations and instructions are provided for using the admin tools and dealing with images one at a time.]

Cheers
GAMThe question of how IH4 handles images already on the site is addressed, and that documentation covers the most common store setups.. Your image setup seems a tad unique and as such is not something I could have REASONABLY foreseen or tested for when testing IH4.. Since this is a volunteer effort please understand that neither I nor anyone who assisted in the testing and documentation of IH4 could POSSIBLY test every possibly variation of a store's image setup. If a community volunteer does want to do this level of testing and provide some insight in this regard, then I am more than happy to include these findings in the IH4 documentation..

There are three bulk image add-ons for Zen Cart and AGAIN, neither I nor anyone who assisted in the testing and documentation of IH4 could POSSIBLY test how IH4 works with each one of these add-ons for EVERY image setup.. What we CAN say (and do cover in the documentation) is that as long as these add-ons save the main image path using Zen Cart standards to the database, then IH4 will pick up the main product image which allows it to create the small and medium images correctly. (and yes volunteers did test this) There's no reason for instructions on usage of bulk product uploaders to be included in the IH4 readme unless the bulk uploader doesn't use standard Zen Cart methods for images.. The bulk uploader of your choice should have detailed usage instructions which guides you for how to properly include images in your bulk uploads and there's NEVER been a reason since IH4 was first created to DUPLICATE their usage instructions in IH4 readme.

GAM:

Hi

I've identified the problem... active template not set correctly. Sorry for wasting everyone's time. :( Hopefully this helps someone else out in the future in similar circumstances.
[Interesting though how some IH functions were activated/deactivated by the Image - Use Proportional Images on Products and Categories configuration setting]

I'm not used to having more than one template on my site and somehow managed to have 'English' set to the new template and Default(All) set to the old one. :frusty:

Preliminary testing indicates that IH4 is now functioning correctly on my site. There are some other curious little quirks that I need to investigate but probably my fault again.IH4 works for normal store setups.. Your setup is unique and therefore as you discovered IH4 appeared to not be working when using a non-standard template setup..

Thanks Diva Vocals

IH4 is a great add-on and something that I've wanted to use for a long time but always put off until I was ready to upgrade to the latest version of Zen... it has taken a few years to get to this point. My existing version of Zen-Cart is very old.

For the sake of clarity; I have never used any image add-ons on my site until now (this IH4 install).

As mentioned in my first post, I generate all three images (small, medium, large), rename with appropriate suffixes (_m, _l) and upload to the appropriate directories on my server. This is what I learned years ago to be 'standard' practice for images with Zen-Cart. I followed the FAQ suggestions at the time, which was to separate small, medium and large images into separate directory structures.

Cheers
GAM

GAM:

Thanks Diva Vocals

IH4 is a great add-on and something that I've wanted to use for a long time but always put off until I was ready to upgrade to the latest version of Zen... it has taken a few years to get to this point. My existing version of Zen-Cart is very old.

For the sake of clarity; I have never used any image add-ons on my site until now (this IH4 install).

As mentioned in my first post, I generate all three images (small, medium, large), rename with appropriate suffixes (_m, _l) and upload to the appropriate directories on my server. This is what I learned years ago to be 'standard' practice for images with Zen-Cart. I followed the FAQ suggestions at the time, which was to separate small, medium and large images into separate directory structures.

Cheers
GAM
Understood.. but just as the IH4 documentation states, IH4 eliminates the need to do this 'tis all I was trying to point out..:smile: