====== Dirpictures Plugin ======

---- plugin ----
description: Show subnamespaces with small pictures
author     : Jérôme Abel
email      : jerome_at_reso-nance.org
type       : syntax
lastupdate : 2016-05-31
compatible : Hrun, Detritus
depends    : 
conflicts  : 
similar    : 
tags       : list, thumbnails, images
downloadurl: https://git.framasoft.org/resonance/dirpictures/repository/archive.zip?ref=master
bugtracker : https://git.framasoft.org/resonance/dirpictures/issues
sourcerepo : https://git.framasoft.org/resonance/dirpictures/
donationurl:
screenshot_img : https://git.framasoft.org/resonance/dirpictures/raw/master/screenshot.png
----




===== Description =====
This plugin is used to display pictures for all pages of a directory (aka. all subnamespaces of a namespace) and sort them by name or by date. If a picture is not added into the page (as a metadata) it takes a default picture. 

It is also very small and good to hack and improve.

===== Examples =====

We use it to display projects made in the Fablab LFO.

By date :
http://reso-nance.org/wiki/projets/archives

By name :
http://reso-nance.org/wiki/projets/

===== Installation =====
Search and install the plugin using the [[plugin:extension|Extension Manager]]. 

Alternatively, refer to [[:Plugins]] on how to install plugins manually. The local plugin directory must have the same name as the plugin is named, otherwise the plugin won't work properly.

:!: **Add the default.jpg picture**: In order to find the right default picture, please download the "default.jpg" file into the namespace where you want to show all pages.

===== Syntax =====

    // Sort by name
    ~~DIRPICTURES~~
  
    // Sort by date
    ~~DIRPICTURES sortByDate~~
  
    // Sort by date (descending order)
    ~~DIRPICTURES sortByDate sortDesc~~
   

===== Configuration and Settings =====
Nothing specific

===== Development =====
Some useful arguments could be added : namespace, depth, ...