Plugin Files

Use this wiki plugin, introduced in Tiki3, to display a list of files like in a file gallery listing. You can also create a link to a slideshow of images in a file gallery.
The files can identified by their:

  • ID
  • gallery
  • category
  • gallery and category

Requirements

Regarding permissions:

  • The file gallery must be visible by the user in order for the file to be listed or displayed
  • A category with a permission on a file has no effect

Parameters

List files by ID, gallery or category, or show a slideshow of image files
Introduced in Tiki 3.
Go to the source code
Preferences required: feature_file_galleries, wikiplugin_files

Parameters Accepted Values Description Default Since
(body of plugin) Title for the file listing, or the link text when slideshow="y"
creator Show only files created by this user 5.0
galleryId
separator: :
To list only files contained in these file galleries (multiple IDs separated by colon).
Or enter a username for user files (hint: enter for current logged-in user).
3.0
max int Number of rows (default: -1 = all) -1 7.1
recursive (blank)
y
n
Recursive y 8.0
showcreator (blank)
y
n
Show the username of the user who is the creator of the file (not shown by default) n 3.0
showdescription (blank)
y
n
Show the description of the file given upon upload into the file gallery (shown by default except in slide show). Set to Yes (y) to show as a caption in a slide show. y 3.0
showfilename (blank)
y
n
Show each file's filename (shown by default except in slide show). Set to Yes (y) to show as a caption in a slide show. y 3.0
showid (blank)
y
n
Show the ID number of each file (shown by default) y 3.0
showicon (blank)
y
n
Show the file-type icon for each file n 3.0
showlasteditor (blank)
y
n
Show the username of the user who last modified the file (shown by default) y 5.0
showmodified (blank)
y
n
Show the date each file was last modified (shown by default) y 3.0
showmodtimedate (blank)
y
n
if showmodified is set to y then this will show both the date and time that each file was last modified (not shown by default) n 16.0
showname (blank)
y
n
Show the name given to the file upon upload into the file gallery (shown by default). Set to Yes (y) to show as a caption in a slide show. y 3.0
showgallery (blank)
y
n
Show the name of the parent gallery n 3.0
showsize (blank)
y
n
Show the size of each file in kilobytes (shown by default except in slide show) y 3.0
showtitle (blank)
y
n
Show the title of the file gallery (shown by default). Also shown on slide show pop up window if a single galleryId is used. y 5.0
showthumb (blank)
y
n
Show Image thumb n 8.0
sort (blank)| name_asc| name_desc| created_asc| created_desc| lastModif_asc| lastModif_desc| filename_asc| filename_desc| filesize_asc| filesize_desc| filetype_asc| filetype_desc| lastDownload_asc| lastDownload_desc| random Order ascending (_asc), descending (_desc) or random based on any field in the file gallery table. Default is name_asc name_asc 3.0
showaction (blank)
y
n
Show a column with icons for the various actions the user can take with each file (shown by default) n 3.0
showcomment (blank)
y
n
Show comments for each file (not shown by default) n 5.0
showcreated (blank)
y
n
Show the date each file was created (not shown by default) n 3.0
showfiles (blank)
y
n
For galleries included in the list (where the file gallery includes other galleries), show the number of files in each of those galleries (not shown by default) n 3.0
showfind (blank)
y
n
Show a search box above the list (not shown by default) n 3.0
showfindisrecursive (blank)
y
n
The search box digs recursively in sub-galleries (by default) y
showhits (blank)
y
n
Show the number of hits each file has received (not shown by default) n 3.0
showlockedby (blank)
y
n
For locked files, show the username of the user who locked it (not shown by default) n 3.0
slideshow (blank)
y
n
Show a link that produces a popup slideshow when clicked (not set by default) n 3.0
showsource (blank)
y
n
Show the source (shown by default). n 10.0
showupload (blank)
y
n
Show a simple form to upload files to the gallery (not shown by default) n 6.0
showauthor (blank)
y
n
Show the username of the user who is the author of the file (not shown by default) n 3.0
slideheight digits Set height of slideshow popup. 500 9.0
slidewidth digits Set width of slideshow popup. 600 9.0
withsubgals (blank)
y
n
With subgalleries y 8.0
categId To restrict files listed to those belonging to one or more categories. Enter a single category or ID or list of them separated by colon 3.0
fileId
separator: :
To list only specified files, enter their file IDs separated by colon. If File IDs are specified here then the Gallery ID field above should be empty. 5.0

 Additional notes
  • If you give only categId, all the files that are in a gallery with this category and all the files of this category (after Tiki version 2) will be returned.
  • If you give only galleryId, all the files of this gallery will be returned
  • If you give galleryId and categId, all the files of the gallery that have this category will be returned
  • The fields that are displayed are those specified in one of the galleries
  • If you specify title, you will see this text as title instead of the category name or the gallery name as title

Examples

This code:

Copy to clipboard
{files galleryId="4" max="5"}

Would produce on this site:

File Gallery: Documentation temporarily in PDF

ID Filename Name Description Size Last modified Last modified by
136 WikiAdminFeatures_30.png 189.90 KB Rick Sapir / Tiki for Smarties
284 Tiki Shadow Layers How To.pdf Tiki Shadow Layers How To PDF document describing basics of Tiki's shadow layers feature. 1.51 MB Ed
151 teetree_categ_perms_00.png 26.30 KB Xavier de Pedro
539 Reference Guide.pdf Tiki Reference Guide ALPHA - From TikiFest Tiki6LTS Doc Sprint 5.01 MB Rick Sapir / Tiki for Smarties
123 Picture 75.png 75.49 KB mrjcleaver

All files in a category

This code:

Copy to clipboard
{files categId="13"}

Would produce on this site:

Category: Files example

Select files

This code:

Copy to clipboard
{files fileId="60:61:62" showgallery="n"}

Would produce on this site:

Slideshow

This code:

Copy to clipboard
{FILES(galleryId="6" slideshow="y")}Slideshow for file gallery 6{FILES}

Would produce on this site:
Slideshow for file gallery 6