kreacom.dk - Multithumb image plugin for Joomlahttp://www.kreacom.dk/index2.php?option=com_content&task=view&id=82&pop=1&page=0&...1 de 2711/19/07 5:22 PM

Multithumb image plugin for JoomlaMany popup types, gallery, watermarks and much more!

I am away from home October 4-23. In this period I will not be able to reply to mails. You can help both me and yourself by not mailingme until the end of the month. If I come home to a whole lot of new support mails, I will probably never have the time to get throughthem.A new version of Multihumb is expected around November 1.

Multithumb is a multi-purpose image plugin for Joomla that can automatically create thumbnails and popups of the originalimages, as well as resize the full-size images or add a watermark to them. It can even scramble the images names so thatpeople cannot guess their original non-watermark locations.For articles shown in blog mode, it can create a link from the first image to the full article for better user navigation.It can also create a simple photo gallery from any folder by just including one of the images from the folder and give it thedescription (alt text) "mt_gallery" (or using the new tagging feature).Multithumb works with both normal images and {mosimage} images.See the examples and how-to's below for inspiration and instructions!

Processing images takes time!

Please note that when you use Multihumb for the first time on a given page, the server has to process all the images which might take quite some time.This especially applies if you use the gallery function.This processing can lead to various server errors. If the error text says something about

memory size

, try increasing PHP's memory limit using thebackend option "PHP memory limit".If the server complains about

timeout

, change the maximum execution time using the similar named option. Try for example with 60 or 120 seconds.

These settings are only effective if PHP safe mode is off!

Another remedy is to simply reload the page one or more times. For every reload Multithumb will process more images. When all the images areprocessed, the page will load normally.

Note that some changes in the backend options might trigger a new image processing cycle. This is also the case if you deliberately clear the imagecache by using the option "Clear cache on next page load".

NEW VERSION 2.0

Multithumb 2.0 is more versatile than ever. In fact, it is probably one of the most versatile and advanced mambots ever written. Remember, this is "just" amambot, but it has capabilities you would expect only from full-blown components.Many of the new features are ideas and requests from users, like watermarks, resizing of full images, auto-galleries with image descriptions and link to mainarticle.

Here is a list of some of the new features in Multithumb 2.0:

Watermarks

Supports both popup images and images shown in content Watermark images can be true alpha blend PNG images or any GIF, JPG og PNG imagewith manually set transparent background colorUser definable watermark position

Language packs

Installable language packs for Multithumb's frontend

Manual thumbnails

You can create your own thumbnails and let Multithumb use them instead

Thumbnail proportions

Choose between best fit (keeping aspect ration), crop to fit, fill out with background color, stretch (distort proportions)

Scrambled image namesAutomatic resize of images

Can resize both popup images and images shown in contentResize by pixels or percentage of screen size

New popup types: Slimbox, Greybox and Thickbox

Multihumb now supports six popup types: normal, lightbox, slimbox, greybox, thickbox, thumbnail expansionThumbnail expansion now works perfect with captions too!

"Intelligent" handling of compatibility issues with other javascript libraries

For example, if mootools.js is already included in your template, Multithumb will not try add it again

Auto-gallery with individual image descriptions

You can add a text file with the same name as the image used for the gallery, and Multithumb will use the content of this file for image descriptionsIt will even create the description file for you, ready to fill out!

Multithumb rules!

kreacom.dk - Multithumb image plugin for Joomlahttp://www.kreacom.dk/index2.php?option=com_content&task=view&id=82&pop=1&page=0&...2 de 2711/19/07 5:22 PM

Link to main article in blog mode

Instead of showing a popup when viewing the article in blog mode, Multithumb can create a link from the first image to the main article.Or it can just create a plain, inactive thumbnail

Works from sub folders out-of-the-box

You no longer have to modify the javascript files if you run Joomla from a sub folder on the server

Native thumbnail generation

Multithumb no longer uses an external thumbnail library

Informative error handling with javascript popup messages

Like if Multithumb can't find the watermark file, or if the server does not support the needed image functions

Extremely configurable

But because of that, also a bit confusing for new users :-)

Parameter override, allowing for multiple configurations even in same article

Most of Multithumb's settings can be overridden in the content by including the proper tags, like:{multithumb popup_type=greybox full_width=400} which will make Greybox the new popup style and images 400px wideThe override works until the end of the article or until it is overridden again.

There is even a handy online tool dedicated to creating the tags for you!

Many new optionsBackend much better arrangedImproved and optimized code

NEW IN VERSION 1.1

Multithumb is really becoming "multi". For example, it can now also process {mosimage} tags directly with all the features you have for normal images.There is even a simple and yet powerful gallery function where all you have to do is to include any image from a given folder and give it the description(alt text) "mt_gallery". This triggers the mambot to generate a full blown photo gallery!Furthermore Multithumb 1.1 is much more configurable than before, and the layout of the admin interface is improved.Please note that some of the default values has changed, so take a look at the mambot admin and see if the values are as you want them. You will wantto this anyway because of the many new options!Here is a list of what's new in version 1.1:Can also process {mosimage} tags

