Loading...
 

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
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
99 Picture 70.png 152.60 KB mrjcleaver
120 Picture 71.png Create a plugin alias 81.39 KB mrjcleaver
121 Picture 72.png Name any parameters 83.59 KB mrjcleaver
122 Picture 74.png Simple invocation, just using one named parameter 32.38 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

List Slides