=====Files Action Documentation =====
This is the documentation of the ##files## action.

File management in Wikka is supported by adding the ##""{{files}}""## action in a page.

===Requirements===
1) A directory for the files has to exist.
1) The entry ##upload_path## in ##[[ConfigurationOptions | wikka.config.php]]]## has to match the path for this directory.
1) The web server has to be able to write to the ##upload_path##.
1) {{since version="1.2" display="inline"}} You can use the ##INTRANET_MODE## option to allow write access for non-admin users. ''Note: This option must be explicitly enabled in ##files/files.php##, and is not currently available in ##wikka.config.php##.''--- {{until version="1.1.6.6" display="inline"}} To upload files **you must be an admin**.
1) To delete files **you must be an admin**.
1) If you're having problems with PHP safe mode try [[http://wikkawiki.org/FilesActionSafeModeWorkaround | this solution]].

===Show or manage attached files===
1) Insert the action ##""{{files}}""## on a page.
1) Look at the list to see the files attached to the current page, their size and the date they have been added.
1) Filenames in the list become download links.

===Upload a file===

1) {{since version="1.2" display="inline"}} Admins can set the ##INTRANET_MODE## option in files/files.php to allow uploads by non-admin users. ''Note: This option must be explicitly set, and is not currently available in ##wikka.config.php##.'' --- {{until version="1.1.6.6" display="inline"}} You must be an admin to upload files!
1) Make sure ##""{{files}}""## is on the page.
1) Click on the #%Browse...#% button to search for a file.
1) Select a file on your computer (you can only select one) .
1) The name should appear in the box right next to //add new attachment//.
1) Click on the "+".
1) If you can see the file in the list, your upload was successful.

==Upload and use images (with mod_rewrite enabled)==
By copying an image link as displayed in the attachment box after uploading a file, you can use this link directly in the //url// parameter of the ##""{{image}}""## action, regardless of whether or not mod_rewrite is in use.

If you choose to use a relative URL as the argument to the //url// parameter (for instance, ##url="uploads/""ImagePage""/myImages.jpg"##), the image will not display. There is a solution for that:
1) Create one page in which you put the file action. On this page, you should only upload images and no other files.
1) Upload an image.
1) Copy ##.htaccess## from the ##/images## directory of wikka into ##uploads/""YourPagename""##.

''Since the files (images) in this directory will be accessible now, i.e. you aren't redirected to Wikka, it is a bad idea to upload anything else than images on this page.''

===Create a download link===
- Insert ##""{{files download="filename" text="descriptive name"}}""## to create a link to download file "filename".
- See also **Show or manage attached files** above.

===Download a file===
- Click on the name of a file to download it.
- See **Show or manage attached files** or **Create a download link** above for creating download links.

===Delete a file===
You must be an admin to do this!
1) Make sure ##""{{files}}""## is on the page.
1) Look for the file you want to delete in the list.
1) Click on the small ##"x"## before the file.

===Examples===

##""{{files}}""##
{{files}}

##""{{files download="freemind_sample1.jpg" text="Freemind sample"}}""##
{{files download="freemind_sample1.jpg" text="Freemind sample"}}

----
CategoryEN