Multithumb must come before MosImage in the mambot list for this to work efficiently!

Simple but powerful gallery functionJust insert any image from a given folder and give it the description (alt text) "mt_gallery".Works also with {mosimage} tags!You can now both include and exclude individual pages by using the {multithumb} or {nomultihumb} tagsYou can give a list of categories where you want to include or exclude MultithumbIt's possible to specify more than one class that Multithumb should work on. For example you can tell it to process only images with the classes"mypics" or "holiday" or whatever. Nice if you want it to work on just one or a few images in a given article.You can also tell Multithumb to ignore an image by setting the alt text to "mt_ignore:real alt text". The image will then be shown plain vanilla!This feature is needed with MosImage because you can't easily apply a custom style class.Optionally turn of Multithumb processing in blog mode (when viewing the introtext only).Thumbs generated by Multithumb can be assigned a class name for improved stylingYou can style Multithumb directly in the mambot interface! It's now easy to change the caption font, border or color etc.Improved cache handling. Don't need to manually clear the cache if you change thumbnail size.However, if you for some reason find the thumbnails wrong, just select the option "Clear cache on next page load".Much more configurableImproved admin interfaceSeveral bugfixesOptimized code

NEW IN VERSION 1.04

Caption is shown in lightbox popupCorrected a missing </a> tag

NEW IN VERSION 1.03

Now you can specify how many thumbnails are shown in a lightbox set. For example, you can have a slideshow with related 20 pictures, but only show the first one. When you click that thumbnail, the rest of the pictures will be be visible by using the Next or Prev buttons on the lightbox popup.

NEW IN VERSION 1.02

I found it inconvenient that Multithumb worked on all my pages. Although it is possible to tell it only to operate on images with a certain class, it is a bit tedious if you have many images.Now in version 1.02 there is a new option: "Apply only to tagged content" which means that Multithumb will only process pages containing the tag. Thetag can be anywhere in the content, but it is more effective if you put it in the beginning.

Demos and how-tos

kreacom.dk - Multithumb image plugin for Joomlahttp://www.kreacom.dk/index2.php?option=com_content&task=view&id=82&pop=1&page=0&...3 de 2711/19/07 5:22 PM

Simple thumbnail and popup

First select the desired thumbnail size and popup type in the backend, such as lightbox. Then include the image in the editor inany way you like: directly with the editor's image icon or indirectly with the {mosimage} tag. Note that the image will

not

bethumbnailed when you look at it in the content. This is normal, but you can resize the image in the editor by dragging thecorners if it bothers you. This will not affect the final result.If you give the image a description (alt text) this will be used as the image title.Below is shown how the image to the right is made with {mosimage}.

The six popup types

Multithumb now supports six different popup types. For those called something with 'box', Multithumb uses third-party javascript libraries and stylesheets. For information, bug reports and suggestions regarding the popup scripts themselves, please navigate to their respective homepages using thelinks below.

Normal popup

This is more or less a plain old popup with the image opened in a new window, adjusted to fit the image

Lightbox

A slick and very popular popup style nowadays. Not all browers will show Lightbox correctly.

Slimbox

A lightweight variant of Lightbox. Looks the same but uses another set of libraries.

Lightbox and Slimbox are mutually exclusive - they cannot be used on the same page at the same time!

(But no problem with different pages on thesame site)

Greybox

A somewhat different approach to the same idea as Lightbox. Many people find it very nice.

Thickbox

Yet another lightbox variant. Thickbox requires that your page has a validDOCTYPE.

Thumbnail expansion

Not really a popup. The thumbnail "expands" when clicked on, displaying the full image directly in content. Not very useful for photo galleries, butgood for images that illustrate the accompanying text.

Important note

The box popups can be tricky. They make heavy use of complicated javascript and DHTML, and are very fragile. Just a single line of innocent looking javascript code can break them totally.

Greybox

won't work with

. Instead you must use another construction:

. OpenComment will break Greybox because of this, but I havemade a fix.

Lightbox, Slimbox and Thickbox

are mutually exclusive. They cannot be used on the same page without interfering with each other. Normally that isnot a problem but it means that I cannot show examples with Slimbox and Lightbox on this page. You can use the different box popups on differentpages on the same site without problems.The box popups can sometimes also interfere with other scripts on the site and refuse to work. If so, see if one of the other variants will work.

For questions and support, please go to the box popups' respective homepages!!!

Image sets

Image sets are groups of related images linked together, making a kind of gallery. Follow the instructions for

Simple thumbnail and popup

above for eachimage, but give every image in the set the same description (alt text) which will then be the name of the gallery. This works for lightbox, slimbox andgreybox popups.The images to the left are made with {mosimage} exactly as shown in theexample above, except that each image has the alt-text "image sets".

Simple thumbnail andpopup example