<?xml version="1.0" encoding="iso-8859-1"?>
<mosinstall version="4.5.2" type="mambot" group="content">
	<name>Multithumb</name>
	<author>Martin Larsen</author>
	<creationDate>June 2 2007</creationDate>
	<copyright>(C) 2007 Martin Larsen</copyright>
	<license>http://www.gnu.org/copyleft/gpl.html GNU/GPL</license>
	<authorEmail>martinlarsen@bigfoot.com</authorEmail>
	<authorUrl>http://www.kreacom.dk/mambot/</authorUrl>
	<version>2.0 beta 1.2</version>
	<description><![CDATA[
<style type='text/css'>.paramlist p {font-size:125%;font-weight:bold;margin:20px 0 0px 0; } .paramlist hr {display:none} .adminform h1 { font-size: 20px; } .adminform h2 { font-size: 15px; } </style>	
	<h1>What is Multithumb?</h1>
Multithumb is a multi-purpose image plugin for Joomla that can automatically
create thumbnails and popups of the original images, as well as resize
the full-size images or add a watermark to them. It can even scramble
the images names so that people cannot guess their original
non-watermark locations. <p> For articles shown in blog mode, it can create a link from the first image to the full article for better user navigation.<br> </p>  <p>

It can also create a simple photo gallery from any folder by just
including one of the images from the folder and give it the description
(alt text) "mt_gallery" (or using the new tagging feature). </p>  <p> Multithumb works with both normal images and {mosimage} images. </p>  <p> See the examples and how-to's below for inspiration and instructions!</p><p>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. The same applies when you clear Multithumb's cache.<br> </p>
<h1> Here is a list of some of the new features in Multithumb 2.0: </h1>
<ul>
	<li><strong>Watermarks</strong><br />
	Supports both popup images and images shown in content Watermark images
	can be true alpha blend PNG images or any GIF, JPG og PNG image with
	manually set transparent background color<br />
	User definable watermark position</li>
	<li><strong>Language packs</strong><br />
	Installable language packs for Multithumb&#39;s frontend<br />
	</li>
	<li><strong>Manual thumbnails</strong><br />
	You can create your own thumbnails and let :mt use them instead </li>
	<li><strong>Thumbnail proportions</strong><br />
	Choose between best fit (keeping aspect ration), crop to fit, fill out with background color, stretch (distort proportions)<br />
	</li>
	<li><strong>Scrambled image names</strong><br />
	</li>
	<li><strong>Automatic resize of images</strong><br />
	Can resize both popup images and images shown in content<br />
	Resize by pixels or percentage of screen size</li>
	<li><strong>New popup types: Slimbox, Greybox and Thickbox<br />
	</strong>Multihumb now supports six popup types: normal, lightbox, slimbox, greybox, thickbox, thumbnail expansion<br />
	Thumbnail expansion now works perfect with captions too! </li>
	<li><strong>&quot;Intelligent&quot; handling of compatibility issues with other javascript libraries</strong><br />
	For example, if mootools.js is already included in your template, Multithumb will not try add it again</li>
	<li><strong>Auto-gallery with individual image descriptions</strong><br />
	You can add a text file with the same name as the image used for the
	gallery, and :mt will use the content of this file for image
	descriptions<br />
	It will even create the description file for you, ready to fill out!</li>
	<li><strong>Link to main article in blog mode</strong><br />
	Instead of showing a popup when viewing the article in blog mode, :mt
	can create a link from the first image to the main article.<br />
	Or it can just create a plain, inactive thumbnail</li>
	<li><strong>Works from sub folders out-of-the-box</strong><br />
	You no longer have to modify the javascript files if you run Joomla from a sub folder on the server</li>
	<li><strong>Native thumbnail generation</strong><br />
	:mt no longer uses an external thumbnail library</li>
	<li><strong>Informative error handling with javascript popup messages</strong><br />
	Like if :mt can&#39;t find the watermark file, or if the server does not support the needed image functions </li>
	<li><strong>Extremely configurable</strong><br />
	But because of that, also a bit confusing for new users :-)</li>
	<li><strong>Parameter override, allowing for multiple configurations even in same article</strong><br />
	Most of :mt&#39;s settings can be overridden in the content by including the proper tags, like:<br />
	{:multithumb popup_type=greybox full_width=400}&nbsp; which will make Greybox the new popup style and images 400px wide<br />
	The override works until the end of the article or until it is overridden again.<br />
	<em>
	There is even a handy online tool dedicated to creating the tags for you!</em></li>
	<li><strong>Many new options</strong></li>
	<li><strong>Backend much better arranged</strong>  </li>
	<li><strong>Improved and optimized code</strong></li>
</ul>
	
<h2>Read more at <a href="http://www.kreacom.dk/mambots/multithumb.html">http://www.kreacom.dk/mambots/multithumb.html</a></h2>
]]></description>
	<files>
		<filename mambot="multithumb">multithumb.php</filename>
		<filename>multithumb/thumbs/index.html</filename>
		<filename>multithumb/images/index.html</filename>
		<filename>multithumb/multithumb.js</filename>
		<filename>multithumb/lightbox/index.html</filename>
		<filename>multithumb/lightbox/images/blank.gif</filename>
		<filename>multithumb/lightbox/images/close.gif</filename>
		<filename>multithumb/lightbox/images/closelabel.gif</filename>
		<filename>multithumb/lightbox/images/loading.gif</filename>
		<filename>multithumb/lightbox/images/next.gif</filename>
		<filename>multithumb/lightbox/images/nextlabel.gif</filename>
		<filename>multithumb/lightbox/images/prev.gif</filename>
		<filename>multithumb/lightbox/images/prevlabel.gif</filename>
		<filename>multithumb/lightbox/js/effects.js</filename>
		<filename>multithumb/lightbox/js/prototype.js</filename>
		<filename>multithumb/lightbox/js/scriptaculous.js</filename>
		<filename>multithumb/lightbox/js/lightbox.js</filename>
		<filename>multithumb/lightbox/css/lightbox.css</filename>
		<filename>multithumb/greybox/AJS.js</filename>
		<filename>multithumb/greybox/AJS_fx.js</filename>
		<filename>multithumb/greybox/gb_scripts.js</filename>
		<filename>multithumb/greybox/g_close.gif</filename>
		<filename>multithumb/greybox/gb_styles.css</filename>
		<filename>multithumb/greybox/header_bg.gif</filename>
		<filename>multithumb/greybox/indicator.gif</filename>
		<filename>multithumb/greybox/loader_frame.html</filename>
		<filename>multithumb/greybox/next.gif</filename>
		<filename>multithumb/greybox/prev.gif</filename>
		<filename>multithumb/greybox/w_close.gif</filename>
		<filename>multithumb/slimbox/css/closelabel.gif</filename>
		<filename>multithumb/slimbox/css/loading.gif</filename>
		<filename>multithumb/slimbox/css/nextlabel.gif</filename>
		<filename>multithumb/slimbox/css/prevlabel.gif</filename>
		<filename>multithumb/slimbox/css/slimbox.css</filename>
		<filename>multithumb/slimbox/js/slimbox.js</filename>
		<filename>multithumb/slimbox/js/mootools.js</filename>
		<filename>multithumb/thickbox/thickbox.js</filename>
		<filename>multithumb/thickbox/jquery.js</filename>
		<filename>multithumb/thickbox/thickbox.css</filename>
		<filename>multithumb/thickbox/loadingAnimation.gif</filename>
