Listfiles Action Documentation

This is the documentation page for the Listfiles action.

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
2. 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