kitDirList - access to /MEDIA directories

[Ralf (Berlin)]

kitDirList replaces DirList and has a couple of new features like:

• provide public or strong protected access to folders within /MEDIA directory
• uses KeepInTouch categories or WebsiteBaker groups for authentication
• can show folders recursive
• support file descriptions
• ...

Please read the README.txt within the kitDirList add-on archive for a brief english description, using parameters, descriptions a.s.o. ...

Many thanks to Armin Ipfelkofer for english translation of EN.php and README.txt!

Requirements:

• WebsiteBaker 2.8.1
• PHP 5.2
• dbConnect_LE installed
• Dwoo installed
• UTF-8 charset is used
• recommend: KeepInTouch

Download kitDirList

Regards
Ralf

[nuke]

This works perfect - Thank you so much! I was looking for something exactly like this!

Just something I noticed with the droplet, I had to use it like this:

e.g. Using a protected directory ("Folder") only accessible to WB groups "Administrators", "otherGroup", and "otherGroup2".

[[kit_dirlist?=&media=kit_protected/Folder&wb_group=Administrators,otherGroup,otherGroup2]]

Note the =& at the start, or else it was not recognizing the first parameter - this was not clear in the ReadMe; which made it sound like it should be "[[kit_dirlist?=media..." (quote from ReadMe [The first parameter you attach to the droplet kit_dirlist starts with an "?". Next character is an "=" followed by the value or values assigned to the parameter. Each additional parameter starts with an "&".] might want to update, and show an example of using the droplet with some parameters to avoid confusion.

Thanks again =)
-Mike

[Ralf (Berlin)]

This works perfect - Thank you so much! I was looking for something exactly like this!

 

Just something I noticed with the droplet, I had to use it like this:

Thank you for your hint - can you please check the readme.txt again and express it in a right way?

Regards
Ralf

[nuke]

Sure thing...

I would change the following text:
--------------
Sequence of parameters is insignificant. The first parameter you attach to the droplet kit_dirlist starts with an "?". Next character is an "=" followed by the value or values assigned to the parameter. Each additional parameter starts with an "&".
--------------

To:
--------------

The order or amount of parameters is insignificant. The first parameter you attach to the droplet kit_dirlist starts with an "?=&" followed by the value or values assigned to the parameter. Each additional parameter starts with an "&".

Example with a single parameter:
Let's say I'd like to sort files in the Media directory in ascending order, the droplet command would be:
[[kit_dirlist?=&sort=asc]]

Another Example with multiple parameters:
I want to protect a directory called "SecretFolder", and make it accessible only to WebsiteBaker Groups "Group1" and "Group2". I would first create this directory under /Media/kit_protected/ with the files to be  protected placed inside /Media/kit_protected/SecretFolder/ExampleFile.pdf
I also want these files to be displayed in ascending order, the command would be:

[[kit_dirlist?=&media=kit_protected/SecretFolder&wb_group=Group1,Group2&sort=asc]]

--------------

Hope that makes sense, and thanks again =)

[Ralf (Berlin)]

Let's say I'd like to sort files in the Media directory in ascending order, the droplet command would be:
[[kit_dirlist?=&sort=asc]]

ok - I see the problem. To explain it: to attach the first parameter you use a ? - for example:

[[kit_dirlist?sort=asc]]

to attach further parameters you use a & - for example:

[[kit_dirlist?media=kit_protected/SecretFolder&wb_group=Group1,Group2&sort=asc]]

the first sequence you used: ?=& works but is not correct. Hope, I have not confused you now!

Regards
Ralf

[nuke]

Ah, I see, in the ReadMe it is a bit confusing:

Sequence of parameters is insignificant. The first parameter you attach to the droplet kit_dirlist starts with an "?". Next character is an "=" followed by the value or values assigned to the parameter. Each additional parameter starts with an "&".

I took that to mean it started as ?=PARAMETER which would not work, but kit_dirlist?=&PARAMETER would work, but, like you said, it is incorrect. Thanks for clearing that up. I've updated my site to the proper syntax.
---
Knowing this now and re-reading it I understand, I'd still suggest an example is shown (like you did above) or modify the text a bit, something like:
---
Sequence of parameters is insignificant. For the first parameter; call the droplet with "kit_dirlist" followed by "?" and then the parameter you wish to use followed by an "=" then the value or values assigned to the parameter. Each additional parameter starts with an "&" and values can be assigned the same way.

e.g.
[[kit_dirlist?Parameter=value&Parameter2=OtherValue]]
---
Hrmm, that sounds a bit awkward as well - oh well, it works, it is easy to use, and thats all that matters, keep up the good work Ralf! You guys are the WB community!

-Mike

[Ralf (Berlin)]

I've just release kitDirList 0.19 with a completed and updated english EN.php and a new NL.php - many thanks to Erik van Iterson for translation!

Since release 0.18 kitDirList also support the upload of files to public and protected directories.

Download: kitDirList 0.19

Regards
Ralf