====== filelisting Plugin ======

---- plugin ----
description: Show a searchable and sortable list of media files in the current namespace and subnamespaces. With dropfiles plugin allows Drag'n'Drop upload of media files.
author     : Szymon Olewniczak
email      : dokuwiki@cosmocode.de 
type       : syntax
lastupdate : 2023-09-27
compatible : Hogfather, Greebo, Frusterick Manners
depends    : 
conflicts  : 
similar    : filelist, medialist
tags       : file, listing, download, media, filter

downloadurl: https://github.com/cosmocode/dokuwiki-plugin-filelisting/zipball/master
bugtracker : https://github.com/cosmocode/dokuwiki-plugin-filelisting/issues
sourcerepo : https://github.com/cosmocode/dokuwiki-plugin-filelisting/
donationurl: 

screenshot_img : 
----

===== Installation =====

This plugin has synergies with the following plugins:
  * [[plugin:dropfiles]]

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples/Usage =====
Show files in current namespace:
  {{filelisting}}
 
Show files in custom namespace:
  {{filelisting>custom:namespace}}

===== Syntax =====
  {{filelisting>namespace}}

''>namespace'' is optional.
  
===== Configuration and Settings =====

  * **''defaulttoggle''**: defines whether on a newly opened page the table is expanded or not. Once the table has been toggled, that state is remembered by the browser

===== Development =====

See ''\helper_plugin_filelisting::tpl_filelisting()'' if you want to integrate this plugin into your template.

=== Change Log ===

{{rss>https://github.com/cosmocode/dokuwiki-plugin-filelisting/commits/master.atom date}}

===== Discussion =====

==== Filter doesn't work ====

Unfortunately, filtering with this plugin (version 2019-07-09) doesn't work with my DokuWiki "Greebo". I can click on "Name"/"Size"/"Date" and it becomes marked with an arrow up/down but nothing changes in the actual file list. Also, the "Filter" field seems to have no effect since nothing changes in the list when a term is entered. All files are completely shown, though. Is it a bug with filtering?  --- [[user>justme636|justme636]] //2019-10-19 16:31//
>  Filtering works for me in hogfather  --- [[user>KaiMartin|kaimartin]] //2024-03-04 20:50//
==== Thank you ====

I use this plugin to load images easily. To do this I have a namespace with a series of pages that each refer to a media namespace and this allows me to drag and drop (using dropfiles plugin) making life very simple especially as it offers name and overwite capability. Thank You Simon

To be even more perfect...


=== Listing Media Files ===

How can I list all the files and namespaces in the media directory: using {{filelisting>:}} give me all the folder in the root of Data and in Data: Media I think. I tried specifying Data:Media but that doesn't work. Any ideas?

=== Making the Listing Frame Larger ===

I want to enlarge the listing 'frame' so that I don't have to scroll so much with longer lists. Does anyone know if this is possible.... I don' think there is a parmeter, can I do it using CSS?

[[user>lizat|Liz T]] //2020-11-20//

=== Sorting Files ===

Files are displayed unsorted by default. How to setup a default sorting?