View Full Version : Integration with vBulletin - Lytebox Intergration. Allows image groups, slideshows and works with embeded images.

21 May 2008, 11:10
This mod has be made redundant by The Image Resizer (http://www.vbulletin.org/forum/showthread.php?t=184571) by TCattitude. So, I no longer support it and recommend you use his plugin instead, it's much better!

This isn't the best mini-mod out there, and I'm not even sure if it's technically a mod. It's closer to a "how to" document than a mod. This works better than most of the proper Lytebox mods out there as it allows image grouping or slideshows (can't have both) and works with images embeded in posts (using ATTACH BBcode, or the little paper clip) . I'm not sure if it works with images in signatures, try it out and let me know. It does not do anything to images embedded using the IMG BBcode (it only works on images linked to by a thumbnail).

LIVE DEMO: Here (http://forums.popmag.com.au/showthread.php?p=37#post37). Note that I am using the image group feature instead of the slideshow feature.

Anyway, here it is.

If you would like to get Lytebox working with vB 3.7.0 (this should work with other versions, but this is all I have tested it on). You need to do the following.

1) Download latest version of Lytebox here (http://www.dolem.com/lytebox/).

2) Edit lytebox.js to your desired settings (can just leave as default if you want).

3) Edit lytebox.css using a find-and-replace tool (even Notepad will do this). You need to swap all the words: images for: ../images/lytebox4) Upload lytebox's images folder to "/images/lytebox" using FTP.

5) Upload lytebox.js and lytebox.css to "/clientscript" using FTP.

6) In AdminCP, go to Styles & Templates>Replacement Variable Manager and create a new replacment variable. Set it to replace: rel="Lightbox" with: rel="lytebox"If you want to use the image group feature then replace rel="Lightbox" with: rel="lytebox[group]" This will make all attached/embeded images in the one thread display in lytebox as a group (I am still working on how to make only images from the one post group).

If you want to use the lyteshow feature then replace rel="Lightbox" with: rel="lyteshow[group]" This will make all attached/embeded images in the one thread display in lytebox as a slidshow (I am still working on how to rhis with only images from the one post ). 7) In AdminCP, go Style Manager>Edit Templates>Show Thread Templates>SHOWTHREAD. Click Customize (or Edit) and replace the following code:

<if condition="$show['lightbox']">
<!-- lightbox scripts -->
<script type="text/javascript" src="clientscript/vbulletin_lightbox.js?v=$vboptions[simpleversion]"></script>
<script type="text/javascript">
vBulletin.register_control("vB_Lightbox_Container", "posts", $vboptions[lightboxenabled]);
<!-- / lightbox scripts -->
</if>with this code:

<if condition="$show['lightbox']">
<!-- lightbox scripts -->
<script type="text/javascript" language="javascript" src="clientscript/lytebox.js"></script>
<link rel="stylesheet" href="clientscript/lytebox.css" type="text/css" media="screen" />
<!-- / lightbox scripts -->
</if>8) You need to move the above code into the head section of the SHOWTHREAD template. To do this, you simply cut it and paste it right above the <HEAD> tag.

9) Repeat steps 7 and 8 for the SHOWTHREAD_SHOWPOST template. You can find this template by going into Style Manager>Edit Templates>Show Thread Templates>SHOWTHREAD_SHOWPOST. This will get lytebox working on the individual post page.

10) In AdminCP you need to turn on thumbnails and Lightbox (note that it refers to Lightbox, not lytebox. This is OK). You can do this in the AdminCP at vBulletin Options>Message Attachment Options.

11) Make sure that your images aren't set to load in a New Window. You can change this in the AdminCP at Attachments>Attachments Manager.

12) To enable images embedded using the IMG tag to be resized and enlarged using lytebox, you need to install JASE2's Image Resizer (http://www.vbulletin.org/forum/showthread.php?t=176531) plugin from here and make some code changes.Make sure you you set Image Resizer to enlarge images in a new window. You do this in AdminCP vBulletin Options>Image Resizer Options>Default Resize Mode and set it to "Open in new window". You also need to set the size you want the IMG embedded images resized to (I set them to the same as my thumbnail settings).
13) Using FTP, browse to /includes/ and edit the following line of PHP code in the file "class_bbcode.php".

return '<img src="' . $link . '" border="0" alt="" />';change to:

return '<a target="_blank" href="' . $link . '" rel="lytebox[group]"><img src="' . $link . '" border="0" alt="" /></a>';NOTE: If you want to use the slideshow feature, simply use rel="lyteshow[group]" rather than rel="lytebox[group]".

14) To remove the yellow warning box from images embedded using IMG tags, add the following CSS to your style.