</files>

	<params>
		<param name="@spacer" type="spacer" default="" label="&lt;p/ style='margin-top:0'&gt;Popup options" description="Options to control the popup style." />
		<param name="add_headers" type="list" default="auto" label="How to add headers for the popup libraries."
			description="To use the different popup methods, certain libraries are needed. However, if these are loaded twice the scripts will normally not work.&lt;p/&gt;Multithumb can 'intelligently' decide if the headers are needed by looking in your template file.&lt;p/&gt;If you now that the headers are already present, you can select &lt;b&gt;Never&lt;/b&gt;. If you know they are not present, select &lt;b&gt;Always&lt;/b&gt;. Otherwise select &lt;b&gt;Automatically&lt;/b&gt;.">
			<option value="auto">Automatically, if needed</option>
			<option value="always">Always</option>
			<option value="never">Never</option>
		</param>
		<param name="popup_type" type="list" default="lightbox" label="Popup method"
			description="Choose between &lt;b&gt;No popup - just thumbnails&lt;/b&gt;, &lt;b&gt;Normal popup&lt;/b&gt;, &lt;b&gt;LightBox popup&lt;/b&gt;, &lt;b&gt;Slimbox&lt;/b&gt;, &lt;b&gt;Greybox&lt;/b&gt; or &lt;b&gt;Thumbnail Expansion&lt;/b&gt; (expand image without reloading the page).&lt;p/&gt;You can override this setting for individual images by prefixing the alt text (description) with mt_none:, mt_popup:, mt_lightbox:, mt_slimbox:, mt_greybox: or mt_expand:&lt;p/&gt;&lt;b&gt;Remember the colon!&lt;/b&gt;">
			<option value="none">No popup - just thumbnails</option>
			<option value="normal">Normal popup</option>
			<option value="lightbox">Lightbox</option>
			<option value="slimbox">Slimbox</option>
			<option value="greybox">Greybox</option>
			<option value="thickbox">Thickbox</option>
			<option value="expansion">Thumbnail Expansion</option>
			</param>
		<param name="@spacer" type="spacer" default="" label="&lt;p/&gt;Thumbnail options" description="Options for changing the style and behaviour of thumbnail." />
		<param name="enable_thumbs" type="radio" default="1" label="Use Thumbnails"
			description="If set to &lt;b&gt;No&lt;/b&gt;, thumbnail generation is disabled. Useful is you only want watermarks or resizing the images.">
			<option value="0">No</option>
			<option value="1">Yes</option>
		</param>
		<param name="blog_mode" type="list" default="link" label="Handling of thumbnails in blog mode" 
			description="Multithumb can show normal popup images in the introtext in blog mode, or it can create a link to the full article. Or just show the inactive thumbnail." >
			<option value="link">Link to article</option>
			<option value="popup">Popup</option>
			<option value="thumb">Thumbnails only</option>
		</param>
		<param name="thumb_width" type="text" default="150" label="Thumbnail width" 
			description="Width of thumbnail in pixel. Set to 0 (zero) to constrain only by height." />
		<param name="thumb_height" type="text" default="100" label="Thumbnail height" 
			description="Height of thumbnail in pixels.  Set to 0 (zero) to constrain only by width." />
		<param name="thumb_proportions" type="list" default="bestfit" label="Thumbnail proportions"
			description="What to do if the original image and resulting thumbnail have different proportions.">
			<option value="bestfit">Best fit (keep proportions)</option>
			<option value="crop">Crop to fit (cut one side)</option>
            <option value="fill">Fill out with background color</option>
            <option value="stretch">Strecht to fit (distort proportions)</option>
			</param>
		<param name="thumb_bg" type="text" default="#FFFFFF" label="Background color of thumbnail" 
			description="Background color of thumbnail if &lt;b&gt;Handle proportions&lt;/b&gt; is set to fill out." />
		<param name="border_size" type="list" default="2px" label="Border size" 
			description="Thumbnail border size in pixels. For other styling of thumbnails, use the field CSS Styling." >
			<option value="0">0px</option>
			<option value="1px">1px</option>
			<option value="2px">2px</option>
			<option value="3px">3px</option>
			<option value="4px">4px</option>
			<option value="5px">5px</option>
		</param>
		<param name="border_color" type="text" default="#000000" label="Border color" 
			description="Thumbnail border color. For other styling of thumbnails, use the field CSS Styling."/>
		<param name="border_style" type="list" default="solid" label="Border style" 
			description="Thumbnail border style. For other styling of thumbnails, use the field CSS Styling.">
			<option value="none">none</option>
			<option value="solid">solid</option>
			<option value="dotted">dotted</option>
			<option value="dashed">dashed</option>
			<option value="groove">groove</option>
			<option value="ridge">ridge</option>
			<option value="inset">inset</option>
			<option value="outset">outset</option>
			<option value="double">double</option>
		</param>
		<param name="css" type="textarea" cols="30" rows="10" default="/*&lt;br /&gt;The comments below are to help you understanding and modifying the look and feel of thumbnails. Borders can be set using the border fields above. You can safely delete these comments.&lt;br /&gt;*/&lt;br /&gt;&lt;br /&gt;/*&lt;br /&gt;Styles for the DIV surrounding the image.&lt;br /&gt;*/&lt;br /&gt;div.mtImgBoxStyle {&lt;br /&gt; margin:5px;&lt;br /&gt;}&lt;br /&gt;&lt;br /&gt;/* &lt;br /&gt;Styles for the caption box below/above the image.&lt;br /&gt;Change font family and text color etc. here.&lt;br /&gt;*/&lt;br /&gt;div.mtCapStyle {&lt;br /&gt; font-weight: bold;&lt;br /&gt; color: black;&lt;br /&gt; background-color: #ddd;&lt;br /&gt; padding: 2px;&lt;br /&gt; text-align:center;&lt;br /&gt; overflow:hidden;&lt;br /&gt;}&lt;br /&gt;/* &lt;br /&gt;Styles for the table based Multithumb gallery&lt;br /&gt;*/&lt;br /&gt;table.multithumb {&lt;br /&gt; width: auto;&lt;br /&gt;}" label="CSS Styling"
	  description="CSS styling for the thumbnail image and caption. Change font and text color etc. here. Borders can be set using the border fields above.&lt;p/&gt;To restore the default styles, erase the content of the field and press apply.&lt;p/&gt;You can delete the comments to save some space." />
		<param name="max_thumbnails" type="list" default="0" label="Max. thumbnails in image sets"
			description="Show only the first x thumbnails in a related lightbox/slimbox/greybox set. Good for slideshows.">
			<option value="0">Show all</option>
			<option value="1">1</option>
			<option value="2">2</option>
			<option value="3">3</option>
			<option value="4">4</option>
			<option value="5">5</option>
			<option value="6">6</option>
			<option value="7">7</option>
			<option value="8">8</option>
			<option value="9">9</option>
			<option value="10">10</option>
			<option value="11">11</option>
			<option value="12">12</option>
			<option value="13">13</option>
			<option value="14">14</option>
			<option value="15">15</option>
			<option value="16">16</option>
			<option value="17">17</option>
			<option value="18">18</option>
			<option value="19">19</option>
			<option value="20">20</option>
			<option value="21">21</option>
			<option value="22">22</option>
			<option value="23">23</option>
			<option value="24">24</option>
			<option value="25">25</option>
			</param>
		<param name="num_cols" type="text" default="3" label="Number of thumbnail columns" 
			description="Number of columns in multithumb gallery. Set image description (alt text) to mt_gallery to trigger gallery mode." />
		<param name="thumbclass" type="text" default="multithumb" label="Give thumbnails this class" 
			description="Give the generated thumbnail images this class. Useful for thumbnail styling." />
	<param name="@spacer" type="spacer" default="" label="&lt;p/&gt;Full-size image options" description="Options to control the size and appearance of full-sized images, whether in popups or directly in content." />
		<param name="resize" type="radio" default="0" label="Resize images"
			description="If set to &lt;b&gt;Yes&lt;/b&gt; the target images (popup etc) will be resized to the values below.">
			<option value="0">No</option>
			<option value="1">Yes</option>
			</param>
		<param name="full_width" type="text" default="800" label="Full-size width in pixels or percent." 
				description="Width of the full image. Can be a percentage of screen width, like 60%. Set to 0 (zero) to constrain by height only (recommended)." />
		<param name="full_height" type="text" default="600" label="Full-size height in pixels or percent." 
				description="Height of the full image. Can be a percentage of screen height, like 60%. Set to 0 (zero) to constrain by width only." />
		<param name="image_proportions" type="list" default="bestfit" label="Full-size image proportions"
			description="What to do if the original and resized image have different proportions.">
			<option value="bestfit">Best fit (keep proportions)</option>
			<option value="crop">Crop to fit (cut one side)</option>
            <option value="fill">Fill out with background color</option>
            <option value="stretch">Strecht to fit (distort proportions)</option>
			</param>
		<param name="image_bg" type="text" default="#000000" label="Background color of full-sized image." 
				description="Background color of full-sized image. Applies only if 'Fill out with background color' is selected above." />
		<param name="@spacer" type="spacer" default="" label="&lt;p/&gt;Caption options" description="Options for captions" />
		<param name="caption_pos" type="list" default="disabled" label="Caption position"
			description="A caption text will be shown &lt;b&gt;above&lt;/b&gt; or &lt;b&gt;below&lt;/b&gt; the image, or &lt;b&gt;disabled&lt;/b&gt;.">
			<option value="disabled">Disabled</option>
			<option value="below">Caption below</option>
			<option value="above">Caption above</option>
			</param>
		<param name="caption_type" type="list" default="title" label="Take caption from"
			description="Use &lt;b&gt;Alt&lt;/b&gt; or &lt;b&gt;Title&lt;/b&gt; attribute for captions. Alt is called 'description' in some editors.">
			<option value="alt">Alt text</option>
			<option value="title">Title</option>
			</param>
		<param name="@spacer" type="spacer" default="" label="&lt;p/&gt;Watermark options" description="Options for controlling watermarks." />
		<param name="watermark" type="radio" default="0" label="Use watermarks?"
			description="If set to &lt;b&gt;Yes&lt;/b&gt;, the watermark from the file below will be added to every fullsize image (not thumbs).">
			<option value="0">No</option>
			<option value="1">Yes</option>
			</param>
		<param name="watermark_file" type="text" default="" label="Watermark file" 
			description="Full path to watermark file." />
		<param name="watermark_left" type="text" default="" label="Left position of watermark" 
			description="Left position of watermark. Use negative for right position. Leave empty for center." />
		<param name="watermark_top" type="text" default="" label="Top position of watermark." 
			description="Top position of watermark. Use negative for bottom position. Leave empty for center." />
		<param name="transparency_type" type="list" default="alpha" label="Transparency type"
			description="Choose between &lt;b&gt;True alpha blending&lt;/b&gt; (recommended!) or &lt;b&gt;Transparent background color&lt;/b&gt;.">
			<option value="alpha">True alpha blending</option>
			<option value="color">Transparent background color</option>
			</param>
		<param name="transparent_color" type="text" default="#000000" label="Transparent color (ignored for true alpha blending)" 
			description="Set the (background) color that should be transparent. Ignored for true alpha blending." />
		<param name="transparency" type="text" default="25" label="Transparency in percent (ignored for true alpha blending)" 
			description="Transparency in percent. 0 = watermark invisible, 100 = not transparent (except for the set transparent color!). Ignored for true alpha blending." />
		<param name="scramble" type="list" default="off" label="Scramble image names?"
			description="This option can scramble the file names of thumbnails and resized/watermarked images so that users can not guess their real locations. Choose between&lt;p/&gt;No scrambling (&lt;b&gt;Off&lt;/b&gt;)&lt;p/&gt;Long file names with no risc of name collision (&lt;b&gt;MD5&lt;/b&gt;)&lt;p/&gt;Short file names with little risc of name collision (&lt;b&gt;CRC32&lt;/b&gt;)">
			<option value="off">Off</option>
			<option value="md5">MD5</option>
			<option value="crc32">CRC32</option>
			</param>
		<param name="@spacer" type="spacer" default="" label="&lt;p/&gt;Where to use Multithumb" description="Options controlling where to enable Multithumb" />
		<param name="image_type" type="list" default="both" label="Apply to normal images or {mosimage} ?"
			description="Select if Multithumb will handle normal images, {mosimage} tags, or both.&lt;p/&gt;If you want it to process {mosimage}, Multithumb &lt;b&gt;must come before&lt;/b&gt; MosImage in the mambot list for this to work!">
			<option value="normal">Normal pictures only</option>
			<option value="mosimage">{mosimage} only</option>
			<option value="both">Both</option>
		</param>
		<param name="only_cats" type="text" default="" label="Enable Multithumb in these categories only" 
			description="Apply Multithumb to images in these categories only. Seperate categories with semicolon. Leave empty to apply to all categories." />
		<param name="ignore_cats" type="text" default="" label="Disable Multithumb in these categories" 
			description="Exclude Multithumb in these categories. Seperate categories with semicolon. Leave empty to apply to all categories." />
		<param name="only_tagged" type="radio" default="0" label="Apply only to content with {multithumb}" 
			description="Apply only multithumb to content including the {multithumb} tag. Useful if you only need it on a few pages." >
			<option value="0">No</option>
			<option value="1">Yes</option>
		</param>
		<param name="exclude_tagged" type="radio" default="1" label="Exclude pages with {nomultithumb}" 
			description="Skip pages with {nomultithumb} tag. Useful if you need it on most, but not all pages." >
			<option value="0">No</option>
			<option value="1">Yes</option>
		</param>
		<param name="only_these_classes" type="text" default="" label="Apply only to these image CSS classes" 
			description="Apply only multithumb to images with these classes. Seperate classes with |. Leave empty to apply to all images." />
		<param name="@spacer" type="spacer" default="" label="&lt;p/&gt;Various options" description="Various options" />
		<param name="language" type="text" default="" label="Language override for Multithumb" 
			description=" Use the language name, like English, Danish, Polish etc. &lt;b&gt;Leave empty to use the language set in the Global Configuration&lt;/b&gt;." />
		<param name="error_msg" type="list" default="popup" label="Show Multithumb error messages"
			description="Select how Multithumb should display error messages">
			<option value="popup">Popup alerts</option>
			<option value="text">Show as text</option>
			<option value="off">Don't display messages</option>
		</param>
		<param name="quality" type="text" default="80" label="JPG quality" 
			description="JPG quality 0-100 for thumbnails and resized/watermarked images. Better quality creates bigger files. Does only apply to JPG!&lt;p/&gt;If you change the quality, you &lt;b&gt;must&lt;/b&gt; clear Multithumb's cache to see the changes." />
		<param name="allow_img_toolbar" type="radio" default="0" label="Allow IE Image Toolbar"
			description="If set to yes, Internet Explorer's Image Toolbar will be enabled in the popups. &lt;b&gt;NOTE: IE Only!&lt;/b&gt;">
			<option value="0">No</option>
			<option value="1">Yes</option>
			</param>
		<param name="clear_cache" type="radio" default="0" label="Clear cache on next page load"
			description="Clear thumbnail cache on next page load? Use this to clean up the cache, or if you experience problems. This option is set to no again automatically.">
			<option value="0">No</option>
			<option value="1">Yes</option>
			</param>
		<param name="time_limit" type="text" default="" label="PHP maximum execution limit." 
			description="Sets the maximum execution time for PHP in seconds. If you get a time out error, try with a value like 120 (2 minutes). Leave empty to user the server default value.&lt;b&gt; Does not work in Safe Mode!&lt;/b&gt;">
			</param>
		<param name="memory_limit" type="list" default="default" label="PHP memory limit." 
			description="Sets the PHP memory limit. Try higher values if you get an Allowed memory size error. &lt;b&gt;Does not work in Safe Mode!&lt;/b&gt;">
			<option value="default">Default memory size</option>
			<option value="16M">16 MB</option>
			<option value="32M">32 MB</option>
			<option value="64M">64 MB</option>
			</param>
		</params>

</mosinstall>
