The jsmallfib Joomla! plugin allows you to include into a normal Joomla! article a simple but fully functional file browser. Files and folders within specified repositories can be browsed and, depending on user- and/or group-based access rights, modified. Optionally, the system can perform logging functions on all activities (uploading, downloading, creating folders, renaming or removing files and folders); the actions log may be viewed by users with specific access rights. In order to achieve this functionality the article must contain a text command in the format:

{jsmallfib [repository]}

where

• jsmallfib
  is the command: it has to be written exactly like this (though it may contain capital letters), and should immediately follow the opening curly bracket (no blank space is allowed here).
  
  
• [repository]
  is an optional parameter indicating the toplevel folder for this file repository (if used it must be included in square brackets). This folder should be located within the path specified in the plugin's parameters (the Default jsmallfib Path parameter on the plugin configuration page). The Default jsmallfib Path may be relative to the Joomla! root folder, or be expressed as an absolute path (useful if the path is outside the web root).
  
  Please notice that only if a relative path is used will jsmallfib attempt to create a non existant repository folder.
  
  From version 1.0.35 jsmallfib supports the ability to define a repository named [USERBOUND], which grants each user access to a special user-dependant area. If the default path (specified in the backend parameters) is jsmallfib_top, for example, by creating an article with the command:
  
  

  {jsmallfib [USERBOUND]}

  then jsmallfib will create a folder named 'Personal area for user ID xx' under jsmallfib_top (where xx is of course the Jomla! user ID of the current user) and each user will only be able to see files and folders under their own area. The default personal area access rights can be specified in the backend, by appropriately setting the Default Personal Access Rights parameter.
  
  From version 1.0.36 jsmallfib supports the ability to define a repository named [GROUPBOUND], which grants each user access to a special area which depends on the Joomla! Contact Category. If the default path (specified in the backend parameters) is jsmallfib_top, for example, by creating an article with the command:

  {jsmallfib [GROUPBOUND]}

  then jsmallfib will create a folder named 'Shared area for group ID xx' under jsmallfib_top (where xx is the Joomla! contact category ID of the current user) and each user will only be able to see files and folders under their own 'group'. The default contact category area access rights can be specified in the backend, by appropriately setting the Default Group Access Rights parameter.

With regard to permissions, default settings are configurable within the plugin's parameters, for both visiting and registered users. To implement access rights for specific users, or for entire Joomla! contact categories, these settings can optionally be overridden by adding appropriate arguments after the repository parameter in the command, using this format:

{jsmallfib [repository] [id1:permission1] ... [idN:permissionN]}

where

[id:permission]
associates a user ID with a specific access right. In particular, permission values, in increasing order of abilities, are:

0 -> no access
1 -> viewing access (may only browse the repository)
2 -> ability to create folders, upload files and rename files and folders
3 -> may delete files, but not folders
4 -> may delete files and empty folders, and view logs
5 -> may additionally view logs

The id parameter is intended as a user ID; you can get these values in the Joomla! User Manager area (notice that using ID 0 refers to all non-registered users). If the user ID is prefixed with G (or g) it is taken as a Joomla! contact category ID (you can get the relevant values in the Joomla! Contact Categories list)

Command usage example:

{jsmallfib [project] [63:2] [65:3] [g6:2] desc(Hello file browsing world!)}

in this case, assuming that the default permission is 0 (no access), users with user ID 63 and 65, as well as all users belonging to contact category ID 6 will be able to see the files starting from folder 'project' (under the default absolute path specified in the plugin parameters). User ID 63 will be able to upload files and create folders, user ID 65 will also have the ability to delete, while all users of contact category ID 6 will have access rights 2 (create folders and upload files).

You may also set a description for the repository, by placing it in the format

desc(this is a description)

within the curly brackets. This will be included below the title and before the files/folders display (in the above example it's the Hello file browsing world! sentence).

As a final note on command syntax, notice that, although the curly brackets and the square ones around the repository are required, the id:permission pairs may have a looser format. Thus, the command above may have been written as:

{jsmallfib [project] 63:2, 65:3 g6:2 desc(Hello file browsing world!)}

With regards to the icons representing file extensions, these can be found in the folder plugins/content/jsmallfib within the main Joomla! installation. Icons are PNG image files named ext.png, where ext is the file extension to represent. Introducing a new file extension is as simple as creating a new icon file with the relevant name.