===== Millennium Falcon  =====
Below you see a photograph of the Millennium Falcon, last year on Tatooine.
After uploading, you see the image in the page, and below the image another upload form is visible, in case you want to replace the photo with another one later. You can also delete the file.
Now, suppose you want to add more images to the same page. Then you need to distinguish the files by adding an **id**.

===== Millennium Falcon photograph =====
Photograph of the Millennium Falcon, last year on Tatooine.
There was lots of sand, as always.
{{file}}
The page now shows a form which allows you to upload the file.
After uploading, you see the image in the page, and below the image another upload form is visible, in case you want to replace the photo with another one later.
In order to display the image on other pages, include the following modified file action in the other page:

 * WikiFile action
 * {{file [page="SomeWikkaName"]}}
 * Return an array describing the file which is stored in a page.
 * @input   $tag name of the page; default = current page.
 * @output  Array or (if no file in page) null. Keys:
 *          extension     file extension, e.g. 'png', 'jpg', 'ogg'
 *          content-type  mime content type, e.g. 'image/png'
 *          uploaded      when and who,. e.g. '2007-01-31 ChewBakka'
 *          image         'yes' or 'no'
 *          width         Width in pixels (images only)
 *          height        Height in pixels (images only)
 *          filename      PageName.ext
 *          path          upload_path/PageName.extension
 *          url           'http://..../PageName/file'
function getFile( $tag, $wikka )
   $data = null; // this variable will be returned
   $metafile = $wikka->config['upload_path'].'/'.$tag.'.file';  // metadata
   if (file_exists($metafile) && $contents = file_get_contents($metafile))
	  {
	  $lines = explode( "\n", $contents );
	  // Lines look like "key: value" -> convert into array
	  $data = array(
		 'extension'    => '',
		 'content-type' => '',
		 'uploaded'     => '<unknown>        <unknown>',
		 'image'        => 'false',
		 'width'        => '',
		 'height'       => '',
		 'filename'     => '',
		 'path'         => '',
		 'url'          => ''
	  );
	  foreach ($lines as $line)
	  {
		 $a = explode( ':', trim($line), 2 );
		 if( count($a) == 2 )
		 {
			$data[ $a[0] ] = trim( $a[1] );
		 }
	  }
	  // Convenient attributes which can not be stored permanently
	  $data['filename'] = $tag . '.' . $data['extension'];
	  $data['path'] = $wikka->config['upload_path'] .'/' . $data['filename'];
	  $data['url'] = $wikka->config['base_url'] . $tag .  '/file';
	  // Final check: file must exist.
	  if (! file_exists( $data['path'] ) )
	  {
		 $data = null;
	  }
   }
   return $data;
function formOpen( $wikka, $method = "", $tag = "", $formMethod = "post", $withFile = false )
   $enctype = '';
   if ($withFile) $enctype = ' enctype="multipart/form-data"';
   $result = "<form action=\"".$wikka->Href($method, $tag)."\" method=\"".$formMethod."\"$enctype>\n";
   if (!$wikka->config["rewrite_mode"]) $result .= "<input type=\"hidden\" name=\"wakka\" value=\"".$wikka->MiniHref($method, $tag)."\" />\n";
   return $result;
 * Here the real action starts
// Initialize variables
$output = ''; // The HTML code that is being generated by this action
$uploadform = False; // Show an upload form instead of the file?
$tag = $this->GetPageTag(); // The page that the user requested
if (is_array($vars) && array_key_exists('page', $vars))
   $tag = $vars['page'];
$data = getFile($tag,$this);
// Check whether current user has read access and if there is a file.
if ($this->HasAccess( 'read', $tag ) && $data )
   if ($data['image'] == 'true')
   {
	  // Image file - create an <img> tag
	  $output =  '<a href="'  . $tag . '">'
			  .  '<img src="' . $data['url']    . '"'
			  .  ' width="'   . $data['width']  . '"'
			  .  ' height="'  . $data['height'] . '"'
			  .  ' alt="'     . $tag            . '"'
			  .  ' border="0">'
			  .  '</a>';
   }
   else
   {
	  // Plain file - create a download link
	  $output = '<a href="' . $data['url'] . '">' . $data['url'] . '</a>';
   }
if ($this->HasAccess( 'write', $tag ) && $tag == $this->GetPageTag())
   // If on the same page, also show an upload form
   $headline = 'Attach one file to this article';
   $buttonlabel = 'attach file';
   if( $data )
   {
	  $headline    = 'REPLACE THIS ATTACHMENT WITH A DIFFENT FILE';
	  $buttonlabel = 'REPLACE (THINK TWICE!!!)';
   }
   $miniref = $this->Href('file', $tag);
   $output = $output
		   . '<br />' . $headline . ' <br />'
	  	  . '<form action="' . $miniref . '" method="POST" enctype="multipart/form-data">'
				. (!$this->config["rewrite_mode"] ? '<input type="hidden" name="wakka" value="' . $miniref . '" />' : '')
		   . '<input name="file" type="file" size="72">'
		   . '<input type="submit" value="' . $buttonlabel . '">'
		   . '</form><br />'
		   ;