.ncode_imageresizer_warning {
display: none;

Provides a way to resize images embedded using IMG. It's not perfect, but it works in the meantime.

Works when viewing a single post.
Allows for slideshows using lyteshow.

Thanks to Andy Huang (http://www.vbulletin.com/forum/member.php?u=42534) from the vB team.
Thanks to Lost Heaven (http://www.vbulletin.org/forum/member.php?u=199366) for coming up with the code I used in step 13.
Of course, thanks to Markus F. Hay (http://www.dolem.com/lytebox/) for Lytebox.

21 May 2008, 12:00
what is demo or caps ?

21 May 2008, 12:08
Sorry, I don't understand what your referring too.

21 May 2008, 12:11
Whats the difference between this and the Image resizer using lytebox hack/mod ?


21 May 2008, 12:26
My mod works for images that are embedded in a post, it also allows images to be grouped or displayed in as a slide show. Image Resizer does not do these things.

It does not allow resizing images to a set dimension, but it does auto resize images if they are larger than the viewers screen dimensions.

21 May 2008, 12:27
awesome would there be any future update to allow the resizing of images for a specific set dimension?

21 May 2008, 14:02
If I understand you correctly, and correct me if I'm wrong, but I don't see how that would be any different than what you can do in vB already. Just set the maximum image size to whatever you want it to be in the Attachment Manager (I have attached a screenshot of my recommended settings). Then in vBOptions>Message Attachment Options set the following:

Resize Images: Yes
View Attached Images Inline: Yes
Thumbnail Creation: Yes
Thumbnail Size: 180 (Or whatever you want)

This will mean the end result is that every image attached is displayed by a thumbnail and when clicked on, it will expand with Lytebox to be the size you set in Attachment Manager, which in my case is 1000px wide. If the end user has a screen resolution smaller than 1000px wide, then it automatically down sizes it. What else would you need to do? Setting Lytebox to auto scale images can be achived by changing the size restraints in Attachment Manager.

Keep in mind that Lytebox (so, any plugin based on it ) doesn't actually resize the image file, it just scales it. If you've been running a board for a while now and want to resize all the old images that have been uploaded, any plugin based on Lytebox isn't going to help you reduce the actual image size. All they can do is scale images for the end user, or if combined with a proper PHP based image resizer, replicate the features already in vBulletin board.

That being said, I did not code this plugin. I just compiled a step-by-step on how to intergrate an exsisting web app into vBulletin. So, no I won't be releasing a version that can resize images to a certian size, as I don't see how that's any different than what vBulletin allows you to do already (and I don't know that much about coding).

21 May 2008, 22:55
does it work for 3.6.10? :rolleyes:

22 May 2008, 04:02
I'm not sure, I don't see why not. As long as the templates work the same. Give it a try. Do a backup before though, just to be safe. Like I siad in my post above, I've only used it in 3.7.0. I actually only started using vBulletin about a week ago, so I'm not really the guy to ask about these things. I just made this little mod becuase I really needed Lytebox to wrok properly.

Wayne Luke
22 May 2008, 18:16
does it work for 3.6.10? :rolleyes:
3.6.10 doesn't have Lightbox functionality by default so it won't find the replacements and set the relations properly.

DoB Rhapsody
22 May 2008, 21:37
demo please..

23 May 2008, 14:19
LIVE DEMO: Here (http://forums.popmag.com.au/showthread.php?p=37). Note that I am using the image group feature instead of the slideshow feature.

23 May 2008, 20:09
how can i set a comment for evey image, please?

Demo here:

23 May 2008, 20:31
Very nice this hack, i like it, congrat :)

23 May 2008, 20:53
just what i was looking for thanks!

DoB Rhapsody
23 May 2008, 21:53
LIVE DEMO: Here (http://forums.popmag.com.au/showthread.php?p=37). Note that I am using the image group feature instead of the slideshow feature.

ok, great. I'll definitely install this when it works for the IMG tag.

24 May 2008, 01:53
ok, great. I'll definitely install this when it works for the IMG tag.
Waiting for IMG too :) Thanks D.Baker!

24 May 2008, 09:36
Thanks for the feedback guys. I have contacted JASE2 of Image Resizer (http://www.vbulletin.org/forum/showthread.php?t=176531) to see if it's possible for him to support vb 3.70's inbuilt version of Lightbox, or even better, for us to merge our two modes together.

If he supports vB's Lightbox with the "open in new window" feature of his plugin, I'm pretty sure that my mod will then work with his, as it replaces all Lightbox calls with lytebox, so I'm pretty sure it would work. Otherwise, I am stumped. I don't know enough about JavaScript to edit his plugin to ad the necessary rel="lytebox" tags on his open in new window commands. I have tried messing around with it, but I couldn't get it working. I haven't heard anything back from him yet. I'll keep you posted. If he does get back to me, this plugin will be the ultimate lightbox plugin.

As for getting all images in a single post to group, I posted a support request here (http://www.vbulletin.com/forum/showthread.php?p=1568760), but haven't heard anything back yet. If anyone knows the answer, please let me know.

24 May 2008, 10:32
OK, I figured out how to get it to resize images embedded using IMG tags! :D

It's not perfect. It requires another plug (which you might already be using). It also removes the images paddings, so they sit right on top of each other. But its prett close to working perfect.

Let me know what you think, and if you can see a better way of doing it. I'd love to know.

24 May 2008, 11:31
Fantastic!! Now it is really perfect. Thank you for your efforts.

24 May 2008, 15:35
If you'd prefer to remove the warning tabs permanently, you can do it by commenting out (put a // in front of the code) lines 111 to 149 in Image Resizer's, "ncode_imageresizer.js" file although I'm not sure how legal that is due to copyrights.

My mod/hack/whatever isn't perfect yet. The Image Resizer plugin is not at all xhtml valid (but then again, neither is vBulletin) which bugs me (I like to know I've done it 100% right). Also, there should be a margin of 2px around the images, but I can't get Image Resizer to accept inline styles (like vB applies to all attached images). I just don't know enough about JavaScript.

The other thing is, I hate having to edit edit templates enough, and I personally draw the line at editing core files outside of the vB AdminCP. So I have decided that personally won't use the method described in step 13. I'm just going to have those images non-lyteboxed untill I figure something else out. There are two reasons for this. Firstly, any vB updates in the future to that file will remove that code, and secondly, it's not xhtml valid and the code it generates is messy (which is even more messy thanks to Image Resizers invalid code).

Hopefully JASE gets back to me (or someone else who knows JavaScript) about tweaking his file to include a rel=lytebox[group] tag in the image embed code.

But for people who don't care about those kinds of things, this mod works pretty close to perfect (everything except the 2px margin IMG embeds) for embedding images using ATTACH, IMG and by attaching images to a post. It will display lyteshows or grouped images.

25 May 2008, 12:12
I there. Is there any way to increase the size of the images in lytebox? What i mean is when we click the image it won't get the original size so, consequently, the image looses some quality. I have my image permissions to allow 1024*1024 images (in attachments). Thanks.

25 May 2008, 14:03
Hey pedroenf, you set that in lytebox.js.

There is a line about auto resizing images, set it to false. That will mean images will enlarge to their real size. It's a problem for people with smaller screens, but 1024*1024 is borderline OK.

25 May 2008, 16:04
Thanks D.Baker.

01 Jul 2008, 09:41
Great mod, but one thing I am curious about. I set it up to resize images posted using the IMG tags, BUT how would I get it to NOT include the images members post in their signatures using the IMG tags? So when they want to browse through all images in a thread posted via IMG tags within their posts, it won't include the signature images as well? Any ideas on how to get around that or exclude those?

05 Jul 2008, 04:14
Hey BeerLuver,
That's a tough one. Step 13 is what's causing that. I myself have decided not to use this with the Image Resizer mod because of that very reason (and because I don't like editing core files), meaning I just skipped step 13 and 14See an example of the end result here (http://forums.popmag.com.au/showthread.php?p=37#post37). I've been trying to get Jase2 to get his mod working with Lightbox (http://www.vbulletin.org/forum/showpost.php?p=1528930&postcount=186) (the version that comes with vB) and that way it would also work with this mod (or at least I'd then be able to figure out how to get it working with this mod), but he hasn't done it yet.

So, the way this mod works at the moment is if you want to have IMG images open as a group using lytebox, then your signatures will too. Sorry, I wish I was smarter.

If anyone knows a little about JavaScript I'm sure it would be super easy to tweak Jase2's code to work with my mod, I can help jsut let me know what you need.

05 Jul 2008, 04:43
I'm wondering if there is some type of IF statement that could be used to ignore any images within the signature bits of code? I'm not very code savvy myself, so I wouldn't know how to get that working either heh. Or it'd be nice if the Lytebox could be set to work on individual images; not as a group, so when they click on one image, that's the only image it displays then. That might work for a work-around idea.

06 Jul 2008, 03:56
Hey BeerLuver,
I wish I knew more coding.

As for getting a single image to open rather than a group, that is easy. See step 6 of my hack/mod above.


06 Jul 2008, 08:58
Well, for now, I disabled the IMG bb code in signatures and allowed HTML image linking instead. I know it's not a safer way, but if I wanna use the lytebox with the IMG tag, needed to enable html in sigs and disable the img tag in sigs cause otherwise, if ya clicked on a linked image in someone's sig... it's only open that image in lytebox, and not actually open the link. I have close moderation of the forums too, so I'm not too concerned for misuse of the signatures with html, and any malicious use of em... automatic permanent ban for that person then heh.

Thanks for all your hard work on this mod though :).

Walter Ronny
08 Jul 2008, 13:51
this will works in the last version 3.7.1?

09 Jul 2008, 07:50
This works easier without any Edits even for Blogs and Albums : The Image Resizer (powered with Lytebox / Highslide) (http://www.vbulletin.org/forum/showthread.php?p=1570706#post1570706) ;)

18 Dec 2008, 00:23
Is there anyway to make it use the lytebox instead of opening up in a new window or tab without having to use the attachment option? If so I would really like some support with this.