=====Listfiles Action Documentation=====

>>==See also:==
Development: ListfilesAction.>>This is the documentation page for the Listfiles action.::c::

===The principle===
As many Wikka users, I find the upload process cumbersome. So I propose a new way relying on 3 developments and a few principles.
	1) There will be a menulet action in the header and/or footer menus that will allow the user to:
		- know if there are files attached to the current page (special display of the menulet link)
		- browse the attached files by clicking on the menulet link
		- manage the attachments (add/delete)
	1) If you are allowed to read a page then you can read/download the attached files
	1) If you are allowed to write a page then you can manage the attachments (add/delete)
Of course all this has to be compliant with the site policy (authorized mimes and maximum sizes).

===My solution===
Three developments to provide a complete solution:
	- A handler (FilesHandlerInfo - FilesHandler) allowing to call the file management tool from any page
	- An action (ListfilesActionInfo - ListfilesAction) allowing to list and download the attached documents
	- A menulet action (WikkaMenulets : attachments) to call the handler via a menu

===How to use it?===
This particular action can be called in different ways:
""{{listfiles}}"" displays all the files attached to the current page
""{{listfiles page="AnotherPage"}}"" displays all the files attached to another page (provided that the user is allowed to read it)
""{{listfiles file="MyFile"}}"" displays a link to the file named ""MyFile"" attached to the current page (provided the file exists)
""{{listfiles file="MyFile" title="My title"}}"" same as above with "My title" being the text displayed to the link
""{{listfiles page="AnotherPage" file="MyFile"}}"" display a link to the file named ""MyFile"" attached to ""AnotherPage""
""{{listfiles page="AnotherPage" file="MyFile" title="My title"}}"" same as above with "My title" being the text displayed to the link

===To Do===
Nothing I can think about right now.

----
CategoryDocumentation