=====Enhanced Image Action=====

>>==See also:==
Documentation: EnhancedImageActionInfo.>>This is the development page for the enhanced image action.::c::


The code here below is just a quick modification to the offical image action code. Only works from release 1.1.6.0!

%%(php)
<?php
/**
 * Displays an image.
 *
 * You have to specify the url for the location of the image. In contrary to inline images you can set the 
 * apperance of the image better: 
 *
 * You can specify "width" and "height" for the image (note that the image is just displayed different, it does
 * not save any bandwidth), set a target link or make the full size image open in a new window (only possible
 * if you don't assign a link to the image).
 *
 * Syntax:
 * {{image url ="http://www.example.com/example.jpg" alt="describing text" [link="http://www.example.com] [heigth=""] [width=""] [class="class"]}}
 *
 * @package	Actions
 * @subpackage	?
 * @name	image
 *
 * @author	?
 * @author 	{@link http://wikka.jsnx.com/ChristianBarthelemy ChristianBarthelemy} (heigth+width+openfull)
 * @author	{@link http://wikka.jsnx.com/NilsLindenberg NilsLindenberg} (default values, minor corrections)
 *
 * @version	0.9
 * @copyright	Copyright © ?
 * @license	http://www.gnu.org/copyleft/lesser.html GNU Lesser General Public License
 * @since	?
 *
 * @input	string  $url  mandatory: url of the image to be displayed;
 * @input	string  $alt  mandatory: alternative text for the image;
 * @input	string  $link  optional: target link for image (optional). Supports URL, WikiName links, 
 * 				InterWiki links etc.;
 *				default: none;
 * @input	integer  $width  optional: alternative width for the image;
 *				default:  
 * @input	integer  $height  optional: alternative heigth for the image;
 *				default:
 * @input	string  $class  optional: a class for the image;
 *				default: none;
 *
 * @output	the given image;
 *
 * @uses		cleanUrl();
 * @todo		- do we need to pass the output through SafeHtml?
 *		- handling when no url and/or alternative text is/are provided
 *		- documentation for src (also possible instead of url)
 *		- option to open "full-image" in another window?
 */

// function to check if a string is a valid Length as specified in the XHTML DTDs
if (!function_exists('is_length')) {
	function is_length($input) {
		return preg_match("/^[0-9]+\%?$/",$input) ? TRUE : FALSE;
	}
}

//setting default values
$link = $class = $output =  $title =  $width = $height = NULL;

//getting the paramters
if (is_array($vars))
{
	foreach ($vars as $param => $value)
	{
		if ($param == 'src' and $vars['url'] == '') {$vars['url']=$value;}
		if ($param == 'title') {$title=$this->htmlspecialchars_ent($vars['title']);}
		if ($param == 'class') {$class=$this->htmlspecialchars_ent($vars['class']);}
		if ($param == 'alt') {$alt=$this->htmlspecialchars_ent($vars['alt']);}
		if ($param == 'width') {$width=$this->htmlspecialchars_ent($vars['width']);}
		if ($param == 'height') {$height=$this->htmlspecialchars_ent($vars['height']);}
		if ($param == 'link') {$link=$this->cleanUrl(trim($vars['link']));}
	}
}

//sanatizing url and proofing if it is an image
$url = $this->cleanUrl(trim($vars['url']));
$image = getimagesize($url);

//if it is an image, prepare the output
if ((is_array($image)) && ($alt))
{
	if (!is_length($width) || !is_length($height)) {
			$width = $image[0];
			$height = $image[1];
	}
	$output.="<img ";
	if ($class) {$output.="class=\"".$class."\" ";}
	$output.="src=\"".$url."\" ";
	if ($alt) {$output.="alt=\"".$alt."\" ";}
	if ($title && !$link) {$output.="title=\"".$title."\" ";}
	$output.="width=\"".$width."\" height=\"".$height."\" />";

	//link?
	if ($link && !$title) {$output = $this->Link($link, "", $output, 1, 0, 0);}
				elseif ($link && $title) {$output = $this->Link($link, "", $output, 1, 0, $title);}

	//make the output save and print it
	$output = $this->ReturnSafeHTML($output);
	print($output);
}
elseif (!$alt) {echo 'The necessary parameter alt was not provided';}
else {echo 'The image could not be found or it was no image. Please check the url';} 
?>
%%

Note that we have to change the function Link in the wikka.php, too:

changing:
%%(php) return $url ? "<a class=\"ext\" href=\"$url\" >$text</a>$external_link_tail" : $text;%%
to:
%%(php)return $url ? "<a class=\"ext\" href=\"$url\" title=\"$title\">$text</a>$external_link_tail" : $text;%%

----
CategoryDevelopmentActions