https://github.com/alexwenzel/dokuwiki-plugin-directorylist
Specify a directory and this plugin will list all contained items and made them downloadable.
https://github.com/alexwenzel/dokuwiki-plugin-directorylist
Last synced: about 1 month ago
JSON representation
Specify a directory and this plugin will list all contained items and made them downloadable.
- Host: GitHub
- URL: https://github.com/alexwenzel/dokuwiki-plugin-directorylist
- Owner: alexwenzel
- Created: 2014-01-21T19:20:07.000Z (over 11 years ago)
- Default Branch: development
- Last Pushed: 2017-10-03T14:52:57.000Z (over 7 years ago)
- Last Synced: 2025-04-05T22:11:31.197Z (2 months ago)
- Language: PHP
- Size: 185 KB
- Stars: 3
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Directory listing for Dokuwiki
Specify a directory and this plugin will list all contained items and made them downloadable.
This is mostly used for intranets.
**Information #1:** This is still under development and not finished or secured.
**Information #2:** Please be aware, that a wiki user can pick ANY directory on your maschine. I am not responsible for any problems.
## Donations
Please consider a donation, if you use my plugin for your business.
[Donation with PayPal](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=YP4LDRJFB9F94)
## Example
## Requirements
* PHP >= 5.3
* PHP fileinfo extension
## Usage
````
````
### Path argument
The path argument specifies the path which the directorylist plugin will list.
This can be an unix or windows path. It can be absolute or relative.
**Examples:**
````
````
### Ingore argument
You can ignore directories or files with the ignore argument.
The ignore argument has to be a comma separated [shell pattern](http://www.php.net/manual/en/function.fnmatch.php).
This argument is optional, the value is empty.
**Example:**
````
````
### Recursive argument
You can specify if you want to list your directory recursive or not.
This argument is optional, the default value is: ``true``.
**Examples:**
````
````
````
````
### Fileorder argument
You can specify the order of files inside a directory.
This argument is optional, the default value is: ``asc``.
**Examples:**
````
````
### Type argument
Adding a new 'type' option to the directorylist syntax to enable different types of href link.
This allows 'direct' links using the file:// protocal.
(NOTE: this will usually not be a good choice since most browsers, eg. Chrome, forbid the openning of file:// links from non-local pages)
Also allows 'link' links that, using the absolute path and dokuwiki basedir, serve weblinks to content.
(NOTE: assumes the data directory is reachable by your webserver. This is a big security issue!)
Default option is 'download';
**Examples:**
````
````
## NOCACHE
When the directory listing is not updating as you like, try to use the ``~~NOCACHE~~`` tag.
https://www.dokuwiki.org/caching
## Styling
You can style this plugin with the following elements:
* ``ul.directorylist``
* ``ul.directorylist li.file``
* ``ul.directorylist li.folder``
## Information
Author: Alexander Wenzel ([email protected])
Plugin page: http://www.dokuwiki.org/plugin:directorylist
Icons: [genericons.com](http://genericons.com)
## Changelog
* 0.2.2
* updated readme
* fixed sorting bug
* fixed problems with chinese characters
* 0.2.1
* PHP7 compatibility
* changed default 'type' to 'download'
* 0.2.0
* added 'type' argument