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 filesIntroduced 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 |
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
galleryIdandcategId, 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
All files in a gallery
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 |
|---|---|---|---|---|---|---|
| 151 | teetree_categ_perms_00.png | 26.30 KB | Xavier de Pedro | |||
| 122 | Picture 74.png | Simple invocation, just using one named parameter | 32.38 KB | mrjcleaver | ||
| 162 | backlinks_example.png | Example page showing backlinks | 42.78 KB | Rick Sapir / Tiki for Smarties | ||
| 123 | Picture 75.png | 75.49 KB | mrjcleaver | |||
| 120 | Picture 71.png | Create a plugin alias | 81.39 KB | mrjcleaver |
All files in a category
This code:
Copy to clipboard
{files categId="13"}
Would produce on this site:
Category: Files example
| ID | Filename | Name | Description | Size | Last modified | Last modified by |
|---|---|---|---|---|---|---|
| No records found. | ||||||
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