Wiki source for ListfilesActionInfo
=====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
>>==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
