Explanations updated : 21 februray 2009
Last times files updated: 29 march 2009, added next/previous action, improved naming of thumbnails, better support for fcke, and more.
FBoxBot is a joomla bot/plugin. The main idea is to help the user to create easily thumbnails from any pictures, and when you click on the thumbnails a nice "lighbox-like" popup appears that show the image at its original size. So what makes this package so special ? First: I've written the associated popup script, frontbox, which I wanted to be lightweight, polyvalent, reliable.
And Second: I made the process of creation of thumbnails easier than ever: inside your favorite wysiwyg editor insert a picture, resize "manually" (see left picture), save, publish and the bot will do the remaining job for you ! But it has also some other nice features we'll discuss further ..
Remark: Don't forget to publish the bot/plugin.
Warning !: The bot is not applied to images external to your Joomla site.
About the "Rebuild Thumbs" button:
- This button must be enabled in configuration settings, and is available only for (Super) Administrators (at the bottom of each article in frontend).
There's two main reasons to use this button :
- You changed watermark in configuration settings, or disabled the "popup" effect for a thumbnail (and thus removed watermark).
- You can, from each picture, create many thumbnails of different size. Problem is that if you edit save preview again and again an article, in order to adjust size of pictures; it's easy to end up with many unused thumbnails. The button will get rid of them.
Note: if you use Joomla 1.0.x you must disable cache in order to access to this button.
- In order to take advantage of all the features of the bot, particular attributes must be integrated to the <img> tag. They all begin with the prefix "fb:" . Example:
- <img src="myimg.gif" width="50" height ="50" fb:name="myset" />
- The complete list of particular attributes are: fb:name, fb:src, fb:width ,fb:height, fb:nofb (remark: with nofb the prefix fb: is facultative).
Warning! : If you use TinyMCE editor (or any derived editor), you should disable "HTML Code Cleanup" (or similar features) , otherwise you won't be able to use these particular attributes.
- Attribute nofb. Probably the most interesting attribute. Disables popup and watermark associated to a particular thumbnail. Value should be "nofb". Example:
- <img src="stories/mypic.jpg" width="70" nofb="nofb" />
Attribute fb:name. Makes "kind of galleries", i.e next/previous actions. You have to specify to which "set" a "frontbox popup" belongs with this attribute (after parsing by the bot, this one becomes "name" parameter in the "frontbox span").
Attribute fb:src. If you resize big picture on your wysiwyg editor, it might be a pain to edit the article again ... (waiting for the big image to load). Instead you can provide to the regular src parameter a link to a "fake small picture", and set the true link in the fb:src attribute. You'll see "the fake picure" when editing, but after publishing, the bot will restore the "true picture" (warning: this one has nothing to do with the "src" attribute in the "frontbox span").
- <img src="fake. gif" width="70" fb:src="trueimg.gif" />
Attributes fb:width, fb:height. After parsing by the bot, theses are respectively converted into width an height attributes in the "frontbox span". Not particularly interesting for pictures.
If you use Joomla 1.0.x, you might notice sometimes that despite the thumbnail being correctly generated the "lightbox effect" doesn't work. The problem happens because the mambot needs to load the following lines in the head of your Joomla's template, and
unfortunately fail sometimes to do so:
Don't forget to replace mysite.com in the previous code by your actual website.
This plugin/bot interests you?
Please click on the button that corresponds to your Joomla version.